sp_syscollector_set_warehouse_instance_name (Transact-SQL)
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