sp_syscollector_update_collector_type (Transact-SQL)
S’applique à : SQL Server
Met à jour un type de collecteur pour un élément de collecte. Le nom et le GUID d'un type de collecteur étant fournis, met à jour la configuration du type de collecteur, y compris le package de collection et de téléchargement, le schéma de paramètres et le schéma du formateur de paramètres.
Conventions de la syntaxe Transact-SQL
Syntaxe
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'
[ ; ]
Arguments
[ @collector_type_uid = ] 'collector_type_uid'
GUID pour le type de collecteur. @collector_type_uid est uniqueidentifier et, si c’est NULL
le cas, @collector_type_uid est automatiquement créé et retourné en tant que OUTPUT.
[ @name = ] N’name'
Nom du type de collecteur. @name est sysname et doit être spécifié.
[ @parameter_schema = ] N’parameter_schema'
Schéma XML pour ce type de collecteur. @parameter_schema est xml, avec une valeur par défaut NULL
et peut être requise par certains types collecteurs. Si ce n’est pas obligatoire, cet argument peut être NULL
.
[ @parameter_formatter = ] N’parameter_formatter'
Modèle à utiliser pour transformer le code XML à utiliser dans la page de propriétés du jeu de collections. @parameter_formatter est xml, avec la valeur par défaut NULL
.
[ @collection_package_id = ] 'collection_package_id'
Identificateur unique local qui pointe vers le package de collection SSIS utilisé par le jeu de collections. @collection_package_id est uniqueidentifier, sans valeur par défaut, et est obligatoire. Pour obtenir la valeur de @collection_package_id, interrogez la vue système dbo.syscollector_collector_types dans la msdb
base de données.
[ @upload_package_id = ] 'upload_package_id'
Identificateur unique local qui pointe vers le package de chargement SSIS utilisé par le jeu de collections. @upload_package_id est uniqueidentifier, sans valeur par défaut, et est obligatoire. Pour obtenir la valeur de @upload_package_id, interrogez la vue système dbo.syscollector_collector_types dans la msdb
base de données.
Valeurs des codes de retour
0
(réussite) ou 1
(échec).
autorisations
Nécessite l’appartenance au rôle de base de données fixe dc_admin (avec l’autorisation EXECUTE).
Exemples
Cet exemple met à jour le type de collecteur Requête T-SQL générique. (Dans l'exemple, le schéma par défaut du type de collecteur Requête T-SQL générique est utilisé.)
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