Tarefa Detector de Eventos do WMI

  • Artigo

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

A tarefa Detector de Eventos do WMI detecta um evento de Instrumentação de Gerenciamento do Windows (WMI) por meio de uma consulta de evento WQL (Management Instrumentation Query Language, Linguagem de Consulta de Instrumentação de Gerenciamento) para especificar eventos de interesse. É possível utilizar a tarefa Detector de Eventos do WMI para as seguintes finalidades:

  • Aguardar notificação de que foram adicionados arquivos a uma pasta e depois iniciar o processamento do arquivo.

  • Executar um pacote que exclui arquivos quando a memória disponível em um servidor elimina o que for inferior a um percentual especificado.

  • Detectar a instalação de um aplicativo e então executar um pacote que usa o aplicativo.

Integration Services inclui uma tarefa que lê informações WMI.

Para obter mais informações sobre essa tarefa, clique no tópico a seguir:

Consultas 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, confira a documentação da Instrumentação de Gerenciamento do Windows.

Observação

As classes WMI variam entre versões de Windows.

A consulta seguinte detecta notificação de que o uso da CPU é superior a 40 por cento.

SELECT * from __InstanceModificationEvent WITHIN 2 WHERE TargetInstance ISA 'Win32_Processor' and TargetInstance.LoadPercentage > 40

A consulta seguinte detecta notificação de que um arquivo foi adicionado a uma pasta.

SELECT * FROM __InstanceCreationEvent WITHIN 10 WHERE TargetInstance ISA "CIM_DirectoryContainsFile" and TargetInstance.GroupComponent= "Win32_Directory.Name=\"c:\\\\WMIFileWatcher\""

Mensagens de registro personalizadas disponíveis na tarefa Detector de Eventos do WMI

A tabela a seguir relaciona as entradas de registro personalizadas da tarefa Detector de Eventos do WMI. Para obter mais informações, consulte Log do SSIS (Integration Services).

Entrada de log Descrição
WMIEventWatcherEventOccurred Indica que ocorreu um evento que a tarefa estava monitorando.
WMIEventWatcherTimedout Indica que o tempo limite da tarefa foi esgotado.
WMIEventWatcherWatchingForWMIEvents Indica que a tarefa começou a executar a consulta WQL. A entrada inclui a consulta.

Configuração da tarefa Detector de Eventos do WMI

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 fonte pode ser armazenada fora da tarefa, em uma variável ou um arquivo, ou a consulta pode ser armazenada em uma propriedade de tarefa.

  • Especificar a ação que a tarefa adotará quando o evento WMI ocorrer. Você pode registrar a notificação de eventos e o status após o evento ou levantar eventos personalizados do Integration Services que fornecem informações associadas ao evento WMI, à notificação e ao status após o evento.

  • Definir como a tarefa responde ao evento. A tarefa pode ser configurada para ter êxito ou falhar, dependendo do evento, ou a tarefa pode apenas detectar o evento novamente.

  • Especificar a ação que a tarefa adotará quando a consulta WMI expirar. Você pode registrar a expiração e o status após a expiração ou levantar um evento personalizado do Integration Services , indicando que o evento WMI expirou e registrando a expiração e o status da expiração.

  • Definir como a tarefa responde à expiração. A tarefa pode ser configurada para ter êxito ou falhar, ou a tarefa pode apenas detectar o evento novamente.

  • Especificar o número de vezes que a tarefa detecta o evento.

  • Especificar o limite de tempo.

Se a origem for um arquivo, a tarefa Detector de Eventos 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 Detector de Eventos 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.

Você pode definir propriedades pelo Designer do SSIS ou programaticamente.

Para obter mais informações sobre as propriedades que podem ser definidas no SSIS Designer, 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:

Configuração programática da tarefa Detector de Eventos do WMI

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

Editor da Tarefa Detector de Eventos do WMI (página Geral)

Use a página Geral da caixa de diálogo Editor da Tarefa Detector de Eventos do WMI para nomear e descrever a tarefa Detector de Eventos do 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 Detector de Eventos do 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 Detector de Eventos do WMI.

Editor do Detector de Eventos do WMI (página Opções do WMI)

Use a página Opções do WMI da caixa de diálogo Editor do Detector de Eventos do WMI para especificar a origem da consulta WQL (Instrumentação de Gerenciamento do Windows Query Language) e como a tarefa do Detector de Eventos do WMI responde aos eventos do WMI (Microsoft Windows Instrumentation).

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. Selecionar este valor faz com que seja exibida a opção dinâmica WQLQuerySource.
Conexão do Arquivo Selecione um arquivo que contém a consulta WQL. Selecionar este valor faz com que seja exibida a opção dinâmica WQLQuerySource.
Variável Define a origem de uma variável que define a consulta WQL. Selecionar este valor faz com que seja exibida a opção dinâmica WQLQuerySource.

ActionAtEvent
Especifique se o evento WMI efetua logon do evento e inicia uma ação do SSIS ou só efetua logon do evento.

AfterEvent
Especifique se a tarefa é bem-sucedida ou falha depois que recebe o evento WMI ou se a tarefa continua observando se o evento ocorre novamente.

ActionAtTimeout
Especifique se a tarefa registra o tempo limite excedido da consulta WMI e inicia um evento SSIS em resposta ou só registra o tempo limite excedido.

AfterTimeout
Especifique se a tarefa é bem-sucedida ou falha em resposta ao tempo limite excedido ou se a tarefa continua observando se o tempo limite é excedido novamente.

NumberOfEvents
Especifique o número de eventos a serem observados.

Tempo Limite
Especifique o número de segundos a esperar para que o evento ocorra. Um valor de 0 significa que nenhum tempo limite está em efeito.

Opções dinâmicas do WQLQuerySource

WQLQuerySource = Entrada direta

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

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

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