Tarefa Leitor de Dados do WMI

Aplica-se a:SQL Server SSIS Integration Runtime no Azure Data Factory

A tarefa Leitor de Dados do WMI executa consultas por meio da linguagem de consulta WMI (Instrumentação de Gerenciamento do Windows) que retorna informações de WMI sobre um sistema de computador. Pode-se utilizar o Leitor de Dados WMI para as seguintes finalidades:

  • Consultar os logs de eventos do Windows em um computador local ou remoto e gravar as informações em um arquivo ou variável.

  • Obter informações sobre a presença, o estado ou as propriedades de componentes de hardware e, depois, usar essas informações para determinar se outras tarefas no fluxo de controle devem ser executadas.

  • Obter uma lista de aplicativos e determinar qual versão de cada aplicativo está instalada.

Você pode configurar a tarefa Leitura de Dados do WMI das seguintes formas:

  • Especifique o gerenciador de conexões WMI a ser usado.

  • Especifique a fonte da consulta WQL. A consulta pode ser armazenada em uma propriedade de tarefa, ou pode ser armazenada fora da tarefa, em uma variável ou um arquivo.

  • Defina o formato dos resultados da consulta WQL. A tarefa oferece suporte a uma tabela, par de nome/valor de propriedade ou formato de valor de propriedade.

  • Espefique o destino da consulta. O destino pode ser um variável ou um arquivo.

  • Indique se o destino de consulta é substituído, mantido ou acrescentado.

Se a origem ou o destino for um arquivo, a tarefa Leitor de Dados do WMI usará um gerenciador de conexões de Arquivo para se conectar ao arquivo. Para obter mais informações, consulte Flat File Connection Manager.

A tarefa Leitor de Dados do WMI usa um gerenciador de conexões WMI para se conectar ao servidor do qual lê informações de WMI. Para obter mais informações, consulte WMI Connection Manager.

Consulta WQL

WQL é um dialeto do SQL com extensões para dar suporte à notificação de eventos de WMI e outros recursos específicos ao WMI. Para obter mais informações sobre WQL, consulte a documentação da Instrumentação de Gerenciamento do Windows na Biblioteca do MSDN.

Observação

As classes WMI variam entre versões de Windows.

A consulta WQL a seguir retorna entradas no evento de logs do aplicativo.

SELECT * FROM Win32_NTLogEvent WHERE LogFile = 'Application' AND (SourceName='SQLISService' OR SourceName='SQLISPackage') AND TimeGenerated > '20050117'  

A consulta WQL a seguir retorna informações lógicas de disco.

SELECT FreeSpace, DeviceId, Size, SystemName, Description FROM Win32_LlogicalDisk  

A consulta WQL a seguir retorna uma lista das atualizações QFE (Quick Fix Engineering) ao sistema operacional.

Select * FROM Win32_QuickFixEngineering  

Mensagens de log personalizadas disponíveis na tarefa Leitor de Dados do WMI

A tabela a seguir relaciona as entradas de log personalizadas para a tarefa Leitor de Dados do WMI. Para obter mais informações, consulte Log do SSIS (Integration Services).

Entrada de log Descrição
WMIDataReaderGettingWMIData Indica que a tarefa começou a ser ler os dados do WMI.
WMIDataReaderOperation Informa a consulta WQL executada pela tarefa.

Configuração da tarefa Leitor de Dados do WMI

Você pode definir propriedades programaticamente ou por meio do Designer SSIS .

Para obter mais informações sobre as propriedades que podem ser definidas no SSIS Designer, clique no tópico a seguir:

Para obter informações sobre como definir essas propriedades programaticamente, clique no tópico a seguir:

Para obter mais informações sobre como definir essas propriedades no SSIS Designer, clique no tópico a seguir:

Editor da Tarefa Leitor de Dados do WMI (página Geral)

Use a página Geral da caixa de diálogo Editor da Tarefa Leitor de Dados WMI para nomear e descrever a tarefa Leitor de Dados WMI.

Para obter mais informações sobre a linguagem WQL, consulte o tópico Instrumentação de Gerenciamento do Windows, Querying with WQL(Consultando com WQL), na Biblioteca MSDN.

Opções

Nome
Forneça um nome exclusivo para a tarefa Leitor de Dados WMI. Esse nome é usado como rótulo no ícone de tarefa.

Observação

Os nomes das tarefas devem ser exclusivos em um pacote.

Descrição
Digite uma descrição para a tarefa Leitor de Dados WMI.

Editor da Tarefa Leitor de Dados do WMI (página Opções do WMI)

Use a página Opções do WMI da caixa de diálogo Editor da Tarefa Leitor de Dados do WMI para especificar a origem da consulta da linguagem WQL e o destino do resultado da consulta.

Para obter mais informações sobre a linguagem WQL, consulte o tópico Instrumentação de Gerenciamento do Windows, Querying with WQL(Consultando com WQL), na Biblioteca MSDN.

Opções estáticas

WMIConnectionName
Selecione um gerenciador de conexões WMI na lista ou clique em <Nova Conexão WMI...> para criar um novo gerenciador de conexões.

Tópicos relacionados:Gerenciador de Conexões WMI, Editor do Gerenciador de Conexões WMI

WQLQuerySourceType
Selecione o tipo de origem da consulta WQL que a tarefa executa. As opções dessa propriedade são listadas na tabela a seguir.

Valor Descrição
Entrada Direta Defina a origem de consultas WQL. Ao selecionar esse valor, a opção dinâmica WQLQuerySourceTypeserá exibida.
Conexão do Arquivo Selecione um arquivo que contém a consulta WQL. Ao selecionar esse valor, a opção dinâmica WQLQuerySourceTypeserá exibida.
Variável Defina a origem de uma variável que defina a consulta WQL. Ao selecionar esse valor, a opção dinâmica WQLQuerySourceTypeserá exibida.

OutputType
Especifique se a saída deve ser uma tabela de dados, valor de propriedade ou nome e valor de propriedade.

OverwriteDestination
Especifique se é necessário manter, substituir ou adicionar aos dados originais no arquivo ou variável de destino.

DestinationType
Selecione o tipo de destino da consulta WQL que a tarefa executa. As opções dessa propriedade são listadas na tabela a seguir.

Valor Descrição
Conexão do Arquivo Selecione um arquivo no qual salvar os resultados da consulta WQL. A seleção desse valor exibe a opção dinâmica DestinationType.
Variável Defina a variável na qual armazenar os resultados da consulta WQL. A seleção desse valor exibe a opção dinâmica DestinationType.

Opções dinâmicas de WQLQuerySourceType

WQLQuerySourceType = Entrada direta

WQLQuerySource
Forneça uma consulta ou clique nas reticências (...) e digite uma consulta, usando a caixa de diálogo Consulta WQL.

WQLQuerySourceType = Conexão do arquivo

WQLQuerySource
Selecione um gerenciador de conexões de arquivos na lista ou clique em <Nova conexão...> para criar um novo gerenciador de conexões.

Tópicos relacionados:File Connection Manager, File Connection Manager Editor

WQLQuerySourceType = Variável

WQLQuerySource
Selecione uma variável na lista ou clique em <Nova variável...> para criar uma variável.

Tópicos relacionados: Variáveis do Integration Services (SSIS), Adicionar variável

Opções dinâmicas de DestinationType

DestinationType = Conexão do arquivo

Destino
Selecione um gerenciador de conexões de arquivos na lista ou clique em <Nova conexão...> para criar um novo gerenciador de conexões.

Tópicos relacionados:File Connection Manager, File Connection Manager Editor

DestinationType = Variável

Destino
Selecione uma variável na lista ou clique em <Nova variável...> para criar uma nova variável.

Tópicos relacionados: Variáveis do Integration Services (SSIS), Adicionar variável

Consulte Também

Tarefas do Integration Services
Fluxo de Controle