sp_syscollector_update_collector_type (Transact-SQL)

  • Articolo

Si applica a:SQL Server

Aggiorna un tipo agente di raccolta per un elemento della raccolta. Dopo che sono stati specificati il nome e il valore GUID di un tipo agente di raccolta, aggiorna la configurazione del tipo agente di raccolta, includendo il pacchetto di raccolta e di caricamento, lo schema dei parametri e lo schema del formattatore dei parametri.

Convenzioni di sintassi Transact-SQL

Sintassi

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'
[ ; ]

Argomenti

[ @collector_type_uid = ] 'collector_type_uid'

GUID per il tipo agente di raccolta. @collector_type_uid è uniqueidentifier e, se è NULL, @collector_type_uid viene creato e restituito automaticamente come OUTPUT.

[ @name = ] N'name'

Nome del tipo dell'agente di raccolta. @name è sysname e deve essere specificato.

[ @parameter_schema = ] N'parameter_schema'

XML Schema per questo tipo di agente di raccolta. @parameter_schema è xml, con un valore predefinito , NULLe può essere richiesto da determinati tipi di agente di raccolta. Se non è obbligatorio, questo argomento può essere NULL.

[ @parameter_formatter = ] N'parameter_formatter'

Modello da utilizzare per trasformare il codice XML da utilizzare nella pagina delle proprietà del set di raccolta. @parameter_formatter è xml, con il valore predefinito NULL.

[ @collection_package_id = ] 'collection_package_id'

Identificatore univoco locale che punta al pacchetto di raccolta SSIS utilizzato dal set di raccolta. @collection_package_id è uniqueidentifier, senza impostazione predefinita ed è obbligatorio. Per ottenere il valore per @collection_package_id, eseguire una query sulla vista di sistema dbo.syscollector_collector_types nel msdb database.

[ @upload_package_id = ] 'upload_package_id'

Identificatore univoco locale che punta al pacchetto di caricamento SSIS usato dal set di raccolta. @upload_package_id è uniqueidentifier, senza impostazione predefinita ed è obbligatorio. Per ottenere il valore per @upload_package_id, eseguire una query sulla vista di sistema dbo.syscollector_collector_types nel msdb database.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Autorizzazioni

Richiede l'appartenenza al ruolo predefinito del database dc_admin (con autorizzazione EXECUTE).

Esempi

In questo esempio viene aggiornato il tipo agente di raccolta query T-SQL generico. Nell'esempio viene utilizzato lo schema predefinito per il tipo agente di raccolta query T-SQL generico.

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

Contenuto correlato