Teste de Evento de SQL Definido pelo Usuário

O teste de evento de SQL Definido pelo Usuário permite definir o seu próprio script SQL que avalia um teste de evento. Os testes de evento definidos por você devem ser escritos como consultas (ou seja, instruções SELECT) que retornem valores de condições que você esteja monitorando. Esses valores são verificados em relação aos limites de Alerta e Advertência especificados por você e disparam o evento caso os limites sejam atingidos.

Exemplo:

Você tem uma aplicação personalizada executada sobre o banco de dados Oracle. Toda vez que encontra um erro de aplicação, é criada uma entrada em uma tabela chamada "error_log". Usando o "Teste SQL Definido pelo Usuário", você pode escrever um teste de evento que o notifique quando encontrar pelo menos 50 erros. Especificamente, você define a seguinte instrução SQL:

select count(*) from error_log

Isso retorna o número de linhas da tabela error_log. Como deseja que um alerta seja gerado ao atingir pelo menos 50, você especifica o Operador " >= ", um valor Alerta de 50 e, talvez, um valor Advertência de 30.

Suporte para Funções PL/SQL

Se a sua consulta da condição do evento exigir um processamento mais complexo do que o permitido em uma única instrução SELECT, você pode primeiro criar uma função pl/sql que contenha as etapas de processamento extras e, em seguida, usar a função pl/sql com o teste de evento SQL Definido pelo Usuário. A sua função pl/sql deve ainda retornar um valor que possa ser comparado com os limites de Alerta e de Advertência.

Exemplo:

Você precisa disparar um alerta sempre que o salário de um funcionário for $500 mais alto que o maior salário de gerente. Primeiro você define uma função pl/sql como a seguir:

create or replace function overpaid_emp return number is

max_mgr_sal number;

max_emp_sal number;

begin

select max(sal) into max_mgr_sal from scott.emp where job = 'GERENTE' or job = 'PRESIDENTE';

select max(sal) into max_emp_sal from scott.emp where job != 'GERENTE' and job != 'PRESIDENTE';

return (max_emp_sal - max_mgr_sal);

end;

Essa função pl/sql retorna a diferença entre o maior salário de funcionário e o maior salário de gerente. Se a diferença for um número positivo, um funcionário possui a mais alta remuneração. Se a diferença for maior que 500, um alerta precisa ser disparado.

Ao definir esse evento usando o teste de evento SQL Definido pelo Usuário, você define a instrução SQL como a seguir:

select overpaid_emp from dual

Em seguida, use o Operador ">", um Limite de advertências de 100 e um Limite de alertas de 500.

Observe que ROLES não são ativados dentro de funções pl/sql, portanto, quaisquer privilégios concedidos através de ROLES não funcionarão de dentro da função. Pode ser necessário conceder os privilégios diretamente à conta do usuário de banco de dados utilizada para o evento. (A conta de usuário de banco de dados utilizada para o evento corresponde ao usuário de Credenciais Preferenciais do banco de dados ou as credenciais especificadas para substituir as credenciais preferenciais).

Parâmetros

· Sobrepor Credencial Preferencial: Marque esta caixa se você quiser alterar o nome do usuário ou a senha, ou ambos.

· Operador: Selecione um dos operadores de comparação a seguir: == (igual a); < (menor que); > (maior que); <= (menor que ou igual a); >= (maior que ou igual a); != (diferente de)

· Limite de Alertas: Dependendo do script SQL, digite um número ou uma string de texto.

· Limite de Advertências: Dependendo do script SQL, digite um número ou uma string de texto.

· Ocorrências Anteriores às Notificações: Digite um valor numérico indicando quantas vezes este teste deve retornar um resultado verdadeiro até que um flag de alerta seja exibido na console e uma notificação seja enviada.

· SQL: Digite o script SQL que você quer usar. Você também pode recortar e colar a SQL de um script existente.

Saída

Valor retornado pelo script SQL

Freqüência Default

60 segundos

Ação do Usuário

A ação depende do script SQL e, portanto, a Oracle não pode fazer nenhuma recomendação.