sp_syscollector_create_collector_type (Transact-SQL)

Aplica-se a:SQL Server

Cria um tipo de coletor para o coletor de dados. Um tipo de coletor é um wrapper lógico em torno dos pacotes SSIS que fornecem o mecanismo real para coletar dados e carregá-los no data warehouse de gerenciamento.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_syscollector_create_collector_type
    [ [ @collector_type_uid = ] 'collector_type_uid' OUTPUT ]
    , [ @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 [ = ] SAÍDA 'collector_type_uid'

O GUID do tipo de coletor. @collector_type_uid é um parâmetro OUTPUT do tipo uniqueidentifier. Se @collector_type_uid for NULL , ele será automaticamente criado e retornado como SAÍDA.

@name [ = ] N'nome'

O nome do tipo de coletor. @name é sysname e deve ser especificado.

@parameter_schema [ = ] N'parameter_schema'

O esquema XML para esse tipo de coletor. @parameter_schema é xml, com um padrão de NULL.

@parameter_formatter [ = ] N'parameter_formatter'

O modelo a ser usado para transformar o XML para uso na página de propriedades do conjunto de coleções. @parameter_formatter é xml, com um padrão de NULL.

@collection_package_id [ = ] 'collection_package_id'

Um identificador exclusivo local que aponta para o pacote de coleção SSIS usado pelo conjunto de coleta. @collection_package_id é uniqueidentifier e é obrigatório.

@upload_package_id [ = ] 'upload_package_id'

Um identificador exclusivo local que aponta para o pacote de carregamento do SSIS usado pelo conjunto de coleta. @upload_package_id é uniqueidentifier e é obrigatório.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Permissões

Requer associação à função de banco de dados fixa dc_admin (com permissão EXECUTE) para executar este procedimento.

Exemplos

Este exemplo cria o tipo de coletor Generic T-SQL Query.

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