DESCRIBE ICEBERG TABLE¶

Icebergテーブルの列、またはIcebergテーブルのプロパティの現在の値とデフォルト値を説明します。

DESCRIBE は DESCに短縮できます。

このトピックでは、 Iceberg tables と指定することで混乱を避ける場合を除き、Icebergテーブルを単に「テーブル」と呼ぶことに注意してください。

こちらもご参照ください。: ALTER ICEBERG TABLE、 DROP ICEBERG TABLE、 CREATE ICEBERG TABLE、 SHOW ICEBERG TABLES

構文¶

DESC[RIBE] [ ICEBERG ] TABLE <name> [ TYPE =  { COLUMNS | STAGE } ]

Copy

パラメーター¶

name

記述するテーブルの識別子を指定します。識別子にスペースまたは特殊文字が含まれる場合、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

TYPE = COLUMNS | STAGE

テーブルの列を表示するか、テーブルのステージプロパティ（現在の値とデフォルト値を含む）を表示するかを指定します。

デフォルト： TYPE = COLUMNS

アクセス制御の要件¶

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

権限	オブジェクト	メモ
SELECT	Icebergテーブル
USAGE	外部ボリューム
USAGE	統合（カタログ）	Icebergテーブルがカタログ統合を使用する場合は必要です。

スキーマ内の任意のオブジェクトを操作するには、親データベースとスキーマに対する USAGE 権限も必要であることに注意してください。

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

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

使用上の注意¶

このコマンドは、テーブルのオブジェクトパラメーターを表示しません。代わりに、 SHOW PARAMETERS IN TABLE を使用してください。
DESC ICEBERGTABLE、 DESCRIBE TABLE、および DESCRIBE VIEW は交換可能です。いずれかのコマンドが、ステートメントの条件に一致するテーブルまたはビューの詳細を取得します。ただし、ビューにはステージプロパティがないため、 TYPE = STAGE はビューには適用されません。
出力には POLICY NAME 列が含まれ、列に設定されたマスキングポリシーを示します。

列にマスキングポリシーが設定されていない場合、またはSnowflakeアカウントがEnterprise Edition以上でない場合、Snowflakeは NULL を返します。

このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。

例¶

Icebergテーブルの例を作成します。

CREATE OR REPLACE ICEBERG TABLE my_iceberg_table
  CATALOG='my_catalog_integration'
  EXTERNAL_VOLUME='my_ext_volume'
  METADATA_FILE_PATH='path/to/metadata/v2.metadata.json';

Copy

テーブルの列を説明します。

DESC ICEBERG TABLE my_iceberg_table ;

Copy