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>
  --oauth-client-id <oauth_client_id>
  --oauth-client-secret <oauth_client_secret>
  --oauth-authorization-url <oauth_authorization_url>
  --oauth-token-request-url <oauth_token_request_url>
  --oauth-redirect-uri <oauth_redirect_uri>
  --oauth-scope <oauth_scope>
  --oauth-disable-pkce
  --oauth-enable-refresh-tokens
  --oauth-enable-single-use-refresh-tokens
  --client-store-temporary-credential
  --format <format>
  --verbose
  --debug
  --silent
  --enhanced-exit-codes
Copy

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, mit der gearbeitet werden soll, wenn definition_version 2 oder höher ist.

--app-entity-id TEXT

Die ID der Anwendungsentität, mit der gearbeitet werden soll, wenn die definition_version 2 oder höher ist.

-p, --project TEXT

Pfad, unter dem das Snowflake-Projekt gespeichert ist. Standardmäßig wird das aktuelle Verzeichnis als Arbeitsverzeichnis verwendet.

--env TEXT

Zeichenfolge im Format Schlüssel=Wert. Überschreibt die Variablen aus dem Abschnitt env, 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

Ob ein Verbindungsdiagnosebericht erstellt werden soll. Standard: false

--diag-log-path TEXT

Pfad für den generierten Bericht. Standardmäßig wird das temporäre Verzeichnis des Systems verwendet. Standard: <system_temporary_directory>.

--diag-allowlist-path TEXT

Pfad zu einer JSON-Datei, die allowlist-Parameter enthält.

--oauth-client-id TEXT

Wert der Client-ID, die vom Identitätsanbieter für die Snowflake-Integration bereitgestellt wird.

--oauth-client-secret TEXT

Wert des Client-Geheimnisses, das vom Identitätsanbieter für die Snowflake-Integration bereitgestellt wird.

--oauth-authorization-url TEXT

Endpunkt des Identitätsanbieters, der den Autorisierungscode an den Treiber liefert.

--oauth-token-request-url TEXT

Endpunkt des Identitätsanbieters, der die Zugriffstoken für den Treiber bereitstellt.

--oauth-redirect-uri TEXT

Für die Umleitung des Autorisierungscodes zu verwendende URI.

--oauth-scope TEXT

Bereich, der in der Autorisierungsanfrage des Identitätsanbieters angefordert wird.

--oauth-disable-pkce

Deaktiviert den Proof Key For Code Exchange (PKCE). Standard: False.

--oauth-enable-refresh-tokens

Ermöglicht eine stille Neuauthentifizierung, wenn das aktuelle Zugriffstoken veraltet ist. Standard: False.

--oauth-enable-single-use-refresh-tokens

Ob Sie sich für die Semantik des einmaligen Aktualisierungs-Tokens entscheiden. Standard: False.

--client-store-temporary-credential

Speichern der temporären Anmeldeinformationen.

--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

--enhanced-exit-codes

Exit-Fehlercodes nach Art des Fehlers unterscheiden. 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
    
    Copy
  • 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
    
    Copy
  • Abrufen von Ereignissen für eine Verbraucherinstallation.

    snow app events --consumer-org <organization-name> --consumer-account <account-name>
    
    Copy
  • 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
    
    Copy
  • Abrufen von Ereignissen als JSON.

    snow app events --format json
    
    Copy