通过

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 参数。

更新了“示例”部分的代码。