sp_syscollector_create_collector_type (Transact-SQL)

Crée un type de collecteur pour le collecteur de données. Un type de collecteur est un wrapper logique autour des packages SSIS qui fournissent le mécanisme permettant de collecter les données et de les télécharger dans l'entrepôt de données de gestion.

Conventions de syntaxe Transact-SQL

Syntaxe

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'

Arguments

• [ @collector\_type\_uid = ] 'collector_type_uid'
  GUID pour le type de collecteur. collector_type_uid est de type uniqueidentifier et, s'il a la valeur NULL, il sera automatiquement créé et retourné comme paramètre OUTPUT.

• [ @name = ] 'name'
  Nom du type de collecteur. name est de type sysname et doit être spécifié.

• [ @parameter\_schema = ] 'parameter_schema'
  Schéma XML pour ce type de collecteur. parameter_schema est de type xml avec NULL comme valeur par défaut.

• [ @parameter\_formatter = ] 'parameter_formatter'
  Modèle à utiliser pour transformer le XML utilisé dans la page de propriétés du jeu d'éléments de collecte. parameter_formatter est de type xml avec NULL comme valeur par défaut.

• [@collection_package_id = ] collection_package_id
  Identificateur unique local qui pointe vers le package de collection SSIS utilisé par le jeu d'éléments de collecte. collection_package_id est de type uniqueidentifer et est requis.

• [@upload_package_id = ] upload_package_id
  Identificateur unique local qui pointe vers le package de téléchargement SSIS utilisé par le jeu d'éléments de collection. upload_package_id est de type uniqueidentifier et est requis.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Autorisations

L'appartenance au rôle de base de données fixe dc_admin (avec autorisation EXECUTE) est requise pour exécuter cette procédure.

Exemple

Cela crée le type de collecteur Requête T-SQL générique.

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

Historique des modifications

Mise à jour du contenu
Indication que l'argument @collector_type_uid est facultatif.
Ajout de l'argument @parameter_formatter.
Mise à jour du code dans la section « Exemple ».

Voir aussi

Référence

Procédures stockées système (Transact-SQL)

Autres ressources

Collecte de données