sp_syscollector_set_warehouse_instance_name (Transact-SQL)

Specifies the instance name for the connection string used to connect to the management data warehouse.

Topic link iconTransact-SQL Syntax Conventions

Syntax

sp_syscollector_set_warehouse_instance_name [ @instance_name = ] 'instance_name'

Arguments

  • [ @instance\_name = ] 'instance_name'
    Is the instance name. instance_name is sysname and defaults to the local instance if NULL.

    Note

    instance_name must be the fully qualified instance name, which consists of the computer name and the instance name in the form computerName\instanceName.

Return Code Values

0 (success) or 1 (failure)

Remarks

You must disable the data collector before changing this data collector-wide configuration. This procedure fails if the data collector is enabled.

To view the current instance name, query the syscollector_config_store system view.

Permissions

Requires membership in the dc_admin (with EXECUTE permission) fixed database role to execute this procedure.

Examples

The following example illustrates how to configure the data collector to use a management data warehouse instance on a remote server. In this example the remote server is named RemoteSERVER and the database is installed on the default instance.

USE msdb;
GO
EXEC sp_syscollector_set_warehouse_instance_name N'RemoteSERVER' -- the default instance is assumed on the remote server
GO