Categorias:

Funções do sistema (Informação)

SYSTEM$REPORT_HEALTH_STATUS

Envia informações de integridade do aplicativo de um app de consumidor para a conta do provedor.

Sintaxe

SYSTEM$REPORT_HEALTH_STATUS( '<status>' )
Copy

Argumentos

'status'

Um literal de cadeia de caracteres do tipo VARCHAR que indica o status de integridade do aplicativo. Especifique um dos seguintes valores:

  • 'OK': a instância de consumidor está íntegra.

  • 'FAILED': a instância de consumidor está em estado de erro.

  • 'PAUSED': O consumidor pausou o app manualmente.

Notas de uso

  • Esta função deve ser chamada por aplicativos do consumidor. Seu aplicativo deve chamar esta função periodicamente para relatar seu status de integridade à conta do provedor.

  • A lógica do seu aplicativo determina qual status de integridade será relatado com base no próprio monitoramento e tratamento de erros.

  • O status de integridade relatado por esta função fica visível para a conta do provedor por meio da função GET_HEALTH_STATUS. Você deve chamar GET_HEALTH_STATUS periodicamente da conta do provedor para monitorar a integridade das instâncias do consumidor. Se você usar uma tarefa comum ou uma tarefa monitorada para chamar esta função, certifique-se de que o aplicativo tenha os privilégios corretos para executá-la. Considere a configuração de alertas para notificar você quando uma instância do consumidor relatar um status FAILED, um status PAUSED ou parar de relatar o status.

  • O Snowflake retém apenas o status de integridade mais recente relatado por cada instância de consumidor do aplicativo.

  • Para evitar carga excessiva no Snowflake, esta função é limitada por taxa. Se a função for chamada novamente dentro de 55 minutos pela mesma instância do consumidor, ela retornará false para indicar que o relatório de status não foi aceito.

  • Para obter mais informações sobre como monitorar a integridade do aplicativo do lado do provedor, consulte Uso do monitoramento para um aplicativo.

Valor de retorno

  • Esta função retorna TRUE se o status de integridade foi relatado com sucesso.

  • Esta função retorna FALSE se o relatório de status falhou devido à limitação de taxa.