SHOW SERVICE INSTANCES IN SERVICE

サービス のインスタンスを一覧表示します。

コマンド出力は、個々のサービス・インスタンスのステータスを表示することで、自動スケーリングとローリング・アップグレードの可視性を提供します。

こちらもご参照ください。

Snowpark Container Servicesの概要、 CREATE SERVICE、 SHOW SERVICES、 SHOW SERVICE CONTAINERS IN SERVICE

構文

SHOW SERVICE INSTANCES IN SERVICE <name>
Copy

パラメーター

name

インスタンスを一覧表示するサービスの識別子を指定します。

特殊文字や大文字小文字を区別するための引用符付きの名前はサポートされていません。

出力

コマンド出力では、次の列にサービスインスタンスのプロパティとメタデータが提供されます。

列

説明

database_name

サービスが作成されるデータベース。

schema_name

サービスが作成されるスキーマ。

service_name

サービスの名前。

service_status

サービスの現在のステータスを示す以下の値のいずれか：

  • PENDING

  • RUNNING

  • FAILED

  • DONE

  • SUSPENDING

  • SUSPENDED

  • DELETING

  • DELETED

  • INTERNAL_ERROR

この列の値は、 DESCRIBE SERVICE の出力の status 列と同じである点に注意してください。

instance_id

サービスインスタンスの ID（これは0から始まるサービスインスタンスのインデックスです）。

status

サービスインスタンスの現在のステータスを示す以下の値のいずれか。

  • PENDING: サービスインスタンスは現在デプロイ中で、まだリクエストに応答できる状態になっていません。

  • READY: サービスインスタンス内のすべてのコンテナーが準備完了。さ＾ビスインスタンスはリクエストに応答する準備が整っています。

  • FAILED: サービスインスタンス内の少なくとも1つのコンテナーが失敗して終了しました。

  • TERMINATING: サービスインスタンスは終了処理中であり、処理完了後に削除されます。

  • SUCCEEDED: サービスはジョブサービスであり、サービスインスタンス内のすべてのコンテナが正常に終了しました。

spec_digest

サービス仕様の内容を表す一意かつ不変の識別子。

creation_time

Snowflakeがサービスインスタンスの作成を開始した時刻。

start_time

サービスインスタンスがノード上で実行されているとSnowflakeが認識した時間。

ip_address

サービスインスタンスの IP アドレス。同じサービス（または他のサービス）の他のインスタンスは、この IP アドレスを使用して特定のサービスインスタンスに接続できます。

複数のサービスインスタンスを実行している場合、 instance_id 0のインスタンスをリーダーとして選出することで、サービスのインスタンス間でリーダー選出を実装できます。

アクセス制御の要件

この操作の実行に使用される ロール には、少なくとも次の 権限 が必要です。

権限

オブジェクト

注意

これらの権限のいずれか1つ: OWNERSHIP、または MONITOR

サービス

スキーマ内のオブジェクトに対して操作を実行するには、親データベースとスキーマに対する USAGE 権限が必要です。スキーマに対する 任意の権限を付与されたロールは、そのロールがスキーマを解決できることに注意してください。たとえば、スキーマに対するCREATE権限を付与されたロールは、そのスキーマにオブジェクトを作成できますが、そのスキーマに対するUSAGE*も*付与されている必要はありません。

指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。

セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。

使用上の注意

  • このコマンドの実行には、稼働中のウェアハウスは必要ありません。

  • このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。

  • MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者（ ACCOUNTADMIN ロールを持つユーザー）とセキュリティ管理者（ SECURITYADMIN ロールを持つユーザー）のみが MANAGE GRANTS 権限を持っています。

  • このコマンドの出力を後処理するには、 パイプ演算子 （->>）または RESULT_SCAN 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。

    For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

    When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

    You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

  • コマンドは、コマンドを実行するために使用されるロールのアクセス権限によって決定された通り、指定されたオブジェクトタイプに対して 最大 1万件の記録を返します。1万件を超える記録は、フィルターを適用しても返されません。

    1万件を超える記録が存在する結果を表示するには、 Snowflake Information Schema で対応するビュー（存在する場合）をクエリします。

例

次の例は、セッションの現在のデータベースとスキーマの echo_service サービスのインスタンスを一覧表示しています。

SHOW SERVICE INSTANCES IN SERVICE echo_service;
Copy

サンプル出力:

+---------------+-------------+--------------+----------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------+------------+
| database_name | schema_name | service_name | service_status | instance_id | status | spec_digest                                                      | creation_time        | start_time           | ip_address |
|---------------+-------------+--------------+----------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------+------------|
| TUTORIAL_DB   | DATA_SCHEMA | ECHO_SERVICE | RUNNING        | 0           | READY  | 2831c241b8d64104fbc562d60764d7abd28602c70b6a8357341e8c8210b79da4 | 2025-04-25T06:01:32Z | 2025-04-25T06:01:32Z | 10.244.0.9 |
+---------------+-------------+--------------+----------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------+------------+
言語: 日本語