sp_syscollector_create_collector_type (Transact-SQL)

建立資料收集器的收集器型別。 收集器型別是包裝 SSIS 封裝的邏輯包裝函數，可提供實際機制來收集資料，並將資料上傳到管理資料倉儲。

Transact-SQL 語法慣例

語法

sp_syscollector_create_collector_type 
    [ [@collector_type_uid = ] 'collector_type_uid' OUTPUT ]
    , [ @name = ] 'name'
    , [ [ @parameter_schema = ] 'parameter_schema' ]
    , [ [ @parameter_formatter = ] '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，系統就會自動建立它，並當做 OUTPUT 傳回。

• [ @name = ] 'name'
  這是收集器類型的名稱。 name 是 sysname，而且必須加以指定。

• [ @parameter\_schema = ] 'parameter_schema'
  這是此收集器類型的 XML 結構描述。 parameter_schema 是 xml，預設值是 NULL。

• [ @parameter\_formatter = ] 'parameter_formatter'
  這是用來轉換 XML，以用於收集組屬性頁中的範本。 parameter_formatter 是 xml，預設值是 NULL。

• [@collection_package_id = ] collection_package_id
  這是指向收集組所使用之 SSIS 收集封裝的本機唯一識別碼。 collection_package_id 是 uniqueidentifer，而且為必要項目。

• [@upload_package_id = ] upload_package_id
  這是指向收集組所使用之 SSIS 上傳封裝的本機唯一識別碼。 upload_package_id 是 uniqueidentifier，而且為必要項目。

傳回碼值

0 (成功) 或 1 (失敗)

權限

需要 dc_admin (具有 EXECUTE 權限) 固定資料庫角色中的成員資格，才能執行此程序。

範例

這會建立一般 T-SQL 查詢收集器型別。

EXEC sp_syscollector_create_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

請參閱

參考

系統預存程序 (Transact-SQL)

概念

資料收集

變更記錄

更新的內容
表示 @collector_type_uid 引數是選擇性的。
已加入 @parameter_formatter 引數。
已更新「範例」一節中的程式碼。