sp_syscollector_update_collector_type (Transact-SQL)

Atualiza um tipo de coletor para um item de coleta. Dado o nome e a GUID de um tipo de coletor, atualiza a configuração do tipo de coletor, inclusive a coleção e o pacote de carregamento, o esquema de parâmetros e o esquema do formatador de parâmetros.

Convenções da sintaxe Transact-SQL

Sintaxe

sp_syscollector_update_collector_type [ @collector_type_uid = ] 'collector_type_uid' OUTPUT 
          , [ @name = ] 'name' 
          , [ @parameter_schema = ] 'parameter_schema' 
          , [ @collection_package_id = ] collection_package_id 
          , [ @upload_package_id = ] upload_package_id

Argumentos

• [ @collector_type_uid = ] 'collector_type_uid'
  É o GUID do tipo de coletor. collector_type_uid é uniqueidentifier e, se for NULL, será automaticamente criado e retornado como OUTPUT.

• [ @name = ] 'name'
  É o nome do tipo de coletor. name é sysname e deve ser especificado.

• [ @parameter_schema = ] 'parameter_schema'
  É o esquema XML deste tipo de coletor. parameter_schema é xml e pode ser necessário para determinados tipos de coletor. Se não for necessário, esse argumento poderá ser NULL.

• [ @collection_package_id = ] collection_package_id
  É um identificador exclusivo local que aponta para o pacote de coleta do SSIS usado pelo conjunto de coleta. collection_package_id é uniqueidentifer e é necessário. Para obter o valor de collection_package_id, consulte a exibição do sistema dbo.syscollector_collector_types no banco de dados msdb.

• [ @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 é necessário. Para obter o valor de upload_package_id, consulte a exibição do sistema dbo.syscollector_collector_types no banco de dados msdb.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Permissões

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

Exemplo

Esse exemplo atualiza o tipo de coletor de Consulta T-SQL Genérico. (No exemplo, o esquema padrão do tipo de coletor de Consulta T-SQL Genérico é usado.)

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

Consulte também

Referência

Procedimentos armazenados do sistema (Transact-SQL)

Conceitos

Coleta de dados