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

パラメーター

name

マウントされた量のリストを表示するサービスの名前を指定します。

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

出力

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

列

説明

volume_name

量の名前

instance_id

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

container_name

量がマウントされているコンテナの名前。

volume_type

量のタイプ。これは、次のいずれかになります。

  • block

  • stage

  • local

  • memory

量タイプの詳細な説明については、 サービス仕様 をご参照ください。

size

numberGi の形式のボリュームのサイズ

iops

ブロック量にのみ適用されます。各ブロック量の1秒あたりの構成済み入出力操作を表示します。

throughput

ブロック量にのみ適用されます。各ブロック量に設定されたスループットを表示します。

encryption

ステージおよびブロック量にのみ適用されます。ブロック量の場合は、構成された量暗号化タイプを示します。ブロック量の暗号化タイプの詳細な説明については、 ブロックストレージ量の暗号化サポート をご参照ください。ステージ量の場合は、基礎となるステージの暗号化タイプを示します。ステージ暗号化情報を取得するには、呼び出し元のステージに対する USAGE または OWNERSHIP 権限が必要です。

snapshot_used

ブロック量にのみ適用されます。量の作成に使用されたスナップショットを表示します。スナップショットに対する USAGE または OWNERSHIP 権限が付与されたロールを使用している場合にのみ、スナップショットがこの列にリストされます。

stage_source

ステージ量にのみ適用されます。ステージ量に使用されるステージの完全修飾名を表示します。

volume_mounts

Comma-separated list of paths where the volume is mounted in the given container.

フィールドが特定の量タイプに適用可能な場合、他のすべての量タイプの場合はそのフィールドに NULL が入力されます。

アクセス制御の要件

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

権限

オブジェクト

メモ

OWNERSHIP または MONITOR

サービス

なし

OWNERSHIP または USAGE

スナップショット

ブロックストレージスナップショットにアクセスできない場合、Snowflakeは snapshot_used フィールドに認証エラーを入力しますが、コマンドは失敗しません。

OWNERSHIP または USAGE

ステージ

Without access to a stage, Snowflake populates the encryption field with an authorization error for stage volumes, but the command doesn't fail.

スキーマ内のオブジェクトを操作するには、親データベースの少なくとも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;
Copy

サンプル出力:

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