- 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>' )
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 statusPAUSEDou 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á
falsepara 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.