Condividi tramite


sp_syscollector_create_collector_type (Transact-SQL)

Crea un tipo di agente di raccolta per l'agente di raccolta dati. Un tipo di agente di raccolta è un wrapper logico intorno ai pacchetti SSIS che fornisce il meccanismo effettivo per raccogliere dati e caricarli nel data warehouse di gestione.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

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'

Argomenti

  • [ @collector\_type\_uid = ] 'collector_type_uid'
    GUID del tipo di agente di raccolta. collector_type_uid è di tipo uniqueidentifier e se è NULL viene creato automaticamente e restituito come OUTPUT.

  • [ @name = ] 'name'
    Nome del tipo di agente di raccolta. name è di tipo sysname e deve essere specificato.

  • [ @parameter\_schema = ] 'parameter_schema'
    XML Schema per questo tipo di agente di raccolta. parameter_schema è di tipo xml e il valore predefinito è NULL.

  • [ @parameter\_formatter = ] 'parameter_formatter'
    Modello da utilizzare per trasformare l'XML per l'utilizzo nella pagina delle proprietà del set di raccolta. parameter_formatter è di tipo xml e il valore predefinito è NULL.

  • [@collection_package_id = ] collection_package_id
    È un identificatore univoco locale che punta al pacchetto di raccolta SSIS utilizzato dal set di raccolta. collection_package_id è di tipo uniqueidentifer ed è obbligatorio.

  • [@upload_package_id = ] upload_package_id
    Identificatore univoco locale che punta al pacchetto di caricamento di SSIS utilizzato dal set di raccolta. upload_package_id è di tipo uniqueidentifier ed è obbligatorio.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Autorizzazioni

Per eseguire questa procedura, è richiesta l'appartenenza al ruolo predefinito del database dc_admin (con autorizzazione EXECUTE).

Esempio

Viene creato il tipo di agente di raccolta query T-SQL generico.

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

Vedere anche

Riferimento

Stored procedure di sistema (Transact-SQL)

Concetti

Raccolta dati

Cronologia modifiche

Contenuto aggiornato

Indicazione che l'argomento @collector_type_uid è facoltativo.

Aggiunta dell'argomento @parameter_formatter.

Aggiornamento del codice nella sezione "Esempio".