Esquema:

ORGANIZATION_USAGE

Exibição ALERT_HISTORY

Importante

Essa exibição só está disponível na conta da organização. Para obter mais informações, consulte Exibições premium na conta da organização.

A exibição Organization Usage permite que você recupere o histórico de uso do alerta. A exibição exibe uma linha para cada execução de um alerta no histórico.

Colunas

Colunas em nível de organização

Nome da coluna

Tipo de dados

Descrição

ORGANIZATION_NAME

VARCHAR

Nome da organização.

ACCOUNT_LOCATOR

VARCHAR

Identificador gerado pelo sistema para a conta.

ACCOUNT_NAME

VARCHAR

Identificador definido pelo usuário para a conta.

Colunas adicionais

Nome da coluna

Tipo de dados

Descrição

NAME

VARCHAR

Nome do alerta.

DATABASE_NAME

VARCHAR

Nome do banco de dados que contém o alerta.

SCHEMA_NAME

VARCHAR

Nome do esquema que contém o alerta.

ACTION

VARCHAR

O texto da instrução SQL que serve como ação para o alerta.

ACTION_QUERY_ID

VARCHAR

Identificador interno/gerado pelo sistema para a instrução SQL executada como ação do alerta.

CONDITION

VARCHAR

O texto da instrução SQL que serve como condição para o alerta.

CONDITION_QUERY_ID

VARCHAR

Identificador interno/gerado pelo sistema para a instrução SQL executada como a condição do alerta.

ERROR_CODE

NUMBER

Código de erro, se o alerta tiver retornado um erro ou não tiver sido executado (por exemplo, se o usuário atual não tinha privilégios para executar o alerta).

ERROR_MESSAGE

VARCHAR

Mensagem de erro, se o alerta tiver retornado um erro.

STATE

VARCHAR

Status do alerta. Isso pode ser uma das seguintes opções:

  • SCHEDULED: o alerta será executado no momento especificado pela coluna SCHEDULED_TIME. Esse status não se aplica aos alertas sobre novos dados.

  • EXECUTING: a condição ou ação do alerta está sendo executada atualmente.

  • FAILED: o alerta falhou. A condição de alerta ou a ação de alerta encontrou um erro que a impediu de ser executada.

  • CANCELLED: a execução do alerta foi cancelada (por exemplo, quando o alerta é suspenso).

  • CONDITION_FALSE: a condição foi avaliada com sucesso, mas não retornou dados. Como resultado, a ação não foi executada. Esse status não se aplica aos alertas sobre novos dados.

  • CONDITION_FAILED: a avaliação da condição falhou. Para obter mais detalhes sobre a falha, verifique as colunas ERROR_CODE e ERROR_MESSAGE.

  • ACTION_FAILED: a condição foi avaliada com sucesso, mas a execução da ação fracassou. Para obter mais detalhes sobre a falha, verifique as colunas ERROR_CODE e ERROR_MESSAGE.

  • TRIGGERED: a condição foi avaliada com sucesso, e a ação foi executada com sucesso.

SCHEDULED_TIME

TIMESTAMP_LTZ

Hora em que o alerta programado está/estava programado para começar a ser executado.

Observe que nos esforçamos ao máximo para garantir precisão absoluta, mas apenas garantimos que os alertas não sejam executados antes do horário programado.

COMPLETED_TIME

TIMESTAMP_LTZ

Tempo em que o alerta foi concluído, ou NULL se SCHEDULED_TIME estiver no futuro ou se o alerta ainda estiver em execução.

DATABASE_ID

NUMBER

Identificador interno/gerado pelo sistema para o banco de dados que contém o esquema.

SCHEMA_ID

NUMBER

Identificador interno/gerado pelo sistema para o esquema.

SCHEDULED_FROM

VARCHAR

Especifica o que iniciou o alerta. A coluna contém um dos seguintes valores:

  • SCHEDULE: o alerta foi programado para ser executado normalmente, conforme descrito na cláusula SCHEDULE de CREATE ALERT.

  • EXECUTE ALERT: o alerta foi programado para ser executado usando EXECUTE ALERT.

  • TRIGGER: o alerta sobre novos dados foi executado porque a tabela ou exibição subjacente contém novos dados.

Notas de uso

  • A latência da exibição pode ser de até 24 horas.

  • Para melhorar o desempenho, filtre as consultas na coluna COMPLETED_TIME ou SCHEDULED_TIME.

Exemplos

Recuperar registros para as 10 execuções de alerta mais recentes concluídas:

SELECT account_name, name, condition, condition_query_id, action, action_query_id, state
  FROM snowflake.organization_usage.alert_history
  LIMIT 10;
Copy

Recuperar registros de execuções de alerta concluídas na última hora:

SELECT account_name, name, condition, condition_query_id, action, action_query_id, state
FROM snowflake.organization_usage.alert_history
WHERE COMPLETED_TIME > DATEADD(hours, -1, CURRENT_TIMESTAMP());
Copy