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
Copy

引数

name

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

オプション

--container-name TEXT

コンテナの名前。

--instance-id TEXT

0から始まるサービスインスタンスの ID。

--since TEXT

この時間以降に発生したイベントを、Snowflakeのインターバル構文で取得します。

--until TEXT

Snowflakeのインターバル構文で、この時間より前に発生したイベントを取得します。

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

Snowflake への接続時に使用する OAuth トークンを含むファイルへのパス。

--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
Copy
  • 以下のパラメーターが必要です。

    • 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
    
    Copy
  • 特定のサービスのイベントのサブセットを取得します。

    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
  • 過去5分より新しいイベントを取得します。

    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --since '5 minutes'
    
    Copy
  • 1時間以上前のイベントを取得します。

    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --until '1 hour'
    
    Copy
  • すべての列が表示されているすべてのイベントを取得します。

    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" }
    
  • JSON 出力用にフォーマットされたイベントを取得します。

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