SHOW ENTITIES IN DCM PROJECT

指定された:doc:`DCMプロジェクト</user-guide/dcm-projects/dcm-projects-overview>`によって現在管理されているすべてのSnowflakeオブジェクトを表示します。

すべてのオブジェクトの完全修飾名の混合リストを提供します。結果を表示するには、ユーザーに、|dcm-object|に対するREAD権限と、管理オブジェクト自体に対するREAD権限の両方が必要です。

注釈

結果は必ずしも最新のデプロイメントのエンティティと一致するとは限りません。手動でドロップされたオブジェクト、またはプロジェクトから切り離されたオブジェクトは、このリストには表示されません。

コマンドは、作成日順にオブジェクトメタデータとプロパティを返します。

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

CREATE DCM PROJECT、ALTER DCM PROJECT、DESCRIBE DCM PROJECT、DROP DCM PROJECT、EXECUTE DCM PROJECT、SHOW DCM PROJECTS

構文

SHOW ENTITIES IN DCM PROJECT <name> [ LIMIT <rows> ]

SHOW ENTITIES LIKE <pattern> IN DCM PROJECT <name>;

SHOW ENTITIES IN DCM PROJECT <name> STARTS WITH <prefix>;

SHOW ENTITIES IN DCM PROJECT <name> LIMIT <n> FROM <cursor>;

必須パラメーター

IN DCM PROJECT name

一覧表示するデプロイメントを含むDCMプロジェクトの識別子を指定します。

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

詳細については、 識別子の要件 をご参照ください。

オプションのパラメーター

LIMIT rows

オプションで、返される行の最大数を制限します。実際に返される行数は、指定された制限より少ない場合があります。例えば、既存のオブジェクトの数が指定された制限より少ないなどです。

デフォルト: 値なし（出力に制限は非適用）。

LIKE 'pattern'

オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字（% および _）をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。

たとえば、次のパターンは 同じ 結果を返します。

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. デフォルト: 値なし（フィルタリングは出力に非適用）。

STARTS WITH 'name_string'

オプションで、オブジェクト名の先頭に表示される文字に基づいてコマンド出力をフィルタリングします。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。

たとえば、次の文字列は 異なる 結果を返します。

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...

. デフォルト: 値なし（フィルターは出力に適用されない）

LIMIT rows [ FROM 'name_string' ]

オプションで、返される行の最大数を制限すると同時に、結果の「ページネーション」を有効にします。実際に返される行数は、指定された制限より少ない場合があります。例えば、既存のオブジェクトの数が指定された制限より少ないなどです。

オプションの FROM 'name_string' サブ句は、結果の「カーソル」として効果的に機能します。これにより、指定された文字列と一致するオブジェクト名を持つ最初の行に続く指定された行数を取得できます。

  • 文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。

  • 文字列に完全なオブジェクト名を含める必要はありません。部分的な名前がサポートされています。

デフォルト：値なし（出力に制限は適用されない）

注釈

FROM 'name_string' 句と STARTS WITH 'name_string' 句の両方をサポートする SHOW コマンドの場合、同じステートメントでこれらの両方の句を組み合わせることができます。ただし、両方の条件を満たしている必要があります。そうでない場合、互いにキャンセルされ、結果が返されません。

さらに、オブジェクトは名前の辞書式順序で返されるため、 FROM 'name_string' は、 STARTS WITH 'name_string' によって返される行よりも辞書式の値が大きい行のみを返します。

例:

  • ... STARTS WITH 'A' LIMIT ... FROM 'B' は結果を返しません。

  • ... STARTS WITH 'B' LIMIT ... FROM 'A' は結果を返しません。

  • ... STARTS WITH 'A' LIMIT ... FROM 'AB' は結果を返します（入力文字列に一致する行がある場合）。

出力

列

説明

:codenowrap：CREATED_ON

作成タイムスタンプ（LTZ）

:codenowrap：NAME

オブジェクトの完全修飾名（FQN）、DESC向き

:codenowrap：OBJECT_TYPE

オブジェクト型

:codenowrap：OWNER

所有ロール、ドメインごとの規則

:codenowrap：COMMENT

ユーザー指定のコメント

アクセス制御の要件

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

権限

オブジェクト

READ

  • DCM project

  • 管理オブジェクト

スキーマ内のオブジェクトを操作するには、親データベースの少なくとも1つの権限と、親スキーマの少なくとも1つの権限が必要です。

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

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

例

my_project DCMプロジェクト内のすべてのエンティティを表示

SHOW ENTITIES IN DCM PROJECT my_project;

my_project DCMプロジェクト内の``my_``で始まるすべてのエンティティを表示

SHOW ENTITIES LIKE 'my_%' IN DCM PROJECT my_project;

my_project DCMプロジェクト内のすべての動的テーブルを表示

SHOW ENTITIES IN DCM PROJECT my_project
  ->> SELECT * FROM $1 WHERE "object_type" = 'DYNAMIC_TABLE';