Compartir a través de

  • Artículo

sp_syscollector_create_collector_type (Transact-SQL)

Crea un tipo de recopilador para el recopilador de datos. Un tipo de recopilador es un contenedor lógico alrededor de paquetes de SSIS que proporciona el mecanismo real para recopilar los datos y cargarlos en el almacén de administración de datos.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

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'

Argumentos

  • [ @collector\_type\_uid = ] 'collector_type_uid'
    Es el GUID para el tipo de recopilador. collector_type_uid es de tipo uniqueidentifier y si es NULL, se creará automáticamente y se devolverá como OUTPUT.

  • [ @name = ] 'name'
    Es el nombre del tipo de recopilador. name es de tipo sysname y debe especificarse.

  • [ @parameter\_schema = ] 'parameter_schema'
    Es el esquema XML para este tipo de recopilador. parameter_schema es xml y su valor predeterminado es NULL.

  • [ @parameter\_formatter = ] 'parameter_formatter'
    Es la plantilla que debe usarse para transformar el XML a fin de usarlo en la página de propiedades del conjunto de recopilación. parameter_formatter es de tipo xml y su valor predeterminado es NULL.

  • [@collection_package_id = ] collection_package_id
    Es un identificador local único que apunta al paquete de recopilaciones de SSIS usado por el conjunto de recopilaciones. collection_package_id es de tipo uniqueidentifer y es obligatorio.

  • [@upload_package_id = ] upload_package_id
    Es un identificador local único que apunta al paquete de carga de SSIS usado por el conjunto de recopilación. upload_package_id es de tipo uniqueidentifier y es obligatorio.

Valores de código de retorno

0 (correcto) o 1 (error)

Permisos

Debe pertenecer a la función de base de datos fija dc_admin (con permiso EXECUTE) para ejecutar este procedimiento.

Ejemplo

Así se crea el tipo de recopilador de consultas T-SQL genérico.

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

Historial de cambios

Contenido actualizado

Se indica que el argumento @collector_type_uid es opcional.

Se ha agregado el argumento @parameter_formatter.

Se ha actualizado el código de la sección "Ejemplo".