Einrichten und Verwalten einer Ereignistabelle im Anbieterkonto¶
Unter diesem Thema wird beschrieben, wie Anbieter eine Ereignistabelle einrichten und die gemeinsame Nutzung von Ereignissen für eine App verwalten können.
Richten Sie in jeder Region eine Ereignistabelle in der Anbieterorganisation ein¶
Um die Protokollmeldungen und Trace-Ereignisse zu sammeln, die ein Verbraucher freigibt, muss ein Anbieter eine Ereignistabelle einrichten, indem er Folgendes tut:
Wichtig
Wenn ein Anbieter nicht über ein Konto und eine aktive Ereignistabelle in der Region verfügt, in der die App installiert ist, bevor der Verbraucher eine App installiert, werden Ereignisse und Protokollmeldungen verworfen.
Konto als Ereigniskonto festlegen¶
Um freigegebene Protokolle und Ereignisse zu speichern, muss ein Anbieter ein Konto auswählen, das eine Ereignistabelle enthält. Dies kann jedes Konto sein, auf das der Anbieter Zugriff hat. Wenn eine Organisation jedoch mehrere Anbieter hat, die Anwendungspakete veröffentlichen, sollten Sie die Verwendung eines Snowflake-Kontos in Betracht ziehen, das speziell zum Speichern freigegebener Ereignisse der Verbraucher bestimmt ist.
Die folgenden Einschränkungen gelten für Konten, die zum Speichern freigegebener Ereignisse verwendet werden:
Sie müssen die Rolle ORGADMIN verwenden, um ein Konto für das Speichern von Ereignissen festzulegen.
Das Konto muss über eine aktive Ereignistabelle verfügen.
Das angegebene Konto darf keine der folgenden Merkmal aufweisen:
Konto ist gesperrt oder ausgesetzt.
Konto ist ein Leserkonto.
Konto ist ein Testkonto.
Konto ist ein von Snowflake verwaltetes Konto.
Bemerkung
Anbieter können Protokolleinträge und freigegebene Ereignisse nur für die Region sammeln, in der der Verbraucher die App installiert hat. Daher müssen Anbieter in jeder Region, in der Verbraucher die Ereignisfreigabe für eine App konfigurieren, ein Ereignisakonto zum Speichern freigegebener Ereignisse einrichten.
Um ein Konto als Ereigniskonto für eine Region einzustellen, rufen Sie die SYSTEM$SET_EVENT_SHARING_ACCOUNT_FOR_REGION-Systemfunktion auf, wie im folgenden Beispiel gezeigt:
SELECT SYSTEM$SET_EVENT_SHARING_ACCOUNT_FOR_REGION('<snowflake_region>', '<region_group>', '<account_name>')
Wobei:
snowflake_regionGibt den Namen der Region an, in der sich das Konto befindet, z. B.
AWS_US_WEST_2, AWS_US_EAST_1region_groupGibt die Regionsgruppe an, z. B.
PUBLIC. Weitere Informationen dazu finden Sie unter Regionsgruppen.account_nameGibt den Kontonamen an. Wenn in der angegebenen Region bereits ein anderes Konto als Ereigniskonto eingerichtet ist, wird bei Ausführung dieses Befehls das hier angegebene Konto zum neuen Ereigniskonto.
Ereignistabelle im Ereigniskonto erstellen¶
Um eine Ereignistabelle zu erstellen, führen Sie den CREATE EVENT TABLE-Befehl aus, wie im folgenden Beispiel gezeigt:
CREATE EVENT TABLE event_db.event_schema.my_event_table;
Dieser Befehl die Datenbank und das Schema angibt, die die Ereignistabelle enthalten.
Legen Sie die Ereignistabelle als aktive Ereignistabelle fest¶
Ein Konto kann mehrere Ereignistabellen haben, aber es kann immer nur eine als aktive Ereignistabelle in einem Snowflake-Konto eingestellt werden. Ohne eine aktive Ereignistabelle werden die Meldungen und Ereignisse, die der Verbraucher teilt, verworfen.
Nachdem Sie die Tabelle der Ereignisse erstellt haben, verwenden Sie ALTER ACCOUNT … SET EVENT_TABLE, um festzulegen, dass die Ereignistabelle die aktive Tabelle für das Konto ist:
ALTER ACCOUNT SET EVENT_TABLE=event_db.event_schema.my_event_table;
Ein Konto als Ereigniskonto zurücksetzen¶
Um ein Konto als Ereigniskonto für eine Region zurückzusetzen, rufen Sie die SYSTEM$UNSET_EVENT_SHARING_ACCOUNT_FOR_REGION-Systemfunktion auf:
SELECT SYSTEM$UNSET_EVENT_SHARING_ACCOUNT_FOR_REGION('<snowflake_region>', '<region_group>', '<account_name>')
Wobei:
snowflake_regionGibt den Namen der Region an, in der sich das Konto befindet, z. B.
AWS_US_WEST_2region_groupGibt die Regionsgruppe an, z. B.
PUBLIC.account_nameGibt den Kontonamen an.
Zeigen Sie die Ereigniskonten in einer Organisation an¶
Um Ereigniskonten in der Organisation eines Anbieters anzuzeigen, rufen Sie die SYSTEM$SHOW_EVENT_SHARING_ACCOUNTS-Systemfunktion auf:
SELECT SYSTEM$SHOW_EVENT_SHARING_ACCOUNTS()
Bemerkung
Zum Aufrufen dieser Funktion müssen Sie die Rolle ORGADMIN verwenden.
Diese Systemfunktion gibt eine Zeichenfolge im JSON-Format zurück, die eine Liste der in der Organisation vorhandenen Ereigniskonten enthält. Da die Metadaten einige Zeit brauchen, um sich in alle Regionen zu verbreiten, kann es bei dieser Funktion zu einer kurzen Verzögerung kommen, bevor das aktuellste Konto für Ereignisse angezeigt wird, nachdem der Benutzer das Konto für die Organisation eingestellt oder zurückgesetzt hat.
In einem Anwendungspaket definierte Werte für Protokolliergrad und Ablaufverfolgungsereignis-Ebene anzeigen¶
Verwenden Sie den SHOW VERSIONS-Befehl, um den Protokolliergrad der in einem Anwendungspaket definierten Versionen einer Anwendung anzuzeigen, wie im folgenden Beispiel gezeigt:
SHOW VERSIONS
IN APPLICATION PACKAGE HelloSnowflake;
In Ereignistabelle gespeicherte Protokolleinträge und Ereignisse anzeigen¶
Um die in der Ereignistabelle gespeicherten Protokolleinträge und Ereignisse anzuzeigen, verwenden Sie den Befehl SELECT wie im folgenden Beispiel gezeigt:
SELECT * FROM EVENT_DB.EVENT_SCHEMA.MY_EVENT_TABLE
Weitere Informationen zur Abfrage der Ereignistabelle finden Sie im Folgenden:
Unter Spalten von Ereignistabellen finden Sie Informationen zu den Spalten der Ereignistabelle.