sp_syscollector_update_collector_type (Transact-SQL)

Artigo
12/22/2023

Se aplica a:SQL Server

Actualiza un tipo de recopilador para un elemento de recopilación. Dado el nombre y GUID de un tipo de recopilador, actualiza la configuración del tipo de recopilador, incluida la colección y el paquete de carga, el esquema de parámetros y el esquema del formateador de parámetros.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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'
[ ; ]

Argumentos

[ @collector_type_uid = ] 'collector_type_uid'

El GUID para el tipo de recopilador. @collector_type_uid es uniqueidentifier y, si es NULL, @collector_type_uid se crea y devuelve automáticamente como OUTPUT.

[ @name = ] N'name'

Nombre del tipo de recopilador. @name es sysname y debe especificarse.

[ @parameter_schema = ] N'parameter_schema'

Esquema XML para este tipo de recopilador. @parameter_schema es xml, con un valor predeterminado de NULLy puede ser necesario para determinados tipos de recopilador. Si no es necesario, este argumento puede ser NULL.

[ @parameter_formatter = ] N'parameter_formatter'

Plantilla que se va a usar para transformar el XML para su uso en la página de propiedades del conjunto de recopilación. @parameter_formatter es xml, con un valor predeterminado de NULL.

[ @collection_package_id = ] 'collection_package_id'

Identificador único local que apunta al paquete de recopilación de SSIS usado por el conjunto de recopilación. @collection_package_id es uniqueidentifier, sin valor predeterminado y es necesario. Para obtener el valor de @collection_package_id, consulte la vista del sistema dbo.syscollector_collector_types en la msdb base de datos.

[ @upload_package_id = ] 'upload_package_id'

Identificador único local que apunta al paquete de carga de SSIS usado por el conjunto de recopilación. @upload_package_id es uniqueidentifier, sin valor predeterminado y es necesario. Para obtener el valor de @upload_package_id, consulte la vista del sistema dbo.syscollector_collector_types en la msdb base de datos.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Permisos

Requiere la pertenencia al rol fijo de base de datos dc_admin (con permiso EXECUTE).

Ejemplos

Este ejemplo actualiza el tipo de recopilador Consultas T-SQL genérico. (En el ejemplo se usa el esquema predeterminado para el tipo de recopilador Consultas T-SQL genérico).

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

Share via