Tarefa do Leitor de Dados WMI

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

A tarefa do Leitor de Dados WMI executa consultas usando a Linguagem de Consulta de Instrumentação de Gestão do Windows (WMI), que retorna informações do WMI sobre um sistema informático. Pode usar a tarefa do Leitor de Dados WMI para os seguintes fins:

Consulte os registos de eventos do Windows num computador local ou remoto e escreva a informação num ficheiro ou variável.
Obtenha informações sobre a presença, estado ou propriedades dos componentes de hardware e, depois, use essa informação para determinar se outras tarefas no fluxo de controlo devem ser executadas.
Obtenha uma lista de aplicações e determine que versão de cada uma está instalada.

Pode configurar a tarefa do Leitor de Dados WMI das seguintes formas:

Especifique o gestor de ligação WMI a usar.
Especifique a origem da consulta WQL. A consulta pode ser armazenada numa propriedade de tarefa, ou pode ser armazenada fora da tarefa, numa variável ou num ficheiro.
Defina o formato dos resultados da consulta WQL. A tarefa suporta uma tabela, par nome/valor de propriedade ou formato de valor de propriedade.
Especifique o destino da consulta. O destino pode ser uma variável ou um ficheiro.
Indique se o destino da consulta está sobrescrito, mantido ou acrescentado.

Se a origem ou destino for um ficheiro, a tarefa do Leitor de Dados WMI utiliza um gestor de ligação de ficheiros para se ligar ao ficheiro. Para mais informações, consulte Gestor de Ligação de Ficheiros Planos.

A tarefa do Leitor de Dados WMI utiliza um gestor de ligação WMI para se ligar ao servidor a partir do qual lê a informação do WMI. Para mais informações, consulte o WMI Connection Manager.

Consulta WQL

WQL é um dialeto de SQL com extensões para suportar notificações de eventos WMI e outras funcionalidades específicas de WMI. Para mais informações sobre WQL, consulte a documentação da Instrumentação de Gestão do Windows na Biblioteca MSDN.

Observação

As classes WMI variam entre versões do Windows.

A seguinte consulta WQL devolve entradas no registo de eventos da Aplicação.

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

A consulta WQL seguinte devolve informação lógica do disco.

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

A consulta WQL seguinte devolve uma lista das atualizações rápidas de engenharia de correcção (QFE) do sistema operativo.

Select * FROM Win32_QuickFixEngineering

Mensagens de registo personalizáveis disponíveis na tarefa de leitura de dados WMI

A tabela seguinte lista as entradas de registo personalizadas para a tarefa WMI Data Reader. Para obter mais informações, consulte o Log de Serviços de Integração (SSIS) .

Entrada de log	Description
WMIDataReaderObtendoDadosWMI	Indica que a tarefa iniciou a leitura dos dados do WMI.
WMIDataReaderOperation	Relata a consulta WQL que a tarefa executou.

Configuração da Tarefa do Leitor de Dados WMI

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

Para informações sobre as propriedades que pode definir no SSIS Designer, clique no seguinte tópico:

Página de Expressões

Para informações sobre como definir programaticamente estas propriedades, clique no seguinte tópico:

WmiDataReaderTask

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

Definir as propriedades de uma tarefa ou contêiner

Editor de Tarefas do Leitor de Dados WMI (Página Geral)

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

Para mais informações sobre a WMI Query Language (WQL), consulte o tópico Windows Management Instrumentation, Querying with WQL, na MSDN Library.

Opções

Nome
Forneça um nome único para a tarefa do WMI Data Reader. Esse nome é usado como o rótulo no ícone da tarefa.

Observação

Os nomes das tarefas devem ser exclusivos dentro de um pacote.

Descrição
Escreva uma descrição da tarefa do WMI Data Reader.

Editor de Tarefas do Leitor de Dados WMI (Página de Opções WMI)

Use a página de Opções WMI da caixa de diálogo do Editor de Tarefas do Leitor de Dados WMI para especificar a origem da consulta à Linguagem de Consulta de Instrumentação de Gestão do Windows (WQL) e o destino do resultado da consulta.

Para mais informações sobre a WMI Query Language (WQL), consulte o tópico Windows Management Instrumentation, Querying with WQL, na MSDN Library.

Opções estáticas

WMIConnectionName
Selecione um gestor de ligações WMI na lista, ou clique <em Nova Ligação WMI...> para criar um novo gestor de ligações.

Tópicos Relacionados:WMI Connection Manager, WMI Connection Manager Editor

WQLQuerySourceType
Selecione o tipo de origem da consulta WQL que a tarefa executa. Esta propriedade tem as opções listadas na tabela a seguir.

Valor	Description
Entrada direta	Defina a fonte para uma consulta WQL. Ao selecionar este valor, apresenta-se a opção dinâmica WQLQuerySourceType.
Conexão de arquivo	Selecione um ficheiro que contenha a consulta WQL. Ao selecionar este valor, apresenta-se a opção dinâmica WQLQuerySourceType.
Variável	Defina a fonte para uma variável que defina a consulta WQL. Ao selecionar este valor, apresenta-se a opção dinâmica WQLQuerySourceType.

OutputType
Especifique se o resultado deve ser uma tabela de dados, valor de propriedade ou nome e valor da propriedade.

OverwriteDestination
Especifica se deve manter, sobrescrever ou acrescentar aos dados originais no ficheiro ou variável de destino.

DestinationType
Selecione o tipo de destino da consulta WQL que a tarefa executa. Esta propriedade tem as opções listadas na tabela a seguir.

Valor	Description
Conexão de arquivo	Selecione um ficheiro para guardar os resultados da consulta WQL. Ao selecionar este valor, apresenta a opção dinâmica, DestinationType.
Variável	Defina a variável para armazenar os resultados da consulta WQL. Ao selecionar este valor, apresenta a opção dinâmica, DestinationType.

WQLQuerySourceType Opções Dinâmicas

WQLQuerySourceType = Entrada direta

WQLQuerySource
Fornecer uma consulta, ou clicar na reticência (...) e inserir uma consulta usando a caixa de diálogo WQL Query .

WQLQuerySourceType = Conexão de ficheiro

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

Tópicos relacionados:Gerenciador de Conexão de Ficheiros, Editor de Gerenciador de Conexão de Ficheiros

WQLQuerySourceType = Variável

WQLQuerySource
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

DestinationType Opções Dinâmicas

DestinationType = Ligação ao ficheiro

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