snow spcサービスイベント¶

注釈

Snowpark Container Servicesを使用するために必要な権限を持っている場合にのみ、Snowflake CLI からSnowpark Container Servicesを使用できます。

サービスコンテナーのプラットフォームイベントを取得します。

構文¶

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

引数¶

name: サービスの識別子。例：my_service

オプション¶

--container-name TEXT: コンテナの名前。
--instance-id TEXT: 0から始まるサービスインスタンスの ID。
--since TEXT: Fetch events that are newer than this time ago, in Snowflake interval syntax.
--until TEXT: Fetch events that are older than this time ago, in Snowflake interval syntax.
--first INTEGER: 最初のNのイベントのみを取得します。--lastでは使用できません。
--last INTEGER: 直近のNのイベントのみを取得します。--firstでは使用できません。
--all: すべての列を取得します。デフォルト: false。
--connection, -c, --environment TEXT: config.toml ファイルで定義されている接続の名前。デフォルト: デフォルト
--host TEXT: 接続用のホストアドレス。接続に指定された値を上書きします。
--port INTEGER: 接続のポート。接続に指定された値を上書きします。
--account, --accountname TEXT: Snowflakeアカウントに割り当てられた名前。接続に指定された値を上書きします。
--user, --username TEXT: Snowflakeに接続するユーザー名。接続に指定された値を上書きします。
--password TEXT: Snowflakeのパスワード。接続に指定された値を上書きします。
--authenticator TEXT: Snowflakeの認証コード。接続に指定された値を上書きします。
--private-key-file, --private-key-path TEXT: Snowflake プライベートキーファイルへのパス。接続に指定された値を上書きします。
--token-file-path TEXT: Path to file with an OAuth token that should be used when connecting to Snowflake.
--database, --dbname TEXT: 使用するデータベース。接続に指定された値を上書きします。
--schema, --schemaname TEXT: 使用するデータベーススキーマ。接続に指定された値を上書きします。
--role, --rolename TEXT: 使用するロール。接続に指定された値を上書きします。
--warehouse TEXT: 使用するウェアハウス名。接続に指定された値を上書きします。
--temporary-connection, -x: config で定義された接続ではなく、コマンドラインパラメーターで定義された接続を使用します。デフォルト: false。
--mfa-passcode TEXT: 多要素認証（MFA）に使用するトークン。
--enable-diag: Pythonコネクター診断テストを実行します。デフォルト: false。
--diag-log-path TEXT: 診断レポートパス。デフォルト: <temporary_directory>
--diag-allowlist-path TEXT: オプションの許可リストへの診断レポートパス。
--format [TABLE|JSON]: 出力形式を指定します。デフォルト: TABLE
--verbose, -v: ログレベル info 以上のログエントリを表示します。デフォルト: false。
--debug: ログレベル debug 以上のログエントリを表示します。デバッグログには追加情報が含まれます。デフォルト: false。
--silent: コンソールへの中間出力をオフにします。デフォルト: false。

--help: このコマンドのヘルプテキストを表示します。

使用上の注意¶

注釈

このコマンドを使用するには、 config.toml ファイルで enable_spcs_service_events 機能を有効にする必要があります。

[cli.features]
enable_spcs_service_events = true

以下のパラメーターが必要です。
- name
- --container-name <name>
- --instance-id <ID>
--since と --until の時間ベースのフィルターを使用すると、指定した期間のイベントを返すことができます。1h (時間) や 2d (日) のように、相対時間として時間を指定することができます。
--first と --last オプションを使用すると、指定した数のイベントのみを返すことができます。これらのオプションは互いに排他的であることに注意してください。

例¶

特定のサービスのすべてのイベントを取得します。
```
snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0
```

特定のサービスのイベントのサブセットを取得します。

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

過去5分より新しいイベントを取得します。

snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --since '5 minutes'

1時間以上前のイベントを取得します。

snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --until '1 hour'

すべての列が表示されているすべてのイベントを取得します。

snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --all --last 1

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

JSON 出力用にフォーマットされたイベントを取得します。

snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --last 1 --format json

[
     {
         "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}"
     }
 ]