Edit

sp_syscollector_set_warehouse_instance_name (Transact-SQL)

  • Article

Applies to: SQL Server

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

Transact-SQL syntax conventions

Syntax

sp_syscollector_set_warehouse_instance_name [ [ @instance_name = ] N'instance_name' ]
[ ; ]

Arguments

[ @instance_name = ] N'instance_name'

The instance name. @instance_name is sysname, and defaults to the local instance if NULL.

@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

Related content