SYSTEM$REPORT_HEALTH_STATUS¶

Syntax¶

SYSTEM$REPORT_HEALTH_STATUS( '<status>' )

Argumente¶

'status'

Ein Zeichenfolgenliteral vom Typ VARCHAR, das den Integritätsstatus der Anwendung angibt. Sie können einen der folgenden Werte angeben:

• 'OK': Die Verbraucherinstanz ist funktionsfähig.

• 'FAILED': Die Verbraucherinstanz hat einen Fehlerstatus.

• 'PAUSED': Der Verbraucher hat die App manuell angehalten.

Nutzungshinweise¶

• Diese Funktion ist für den Aufruf durch Verbraucheranwendungen vorgesehen. Ihre Anwendung sollte diese Funktion in regelmäßigen Abständen aufrufen, um ihren Integritätsstatus an das Anbieterkonto zu melden.

• Ihre Anwendungslogik bestimmt auf der Grundlage ihrer eigenen Überwachung und Fehlerbehandlung, welcher Integritätsstatus gemeldet werden soll.

• Der von dieser Funktion gemeldete Integritätsstatus ist für das Anbieterkonto über die GET_HEALTH_STATUS-Funktion sichtbar. Sie sollten regelmäßig GET_HEALTH_STATUS vom Anbieterkonto aus aufrufen, um den Zustand der Verbraucherinstanzen zu überwachen. Wenn Sie eine Aufgabe oder eine überwachte Aufgabe verwenden, um diese Funktion aufzurufen, stellen Sie sicher, dass die Anwendung über die richtigen Berechtigungen zur Ausführung der Aufgabe verfügt. Erwägen Sie die Einrichtung von Alerts, die Sie benachrichtigen, wenn eine Verbraucherinstanz einen FAILED-Status oder einen PAUSED-Status meldet bzw. keinen Status mehr meldet.

• Snowflake behält nur den letzten Integritätsstatus bei, der von jeder Verbraucherinstanz der Anwendung gemeldet wurde.

• Um eine übermäßige Auslastung von Snowflake zu vermeiden, hat diese Funktion ein Ratenlimit. Wenn die Funktion innerhalb von 55 Minuten von derselben Verbraucherinstanz erneut aufgerufen wird, gibt sie false zurück, um anzuzeigen, dass der Statusbericht nicht akzeptiert wurde.

• Weitere Informationen zur Überwachung des Zustands von Anwendungen auf Seiten des Anbieters finden Sie unter Verwenden der Überwachung für eine App.

Rückgabewert¶

• Diese Funktion gibt TRUE zurück, wenn der Integritätsstatus erfolgreich gemeldet wurde.

• Diese Funktion gibt FALSE zurück, wenn der Statusbericht aufgrund einer Ratenbegrenzung fehlgeschlagen ist.