DESCRIBE LISTING¶

リスト内の列を説明します。

こちらもご参照ください。: CREATE LISTING、 ALTER LISTING、 SHOW LISTINGS、 SHOW VERSIONS IN LISTING、 DROP LISTING

構文¶

{ DESC | DESCRIBE } LISTING <name>  [ REVISION = { DRAFT | PUBLISHED } ]

Copy

パラメーター¶

name

リストが作成されたときに指定された、説明するリストの識別子。識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

リストの名前を含むリストの詳細は SHOW LISTINGS をご参照ください。

REVISION = { DRAFT | PUBLISHED }

表示するリビジョンを指定します。

たとえば、公開されたリストのドラフトがある場合、ドラフトまたは公開バージョンのいずれかを指定して表示することができます。

有効な値:

DRAFT: リストのドラフトバージョンを説明します。
PUBLISHED: リストの公開バージョンを説明します。

デフォルト:: PUBLISHED

使用上の注意¶

リストに対する USAGE、MODIFY、またはOWNERSHIP 権限を持つロールを使用する場合のみ、リストを説明できます。

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

たとえば、パイプ演算子または RESULT_SCAN 関数を使用して、 SHOW コマンド出力から特定の列を選択したり、行をフィルター処理したりできます。

出力列を参照する場合は、列名に二重引用符で囲まれた識別子を使用します。たとえば、出力列 type を選択するには、 SELECT "type" を指定します。

SHOW コマンドの出力列名は小文字のため、二重引用符で囲まれた識別子を使用する必要があります。二重引用符により、 SELECT リストまたは WHERE 句内の列名が、スキャンされた SHOW コマンド出力内の列名と一致することが保証されます。

出力¶

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

列	説明
`global_name`	リストのグローバル名
`name`	リスト作成時に指定された名前。
`owner`	リスト所有者。
`owner_role_type`	リスト所有者のロールタイプ。
`created_on`	リストが作成された日時。
`updated_on`	リストが最後に更新された日時。
`published_on`	リストが最後に公開された日時。
`title`	リストマニフェストで指定されたタイトル
`subtitle`	リストマニフェストで指定されたサブタイトル
`description`	リストの説明。
`listing_terms`	リストの規約。
`state`	リストの状態。次のいずれか: DRAFT PUBLISHED UNPUBLISHED
`share`	このリストの共有識別子。
`application_package`	リストに関連するアプリケーションパッケージ。
`business_needs`	リストが満たすビジネスニーズ。
`usage_examples`	リストのクエリを示す例。
`data_attributes`	リフレッシュレート、地理的範囲、時間範囲など、リストの属性。
`categories`	リストのカテゴリ。
`resources`	ドキュメントリンクなどのリストリソース。
`profile`	プロバイダーのプロファイル名。
`customized_contact_info`	プロバイダーの連絡先。
`data_dictionary`	リストのメタデータ。
`data_preview`	リストデータのプレビュー。
`comment`	もしあれば、関連コメント。
`revisions`	リビジョンの状態。公開リストのみ。
`target_accounts`	ターゲットアカウントのコンマ区切りリスト。
`regions`	リストのリージョン。
`refresh_schedule`	リストの更新頻度（分単位）。
`refresh_type`	リストの更新タイプ。
`review_state`	リストのレビュー状態。
`rejection_reason`	リストが拒否された理由。
`unpublished_by_admin_reasons`	リスト所有者がリストを公開しなかった理由。
`is_monetized`	収益化フラグ。
`is_application`	アプリケーションフラグ。`true` の場合、アプリケーションパッケージがリストに添付されます。
`is_targeted`	ターゲットフラグ。
`is_limited_trial`	限定トライアルフラグ。
`is_by_request`	リクエストによりフラグ。
`limited_trial_plan`	限定トライアルリストに関連付けられたプラン。
`retired_on`	リストが廃止された日時。廃止されていない場合はNULL。
`scheduled_drop_time`	リストが削除される予定の日時（既存のコンシューマーは利用できなくなります）。スケジュールされていない場合はNull。
`manifest_yaml`	`REVISION` が `PUBLISHED` の場合は公開済みのマニフェスト全体、 `REVISION` が `DRAFT` の場合はドラフトの変更を含む公開済みマニフェスト全体。
`distribution`	`EXTERNAL` など、配布の詳細（存在する場合）。
`is_mountless_queryable`	リストをマウントせずにクエリできる場合は `true`、それ以外の場合は `false`。
`organization_profile_name`	関連付けられた組織プロファイル名。
`uniform_listing_locator`	統一リストロケーター（ULL）。ULLs の詳細については、組織リストを構成するをご参照ください。
`trial_details`	トライアルリストに関連付けられた詳細。
`approver_contact`	承認者連絡先情報。
`support_contact`	サポート連絡先情報。
`live_version_uri`	ステージ操作を実行できる、リストのライブバージョンの完全なユニフォームリソースインジケーター（URI）。リストにライブバージョンが存在しない場合はNULL。
`last_committed_version_uri`	リストの最後にコミットされたバージョンの完全な URI。
`last_committed_version_name`	リストの最後にコミットされたバージョンのシステム生成名。
`last_committed_version_alias`	リストの最後にコミットされたバージョンのユーザー指定のエイリアス。
`published_version_uri`	リストの現在公開されているバージョンの完全な URI。
`published_version_name`	システムが生成したリストの公開バージョン名。
`published_version_alias`	リストの最終に公開されたバージョンのユーザー指定のエイリアス。
`compliance_badges`	このリストに関連付けられているコンプライアンスバッジ（ある場合）。
`is_share`	共有フラグ。`true` の場合、リストは共有に基づいて作成されました。
`monetization_version`	リストが使用する収益化モデル。
`request_approval_type`	リストのアクセスリクエストタイプ。アクセスリクエストタイプは、リストの検出ターゲットがリスト承認者にアクセスリクエストを送信する方法を定義します。次のいずれか。 `NULL` `REQUEST_AND_APPROVE_IN_SNOWFLAKE` は、アクセスリクエストがSnowflake環境内で送信および承認されたことを示します。 `REQUEST_AND_APPROVE_OUTSIDE_SNOWFLAKE` は、プロバイダーがアクセスリクエストの送信と承認を独立して管理することを示します。外部リストの値は常に `NULL` です。
`monetization_display_order`	料金プランとオファーがコンシューマーに表示される順序。
`legacy_uniform_listing_locator`	従来の統一リストロケーター（ULL）。既存の組織リストプロファイルがカスタム組織プロファイルを使用するように更新された場合、この列には、引き続き有効な以前のデフォルトプロファイルに関連付けられている ULL が含まれています。プロファイルの更新が行われていない場合、この列は NULLです。 ULLs の詳細については、統一リストロケーターまたはリスト名のセットをご参照ください。
`share_restrictions`	外部プライベートリストに共有制限があるかどうかを示すフラグ。

例¶

MYLISTING という名前のリストの列を説明するには、次のコマンドを実行します。

DESC LISTING MYLISTING;

Copy