sp_syscollector_update_collector_type (Transact-SQL)

为收集项更新收集器类型。 给定收集器类型的名称和 GUID,更新收集器类型配置,包括收集和上载包、参数架构以及参数格式化程序架构。

适用范围:SQL Server(SQL Server 2008 到当前版本)。

主题链接图标 Transact-SQL 语法约定

语法

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

请参阅

参考

系统存储过程 (Transact-SQL)

概念

数据收集