SHOW SERVICE VOLUMES IN SERVICE¶
サービス のすべてのインスタンスのストレージ量をリストします。出力には、マウントされた各量について、その量をマウントしたすべてのコンテナの行が含まれます。出力は、サービス内の少なくとも1つのコンテナにマウントされた量のみを表示します。指定されているが、どのコンテナでも使用されていない量は含まれていません。
- こちらもご参照ください。
Snowpark Container Servicesの概要、 CREATE SERVICE、 SHOW SERVICES、 SHOW SERVICE INSTANCES IN SERVICE、 SHOW SERVICE CONTAINERS IN SERVICE、 SHOW <オブジェクト>
構文¶
SHOW SERVICE VOLUMES IN SERVICE <name>
パラメーター¶
nameマウントされた量のリストを表示するサービスの名前を指定します。
特殊文字や大文字小文字を区別するための引用符付きの名前はサポートされていません。
出力¶
コマンド出力では、サービス量のプロパティが次の列で提供されます。
列 |
説明 |
|---|---|
|
量の名前 |
|
サービスインスタンスの ID（これは0から始まるサービスインスタンスのインデックスです） |
|
量がマウントされているコンテナの名前。 |
|
量のタイプ。これは、次のいずれかになります。
量タイプの詳細な説明については、 サービス仕様 をご参照ください。 |
|
|
|
ブロック量にのみ適用されます。各ブロック量の1秒あたりの構成済み入出力操作を表示します。 |
|
ブロック量にのみ適用されます。各ブロック量に設定されたスループットを表示します。 |
|
ステージおよびブロック量にのみ適用されます。ブロック量の場合は、構成された量暗号化タイプを示します。ブロック量の暗号化タイプの詳細な説明については、 ブロックストレージ量の暗号化サポート をご参照ください。ステージ量の場合は、基礎となるステージの暗号化タイプを示します。ステージ暗号化情報を取得するには、呼び出し元のステージに対する USAGE または OWNERSHIP 権限が必要です。 |
|
ブロック量にのみ適用されます。量の作成に使用されたスナップショットを表示します。スナップショットに対する USAGE または OWNERSHIP 権限が付与されたロールを使用している場合にのみ、スナップショットがこの列にリストされます。 |
|
ステージ量にのみ適用されます。ステージ量に使用されるステージの完全修飾名を表示します。 |
|
指定されたコンテナに量がマウントされている、パスのコンマ区切りリスト。 |
フィールドが特定の量タイプに適用可能な場合、他のすべての量タイプの場合はそのフィールドに NULL が入力されます。
アクセス制御の要件¶
この操作の実行に使用される ロール には、少なくとも次の 権限 が必要です。
権限 |
オブジェクト |
メモ |
|---|---|---|
OWNERSHIP または MONITOR |
サービス |
なし |
OWNERSHIP または USAGE |
スナップショット |
ブロックストレージスナップショットにアクセスできない場合、Snowflakeは |
権限 OWNERSHIP または USAGE のいずれか |
ステージ |
ステージへのアクセスができない場合、暗号化フィールドにステージ量の認証エラーを入力しますが、コマンドは失敗しません。 |
スキーマ内のオブジェクトを操作するには、親データベースの少なくとも1つの権限と、親スキーマの少なくとも1つの権限が必要です。
指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。
セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。
使用上の注意¶
このコマンドの実行には、稼働中のウェアハウスは必要ありません。
このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。
MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者（ ACCOUNTADMIN ロールを持つユーザー）とセキュリティ管理者（ SECURITYADMIN ロールを持つユーザー）のみが MANAGE GRANTS 権限を持っています。
このコマンドの出力を後処理するには、 パイプ演算子 （
->>）または RESULT_SCAN 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。たとえば、パイプ演算子または RESULT_SCAN 関数を使用して、 SHOW コマンド出力から特定の列を選択したり、行をフィルター処理したりできます。
出力列を参照する場合は、列名に 二重引用符で囲まれた識別子 を使用します。たとえば、出力列
typeを選択するには、SELECT "type"を指定します。SHOW コマンドの出力列名は小文字のため、二重引用符で囲まれた識別子を使用する必要があります。二重引用符により、 SELECT リストまたは WHERE 句内の列名が、スキャンされた SHOW コマンド出力内の列名と一致することが保証されます。
コマンドは、コマンドを実行するために使用されるロールのアクセス権限によって決定された通り、指定されたオブジェクトタイプに対して 最大 1万件の記録を返します。1万件を超える記録は、フィルターを適用しても返されません。
1万件を超える記録が存在する結果を表示するには、 Snowflake Information Schema で対応するビュー（存在する場合）をクエリします。
例¶
次の例は、echo_service サービスの量をリストしています。
SHOW SERVICE VOLUMES IN SERVICE echo_service;
サンプル出力:
+----------------+-------------+----------------+-------------+--------+--------+------------+----------------+---------------+--------------+---------------------------+
| volume_name | instance_id | container_name | volume_type | size | iops | throughput | encryption | snapshot_used | stage_source | volume_mounts |
+----------------+-------------+----------------+-------------+--------+--------+------------+----------------+---------------+--------------+---------------------------+
| block-volume-1 | 0 | main | block | 1Gi | 3000 | 125 | SNOWFLAKE_SSE | [NULL] | [NULL] | /tmp/block1 |
| block-volume-1 | 0 | secondary | block | 1Gi | 3000 | 125 | SNOWFLAKE_SSE | [NULL] | [NULL] | /data/shared |
| block-volume-2 | 0 | main | block | 50Gi | 3500 | 150 | SNOWFLAKE_FULL | [NULL] | [NULL] | /tmp/block2 |
| local-volume | 0 | main | local | [NULL] | [NULL] | [NULL] | [NULL] | [NULL] | [NULL] | /tmp/local |
| memory-volume | 0 | main | memory | 512Mi | [NULL] | [NULL] | [NULL] | [NULL] | [NULL] | /tmp/memory, /tmp/memory2 |
| memory-volume | 0 | secondary | memory | 512Mi | [NULL] | [NULL] | [NULL] | [NULL] | [NULL] | /cache/memory |
+----------------+-------------+----------------+-------------+--------+--------+------------+----------------+---------------+--------------+---------------------------+