DESCRIBE DCM PROJECT

:doc:`DCMプロジェクト</user-guide/dcm-projects/dcm-projects-overview>`のプロパティについて説明します。

DESCRIBE は DESC に短縮できます。

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

CREATE DCM PROJECT、ALTER DCM PROJECT、DROP DCM PROJECT、EXECUTE DCM PROJECT、SHOW DCM PROJECTS、SHOW DEPLOYMENTS IN DCM PROJECT

構文

{ DESCRIBE | DESC } DCM PROJECT <name>

パラメーター

name

記述するDCMプロジェクトの識別子を指定します。

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

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

出力

コマンドの出力には、オブジェクトのプロパティとメタデータを説明する以下の列が含まれます。

DCMプロジェクトのプロパティ

列

説明

name

DCMプロジェクトの名前。

例: my_project

created_on

DCMプロジェクトが作成された時のタイムスタンプ。

例: 2022-01-01 00:00:00

owner

DCMプロジェクトを所有するユーザー。

comment

DCMプロジェクトに関連付けられたユーザー定義のコメント。

last_executed_version_name

最後に実行されたDCMプロジェクトバージョンの名前。

例: VERSION$2

last_executed_version_alias

最後に実行されたDCMプロジェクトバージョンのバージョンエイリアス。

last_executed_version_path

最後に実行されたバージョンのURI。

例: snow://project/MY_DB.PUBLIC.P/versions/version$2/

last_executed_source_path

最後に実行されたバージョンのソースへのパス。

例: @project_stg/v1/

アクセス制御の要件

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

権限

オブジェクト

READ

DCMプロジェクト

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

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

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

使用上の注意

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

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

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

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

例

``my_project``という名前の|dcm-object|を記述します。

DESCRIBE DCM PROJECT my_project;