sp_syscollector_update_collector_type (Transact-SQL)
更新收集項的收集器型別。指定收集器型別的名稱和 GUID 之後,就會更新收集器型別組態,包括收集和上傳封裝、參數結構描述,以及參數格式器結構描述。
語法
sp_syscollector_update_collector_type [ @collector_type_uid = ] 'collector_type_uid' OUTPUT
, [ @name = ] 'name'
, [ @parameter_schema = ] 'parameter_schema'
, [ @collection_package_id = ] collection_package_id
, [ @upload_package_id = ] upload_package_id
引數
[ @collector_type_uid = ] 'collector_type_uid'
這是收集器型別的 GUID。collector_type_uid 是 uniqueidentifier,而且如果它是 NULL,系統就會自動建立它並當做 OUTPUT 傳回。[ @name = ] 'name'
這是收集器類型的名稱。name 是 sysname,而且必須加以指定。[ @parameter_schema = ] 'parameter_schema'
這是此收集器類型的 XML 結構描述。parameter_schema 是 xml,而且特定收集器類型可能需要此項目。如果它不是必要項目,這個引數就可能是 NULL。[ @collection_package_id = ] collection_package_id
這是指向收集組所使用之 SSIS 收集封裝的本機唯一識別碼。collection_package_id 是 uniqueidentifer,而且是必要項目。若要取得 collection_package_id 的值,請查詢 msdb 資料庫中的 dbo.syscollector_collector_types 系統檢視表。[ @upload_package_id = ] upload_package_id
這是指向收集組所使用之 SSIS 上傳封裝的本機唯一識別碼。upload_package_id 是 uniqueidentifier,而且是必要項目。若要取得 upload_package_id 的值,請查詢 msdb 資料庫中的 dbo.syscollector_collector_types 系統檢視表。
傳回碼值
0 (成功) 或 1 (失敗)
權限
需要 dc_admin (具有 EXECUTE 權限) 固定資料庫角色中的成員資格。
範例
此範例會更新一般 T-SQL 查詢收集器型別 (在此範例中,將會使用一般 T-SQL 查詢收集器型別的預設結構描述)。
USE msdb;
GO
EXEC sp_syscollector_update_collector_type
@collector_type_uid = '302E93D1-3424-4BE7-AA8E-84813ECF2419',
@name = 'Generic T-SQL Query Collector Type',
@parameter_schema = '<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="DataCollectorType">
<xs:element name="TSQLQueryCollector">
<xs:complexType>
<xs:sequence>
<xs:element name="Query" minOccurs="1" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="Value" type="xs:string" />
<xs:element name="OutputTable" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Databases" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:sequence>
<xs:element name="Database" minOccurs="0" maxOccurs="unbounded" type="xs:string" />
</xs:sequence>
<xs:attribute name="UseSystemDatabases" type="xs:boolean" use="optional" />
<xs:attribute name="UseUserDatabases" type="xs:boolean" use="optional" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>',
@collection_package_id = '292B1476-0F46-4490-A9B7-6DB724DE3C0B',
@upload_package_id = '6EB73801-39CF-489C-B682-497350C939F0'
GO