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 (失敗)
権限
(EXECUTE 権限を持つ) dc_admin 固定データベース ロールのメンバシップが必要です。
使用例
次の例では、ジェネリック T-SQL Query コレクタ型を更新します (この例では、ジェネリック T-SQL Query コレクタ型の既定のスキーマを使用しています)。
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