Catégories :: Fonctions système (informations)

SYSTEM$REPORT_HEALTH_STATUS¶

Envoie des informations sur la santé de l’application depuis une application consommateur vers le compte fournisseur.

Syntaxe¶

SYSTEM$REPORT_HEALTH_STATUS( '<status>' )

Copy

Arguments¶

'status': Une chaîne littérale de type VARCHAR qui indique l’état de santé de l’application. Vous pouvez spécifier l’une des valeurs suivantes :

'OK' : L’instance du consommateur est en bonne santé.
'FAILED' : L’instance du consommateur est dans un état d’erreur.
'PAUSED' : Le consommateur a mis manuellement l’application en pause.

Notes sur l’utilisation¶

Cette fonction est destinée à être appelée par les applications consommateurs. Votre application doit appeler cette fonction périodiquement pour signaler son état de santé au compte du fournisseur.
Votre logique d’application détermine l’état de santé à signaler, en fonction de sa propre surveillance et de son propre traitement des erreurs.
L’état de santé signalé par cette fonction est visible par le compte du fournisseur via la fonction GET_HEALTH_STATUS. Appelez GET_HEALTH_STATUS périodiquement depuis le compte fournisseur pour surveiller la santé des instances de consommateurs. Si vous utilisez une tâche ou une tâche surveillée pour appeler cette fonction, assurez-vous que l’application dispose des privilèges appropriés pour exécuter la tâche. Pensez à configurer des alertes pour vous informer lorsqu’une instance de consommateur signale un état FAILED, un état PAUSED, ou arrête de signaler son état.
Snowflake ne conserve que l’état de santé le plus récent signalé par chaque instance consommateur de l’application.
Pour éviter une charge excessive sur Snowflake, cette fonction présente des limites de débit. Si la fonction est appelée à nouveau dans les 55 minutes depuis la même instance de consommateur, elle renverra false pour indiquer que le rapport d’état n’a pas été accepté.
Pour plus d’informations sur la surveillance de la santé des applications du côté du fournisseur, voir Surveillance de l’utilisation d’une application.

Valeur de retour¶

Cette fonction renvoie TRUE si l’état de santé a été signalé avec succès.
Cette fonction renvoie FALSE si le rapport de l’état a échoué en raison de la limitation du débit.