snow app events¶
Holt Ereignisse für diese Anwendung aus der in Snowflake konfigurierten Ereignistabelle. Standardmäßig ruft dieser Befehl Ereignisse ab, die von einer App erzeugt wurden, die im Konto der aktuellen Verbindung installiert ist. Um Ereignisse abzurufen, die von einer App erzeugt wurden, die in einem Konto für Verbraucher installiert ist, verwenden Sie die Optionen –consumer-org und –consumer-account. Dazu muss die Ereignisfreigabe so eingestellt sein, dass Ereignisse an das Konto des Anbieters weitergeleitet werden: https://docs.snowflake.com/en/developer-guide/native-apps/setting-up-logging-and-events
Syntax¶
snow app events
--since <since>
--until <until>
--type <record_types>
--scope <scopes>
--consumer-org <consumer_org>
--consumer-account <consumer_account>
--consumer-app-hash <consumer_app_hash>
--first <first>
--last <last>
--follow
--follow-interval <follow_interval>
--package-entity-id <package_entity_id>
--app-entity-id <app_entity_id>
--project <project_definition>
--env <env_overrides>
--connection <connection>
--host <host>
--port <port>
--account <account>
--user <user>
--password <password>
--authenticator <authenticator>
--private-key-file <private_key_file>
--token-file-path <token_file_path>
--database <database>
--schema <schema>
--role <role>
--warehouse <warehouse>
--temporary-connection
--mfa-passcode <mfa_passcode>
--enable-diag
--diag-log-path <diag_log_path>
--diag-allowlist-path <diag_allowlist_path>
--format <format>
--verbose
--debug
--silent
Argumente¶
Keine
Optionen¶
--since TEXT
Abrufen von Ereignissen, die neuer sind als dieser Zeitpunkt, in der Snowflake Intervall Syntax.
--until TEXT
Abrufen von Ereignissen, die älter als diese Zeit sind, in der Snowflake Intervall Syntax.
--type [log |span| span_event]
Schränken Sie die Ergebnisse auf einen bestimmten Datensatztyp ein. Kann mehrfach angegeben werden. Standard: [].
--scope TEXT
Schränken Sie die Ergebnisse auf einen bestimmten Bereich ein. Kann mehrfach angegeben werden. Standard: [].
--consumer-org TEXT
Der Name der Verbraucherorganisation.
--consumer-account TEXT
Der Name des Verbraucherkontos in der Organisation.
--consumer-app-hash TEXT
Der SHA-1 Hashwert für den Namen der Verbraucheranwendung.
--first INTEGER
Rufen Sie nur die ersten N-Ereignisse ab. Kann nicht mit –last verwendet werden. Standard: -1
--last INTEGER
Rufen Sie nur die letzten N-Ereignisse ab. Kann nicht mit –first verwendet werden. Standard: -1
--follow, -f
Setzen Sie das Abrufen von Ereignissen fort. Impliziert –last 20, sofern nicht überschrieben oder das Flag –since verwendet wird. Standard: false
--follow-interval INTEGER
Abrufintervall in Sekunden, wenn Sie das Flag –follow verwenden. Standard: 10
--package-entity-id TEXT
Die ID der Paketentität, auf der die Operation ausgeführt werden soll, wenn definition_version 2 oder höher ist.
--app-entity-id TEXT
Die ID der Anwendungsentität, auf der die Operation ausgeführt werden soll, wenn definition_version 2 oder höher ist.
-p, --project TEXT
Pfad, in dem sich das Snowflake-Projekt befindet. Standardmäßig wird das aktuelle Verzeichnis verwendet.
--env TEXT
Zeichenfolge im Format von Schlüssel=Wert. Überschreibt Variablen aus dem env-Abschnitt, die für Vorlagen verwendet werden. Standard: [].
--connection, -c, --environment TEXT
Name der Verbindung, wie in Ihrer
config.toml
-Datei definiert. Standard:Standard
.--host TEXT
Host-Adresse für die Verbindung. Überschreibt den für die Verbindung angegebenen Wert.
--port INTEGER
Port für die Verbindung. Überschreibt den für die Verbindung angegebenen Wert.
--account, --accountname TEXT
Name, der Ihrem Snowflake-Konto zugewiesen wurde. Überschreibt den für die Verbindung angegebenen Wert.
--user, --username TEXT
Benutzername für die Verbindung zu Snowflake. Überschreibt den für die Verbindung angegebenen Wert.
--password TEXT
Snowflake-Kennwort. Überschreibt den für die Verbindung angegebenen Wert.
--authenticator TEXT
Snowflake-Authentifikator. Überschreibt den für die Verbindung angegebenen Wert.
--private-key-file, --private-key-path TEXT
Dateipfad zum privaten Snowflake-Schlüssel. Überschreibt den für die Verbindung angegebenen Wert.
--token-file-path TEXT
Pfad zur Datei mit einem OAuth-Token, das bei der Verbindung mit Snowflake verwendet werden soll.
--database, --dbname TEXT
Zu verwendende Datenbank. Überschreibt den für die Verbindung angegebenen Wert.
--schema, --schemaname TEXT
Zu verwendendes Datenbankschema. Überschreibt den für die Verbindung angegebenen Wert.
--role, --rolename TEXT
Zu verwendende Rolle. Überschreibt den für die Verbindung angegebenen Wert.
--warehouse TEXT
Zu verwendendes Warehouse. Überschreibt den für die Verbindung angegebenen Wert.
--temporary-connection, -x
Verwendet eine mit Befehlszeilenparametern definierte Verbindung anstelle einer in config definierten. Standard: false
--mfa-passcode TEXT
Für die mehrstufige Authentifizierung (MFA) zu verwendendes Token.
--enable-diag
Führt den Python-Konnektor-Diagnosetest aus. Standard: false
--diag-log-path TEXT
Pfad des Diagnoseberichts. Standard: <temporary_directory>.
--diag-allowlist-path TEXT
Pfad des Diagnoseberichts zur optionalen Zulassungsliste.
--format [TABLE|JSON]
Gibt das Ausgabeformat an. Standard: TABLE.
--verbose, -v
Zeigt Protokolleinträge für die Protokolliergrade
info
und höher an. Standard: false--debug
Zeigt Protokolleinträge für die Protokollebenen
debug
und höher an; Debug-Protokolle enthalten zusätzliche Informationen. Standard: false--silent
Schaltet Zwischenausgaben auf der Konsole aus. Standard: false
--help
Zeigt den Hilfetext für diesen Befehl an.
Nutzungshinweise¶
Bemerkung
Bevor Sie diesen Befehl verwenden, müssen Sie die Behandlung von Ereignissen für das Snowflake-Konto des Anbieters einstellen. Weitere Informationen dazu finden Sie unter Protokollierung, Ablaufverfolgung und Metriken.
Der snow app events
-Befehl ruft Ereignisse ab, die von einer installierten nativen Anwendung erzeugt wurden, die im Konto der aktuellen Verbindung installiert ist.
Mit diesem Befehl werden standardmäßig Ereignisse abgerufen, die von einem im Konto der aktuellen Verbindung installierten Snowflake Native App erzeugt wurden. Um Ereignisse abzurufen, die von einem in einem Konto installierten Snowflake Native App erstellt wurden, verwenden Sie die Optionen --consumer-org
und --consumer-account
. Diese Optionen setzen voraus, dass die Ereignisfreigabe so eingestellt ist, dass die Ereignisse an das Konto des Anbieters weitergeleitet werden.
Beispiele¶
Ruft alle Ereignisse für eine Anwendung ab, die im Konto des Anbieters installiert ist.
snow app events
Ruft eine Teilmenge von Ereignissen für eine Anwendung ab, die im Konto des Anbieters installiert ist.
# Limiting the number of events snow app events --first 10 snow app events --last 10 # Narrowing the time range using interval syntax snow app events --since '5 minutes' snow app events --until '1 hour' # Filtering events snow app events --type log snow app events --scope com.myapp.MyClass1 --scope com.myapp.MyClass2
Abrufen von Ereignissen für eine Verbraucherinstallation.
snow app events --consumer-org <organization-name> --consumer-account <account-name>
Abrufen von Ereignissen für eine Verbraucheranwendung unter Verwendung des Hashwerts des Anwendungsnamens.
snow app events --consumer-org <organization-name> --consumer-account <account-name> --consumer-app-hash cafc10bf6a5deb574ada0e3a009b63bbbe9bdb84
Abrufen von Ereignissen als JSON.
snow app events --format json