SHOW NOTEBOOK PROJECTS

現在のロールに表示されるノートブックプロジェクト（Snowflake NOTEBOOK オブジェクト）を一覧表示します。

このコマンドを使用して、セッションの現在のデータベースとスキーマ、指定したデータベースまたはスキーマ、またはアカウント全体のオブジェクトをリストします。

出力には、各オブジェクトのメタデータとプロパティが含まれます。オブジェクトは、データベース、スキーマ、オブジェクト名で辞書順にソートされます（出力列の説明については、このトピックの Output をご参照ください）。結果をフィルターする場合は、結果の行の順序に注意することが重要です。

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

CREATE NOTEBOOK PROJECT、 EXECUTE NOTEBOOK PROJECT、 SHOW NOTEBOOKS、 DESCRIBE NOTEBOOK

構文

SHOW NOTEBOOK PROJECTS;

SHOW NOTEBOOK PROJECTS IN SCHEMA <database_name>.<schema_name>;

SHOW NOTEBOOK PROJECTS IN DATABASE <database_name>;

SHOW NOTEBOOK PROJECTS IN ACCOUNT;
Copy

パラメーター

IN SCHEMA <database_name>.<schema_name>

指定されたスキーマのノートブックプロジェクトを一覧表示します。

IN DATABASE <database_name>

指定されたデータベースのすべてのスキーマのノートブックプロジェクトを一覧表示します。

IN ACCOUNT

現在のロールに表示される、アカウント内のすべてのノートブックプロジェクトを一覧表示します。

出力

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

列

説明

created_on

作成のタイムスタンプ。

name

ノートブックプロジェクトの名前。

database_name

ノートブックプロジェクトを含むデータベース。

schema_name

ノートブックプロジェクトを含むスキーマ。

owner

ノートブックプロジェクトを所有するロール。

comment

ノートブックプロジェクトに関連するコメント。

アクセス制御の要件

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

権限

オブジェクト

メモ

USAGE または OWNERSHIP

データベース

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

USAGE または OWNERSHIP

スキーマ

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

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

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

使用上の注意

  • このコマンドの実行には、稼働中のウェアハウスは必要ありません。

  • このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。

  • MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者（ ACCOUNTADMIN ロールを持つユーザー）とセキュリティ管理者（ SECURITYADMIN ロールを持つユーザー）のみが MANAGE GRANTS 権限を持っています。

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

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

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

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

  • コマンドは、コマンドを実行するために使用されるロールのアクセス権限によって決定された通り、指定されたオブジェクトタイプに対して 最大 1万件の記録を返します。1万件を超える記録は、フィルターを適用しても返されません。

    1万件を超える記録が存在する結果を表示するには、 Snowflake Information Schema で対応するビュー（存在する場合）をクエリします。

  • 現在のロールに表示されるすべてのSnowflake NOTEBOOK オブジェクトを返します。

  • DESCRIBE NOTEBOOK または GET_DDL('NOTEBOOK', ...) を使用してコンテンツを調べます。

  • 特殊文字を含む識別子は、二重引用符で囲む必要があります。

例

現在のロールに表示されるすべてのノートブックプロジェクトを一覧表示します。

SHOW NOTEBOOK PROJECTS;
Copy

特定のスキーマのノートブックプロジェクトを一覧表示します。

SHOW NOTEBOOK PROJECTS IN SCHEMA TESTDB.TESTSCHEMA;
Copy

特定のデータベースのノートブックプロジェクトを一覧表示します。

SHOW NOTEBOOK PROJECTS IN DATABASE TESTDB;
Copy

アカウント内のノートブックプロジェクトを一覧表示します。

SHOW NOTEBOOK PROJECTS IN ACCOUNT;
Copy
言語: 日本語