Tipo de coletor de Consultas T-SQL Genérico

Esquema de entrada de Consultas T-SQL Genérico

O esquema de entrada do coletor de Consultas T-SQL Genérico é como a seguir.

<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>

Os códigos de exemplo a seguir mostram como o esquema pode ser usado. Para obter um exemplo de código completo, consulte Como criar um conjunto de coleta personalizado que usa o tipo de coletor de Consultas T-SQL genérico.

Exemplo 1

<ns:TSQLQueryCollector xmlns:ns="DataCollectorType">
  <Query>
    <Value>SELECT DB_NAME() as db_name</Value>
    <OutputTable>VerifyDbName</OutputTable>
  </Query>
  <Databases UseSystemDatabases="true" UseUserDatabases="true" /> 
</ns:TSQLQueryCollector>

Exemplo 2

<ns:TSQLQueryCollector xmlns:ns="DataCollectorType">
  <Query>
    <Value>SELECT * FROM sys.objects</Value>
    <OutputTable>MyOutputTable1</OutputTable>
  </Query>
  <Databases>
    <Database>model</Database>
    <Database>tempdb</Database>
    <Database>master</Database>
  </Databases>
</ns:TSQLQueryCollector>

Exemplo 3

<ns:TSQLQueryCollector xmlns:ns="DataCollectorType">
  <Query>
    <Value>SELECT * FROM sys.dm_tran_database_transactions</Value>
    <OutputTable>MyOutputTable2</OutputTable>
  </Query>
  <Query>
    <Value>SELECT * FROM sys.dm_db_file_space_usage</Value>
    <OutputTable>MyOutputTable3</OutputTable>
  </Query>
  <Databases UseSystemDatabases="false" UseUserDatabases="true" />
</ns:TSQLQueryCollector>

Exemplo 4

<ns:TSQLQueryCollector xmlns:ns="DataCollectorType">
  <Query>
    <Value>SELECT * FROM mytable</Value> -- Query mytable
    <OutputTable>MyOutputTable1</OutputTable>
  </Query>
  <Databases>
    <Database>db1</Database>
  </Databases>
</ns:TSQLQueryCollector>

<ns:TSQLQueryCollector xmlns:ns="DataCollectorType">
  <Query>
    <Value>SELECT * FROM mytable</Value> -- Query mytable
    <OutputTable>MyOutputTable2</OutputTable>
  </Query>
  <Databases>
    <Database>db2</Database>
  </Databases>
</ns:TSQLQueryCollector>

Processamento e saída

Os metadados de saída da consulta dependem da instrução Transact-SQL especificada pelo usuário, mas os mapeamentos de coluna na origem ou no destino do fluxo de dados são criados no momento do design. Isso significa que cada item de coleta que usa esse tipo de coletor requer um pacote personalizado gerado no tempo de execução e ajustado ao formato de seu esquema.

O coletor de dados usa uma tarefa personalizada para criar um pacote de coletas e um pacote de carregamentos quando um novo item de coleta é recebido, ou se houver uma atualização nos parâmetros de entrada de um item de coleta existente. Esses pacotes são salvos no msdb de forma que possam ser reutilizados.

O comportamento de coleta e carregamento é semelhante ao descrito em Arquitetura e processamento do coletor de dados, mas com implementações ligeiramente diferentes para o tipo de coletor de Consultas T-SQL Genérico.

As seguintes tabelas do data warehouse de gerenciamento são usadas para armazenar dados coletados pelo tipo de coletor de Consultas T-SQL Genérico:

• core.snapshots - Esta tabela identifica cada novo instantâneo.

• core.snapshot_timetable - A hora do instantâneo é armazenada em uma tabela separada, porque muitos instantâneos podem ocorrer quase ao mesmo tempo.

• core.source.info - Esta tabela armazena informações sobre a fonte de dados assim como os dados.

Limitações

Há determinadas limitações a serem consideradas ao usar o tipo de coletor de Consultas T-SQL Genérico:

• Os seguintes nomes de coluna são reservados para o coletor de dados: snapshot_time, snapshot_id e database_name. Nenhuma tabela criada por conjuntos de coleta personalizados pode usar esses nomes. Um erro será retornado se uma tentativa for feita para usá-los.

• Uma coluna de tipo sysname é convertida em nvarchar(128) quando é copiada no data warehouse de gerenciamento. Durante a coleta de dados, o SQL Server 2008 Integration Services (SSIS) converte tipos de dados de banco de dados em tipos de dados SSIS (por exemplo, sysname se torna DT_WSTR e nvarchar(len) se torna DT_WSTR). Essa conversão ocorre dentro da tarefa de fluxo de dados de origem OLEDB. Durante o carregamento dos dados, o coletor de dados lê os dados do cache como um tipo de dados SSIS e os dados são tratados como nvarchar(128) que é funcionalmente equivalente a sysname.

• Uma coluna do tipo char(N) se torna varchar(N) quando copiada no data warehouse de gerenciamento (char(N) pode ser ajustado em varchar(N)). Exceto pelo fato de que o tamanho do armazenamento de char é fixo, enquanto o tamanho do armazenamento de varchar é variável, esses tipos são tratados como funcionalmente equivalentes.

• Uma coluna de tipo varbinary se torna em binary quando é copiada no data warehouse de gerenciamento.

• Uma coluna de tipo decimal se torna numeric quando é copiada no data warehouse de gerenciamento.

• Uma coluna de tipo nchar se torna nvarchar quando é copiada no data warehouse de gerenciamento.

• O tipo sqlvariant é controlado pelo processamento padrão de colunas que o SSIS não controla diretamente. Isso significa que as colunas são tratadas como nvarchar(255), deixando qualquer conversão para o provedor de dados.

  Observação
  Nesse caso, a coluna é criada com um comprimento padrão de 255 caracteres. No entanto, ele pode ser alterado para até 4.000 caracteres.

• Todas as colunas retornadas por uma consulta Transact-SQL devem ter um nome. Por exemplo, select 1 não funcionará, mas select 1 as one funcionará.

• Os tipos de dados a seguir não têm suporte no SSIS e não podem ser incluídos como colunas em nenhuma tabela de saída gerada por um conjunto de coleta que usa o tipo de coletor de Consultas T-SQL Genérico:

  • image

  • text

  • ntext

  • XML

• Todas as consultas executadas pelo tipo de coletor Consultas T-SQL Genérico devem retornar um único conjunto de resultados.

• Só haverá suporte para consultas de tabela temporárias locais se elas forem declaradas primeiro como parte do mesmo lote. Há suporte total para consultas de tabela temporárias globais.

• Nenhum índice, chaves privadas, chaves estrangeiras ou qualquer outra restrição são transferidos às tabelas de destino no data warehouse de gerenciamento. Isso porque os mesmos dados são consultados várias vezes, e os dados podem estar vindo de vários computadores para uma única tabela.

• Qualquer outra limitação referente ao tipo de consultas suportadas que se aplica à tarefa de fluxo de dados de origem OLE DB no SSIS também se aplica ao tipo de coletor Consultas T-SQL Genérico.

Histórico de alterações

Consulte também

Tarefas

Conceitos

Outros recursos