Share via

sp_syscollector_update_collector_type (Transact-SQL)

  • 發行項

適用於：SQL Server

更新收集項的收集器類型。 指定收集器類型的名稱和 GUID，更新收集器類型組態，包括集合和上傳套件、參數架構和參數格式器架構。

Transact-SQL 語法慣例

語法

sp_syscollector_update_collector_type
    [ [ @collector_type_uid = ] 'collector_type_uid' ]
    [ , [ @name = ] N'name' ]
    [ , [ @parameter_schema = ] N'parameter_schema' ]
    [ , [ @parameter_formatter = ] N'parameter_formatter' ]
    , [ @collection_package_id = ] 'collection_package_id'
    , [ @upload_package_id = ] 'upload_package_id'
[ ; ]

引數

[ @collector_type_uid = ] 'collector_type_uid'

收集器類型的 GUID。 @collector_type_uid是 uniqueidentifier，如果是 NULL，則會自動建立@collector_type_uid並傳回為 OUTPUT。

[ @name = ] N'name'

收集器類型的名稱。 @name為 sysname，且必須指定。

[ @parameter_schema = ] N'parameter_schema'

這個收集器類型的 XML 架構。 @parameter_schema是 xml，預設值NULL為 ，而且某些收集器類型可能需要 。 如果不需要，這個自變數可以是 NULL。

[ @parameter_formatter = ] N'parameter_formatter'

要用來轉換 XML 的範本，以用於集合集屬性頁。 @parameter_formatter為 xml，預設值為 NULL。

[ @collection_package_id = ] 'collection_package_id'

指向收集組所使用之 SSIS 集合套件的本機唯一標識碼。 @collection_package_id為 uniqueidentifier，不含預設值，而且為必要專案。 若要取得@collection_package_id的值，請在資料庫中查詢dbo.syscollector_collector_types系統檢視msdb。

[ @upload_package_id = ] 'upload_package_id'

指向收集組所使用之 SSIS 上傳套件的本機唯一標識碼。 @upload_package_id是 uniqueidentifier，沒有預設值，而且是必要的。 若要取得@upload_package_id的值，請在資料庫中查詢dbo.syscollector_collector_types系統檢視msdb。

傳回碼值

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

相關內容