snow spcs service events

Bemerkung

Sie können die Snowpark Container Services nur dann über Snowflake CLI verwenden, wenn Sie über die erforderlichen Berechtigungen zur Nutzung der Snowpark Container Services verfügen.

Rufen Sie Plattformereignisse für einen Dienst-Container ab.

Syntax

snow spcs service events
  <name>
  --container-name <container_name>
  --instance-id <instance_id>
  --since <since>
  --until <until>
  --first <first>
  --last <last>
  --all
  --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
Copy

Argumente

name

Bezeichner des Dienstes, zum Beispiel: my_service.

Optionen

--container-name TEXT

Name des Containers.

--instance-id TEXT

ID der Dienstinstanz, beginnend mit 0.

--since TEXT

Rufen Sie Ereignisse, die nach diesem Zeitpunkt aufgetreten sind, in der Snowflake-Intervall-Syntax ab.

--until TEXT

Rufen Sie Ereignisse, die vor diesem Zeitpunkt eingetreten sind, in der Snowflake-Intervall-Syntax ab.

--first INTEGER

Rufen Sie nur die ersten N-Ereignisse ab. Kann nicht mit –last verwendet werden.

--last INTEGER

Rufen Sie nur die letzten N-Ereignisse ab. Kann nicht mit –first verwendet werden.

--all

Rufen Sie alle Spalten ab. Standard: false

--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 zu der Datei, die das OAuth-Token enthält, 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

Um diesen Befehl zu verwenden, müssen Sie das Feature enable_spcs_service_events in Ihrer config.toml-Datei aktivieren, wie gezeigt:

[cli.features]
enable_spcs_service_events = true
Copy
  • Die folgenden Parameter sind erforderlich:

    • name

    • --container-name <name>

    • --instance-id <ID>

  • Sie können die zeitbasierten Filter --since und --until verwenden, um Ereignisse für einen bestimmten Zeitraum zurückzugeben. Sie können die Zeit als relative Zeit angeben, wie 1h (Stunde) oder 2d (Tage).

  • Sie können die Optionen --first und --last verwenden, um nur eine bestimmte Anzahl von Ereignissen zurückzugeben. Beachten Sie, dass sich diese Optionen gegenseitig ausschließen.

Beispiele

  • Rufen Sie alle Ereignisse für einen bestimmten Dienst ab:

    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0
    
    Copy
  • Rufen Sie eine Teilmenge der Ereignisse für einen bestimmten Dienst ab:

    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --first 5
    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --last 5
    
    Copy
  • Rufen Sie Ereignisse ab, die neuer sind als die letzten fünf Minuten:

    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --since '5 minutes'
    
    Copy
  • Rufen Sie Ereignisse ab, die älter als eine Stunde sind:

    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --until '1 hour'
    
    Copy
  • Rufen Sie alle Ereignisse mit allen angezeigten Spalten ab:

    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --all --last 1
    
    Copy
    TIMESTAMP | DATABASE NAME | SCHEMA NAME | SERVICE NAME | INSTANCE NAME | CONTAINER NAME | SEVERITY | EVENT NAME | EVENT VALUE
    -- | -- | -- | -- | -- | -- | -- | -- | --
    2024-12-13 10:01:52.808692 | TESTDB | PUBLIC | LOG_EVENT | 0 | log-printer | INFO | CONTAINER.STATUS_CHANGE | { "message": "Running", "status": "READY" }
    2024-12-14 22:27:25.420489 | TESTDB | PUBLIC | LOG_EVENT | 0 | log-printer | INFO | CONTAINER.STATUS_CHANGE | { "message": "Running", "status": "READY" }
    
  • Rufen Sie Ereignisse ab, die für JSON-Ausgabe formatiert sind:

    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --last 1 --format json
    
    Copy
    [
         {
             "TIMESTAMP": "2024-12-14T22:27:25.420489",
             "DATABASE NAME": "TESTDB",
             "SCHEMA NAME": "PUBLIC",
             "SERVICE NAME": "LOG_EVENT",
             "INSTANCE NAME": "0",
             "CONTAINER NAME": "log-printer",
             "SEVERITY": "INFO",
             "EVENT NAME": "CONTAINER.STATUS_CHANGE",
             "EVENT VALUE": "{\n  \"message\": \"Running\",\n  \"status\": \"READY\"\n}"
         }
     ]