Configuração de uma tarefa para enviar notificações de erro¶

Para que uma tarefa possa enviar notificações de erro, você deve associar a tarefa com uma integração de notificação. Você pode fazer isso ao executar o comando CREATE TASK para criar uma nova tarefa ou o comando ALTER TASK para modificar uma tarefa existente. Ao executar estes comandos, defina ERROR_NOTIFICATION para o nome da integração da notificação.

Você só especifica as integrações de notificação de erro em uma tarefa raiz de um gráfico de tarefa; qualquer tarefa filho com falha envia notificações de erro para a integração especificada da tarefa raiz.

Tarefas com TASK_AUTO_RETRY_ATTEMPTS definido como um valor maior que 0 enviam notificações de erro para cada execução de tarefa com falha.

Nota

Criar ou modificar uma tarefa que faz referência a uma integração de notificação requer uma função que tenha o privilégio USAGE sobre a integração de notificação. Além disso, a função deve ter ou o privilégio CREATE TASK sobre o esquema ou o privilégio OWNERSHIP para a tarefa, respectivamente.

Neste tópico:

Criação de uma nova tarefa que envia notificações de erro¶

Crie uma nova tarefa usando CREATE TASK. Para descrições de todos os parâmetros de tarefa disponíveis, consulte o tópico de comando SQL:

CREATE TASK <name>
  [...]
  ERROR_INTEGRATION = <integration_name>
  AS <sql>

Copy

Onde:

ERROR_INTEGRATION = integration_name: Nome da integração da notificação criada em uma das notificações de nível de plataforma AWS SNS, Google Pub/Sub ou Azure Event Grid.

O exemplo a seguir cria uma tarefa sem servidor que suporta notificações de erro. A tarefa insere o carimbo de data/hora atual em uma coluna de tabela a cada 5 minutos:

CREATE TASK mytask
  SCHEDULE = '5 MINUTE'
  ERROR_INTEGRATION = my_notification_int
  AS
  INSERT INTO mytable(ts) VALUES(CURRENT_TIMESTAMP);

Copy

Atualização de uma tarefa existente para enviar notificações de erro¶

Modifique uma tarefa existente usando ALTER TASK:

ALTER TASK <name> SET ERROR_INTEGRATION = <integration_name>;

Copy

Onde integration_name é o nome da integração de notificação criada em uma das notificações do nível da plataforma AWS SNS, Google Pub/Sub ou Azure Event Grid.

Por exemplo:

ALTER TASK mytask SET ERROR_INTEGRATION = my_notification_int;

Copy