プライベートノートブック¶

プライベートノートブックを使用するための前提条件¶

プライベートノートブックを作成して使用する前に、 ACCOUNTADMIN ロールを持つ管理者は以下のタスクを完了する必要があります。

• アカウントレベルまたは特定のユーザーに対して、個人データベース機能を有効にします。

  パーソナルデータベースは、ノートブックをプライベートノートブックとして動作させるためのSnowflakeオブジェクトです。このタスクの完了に関する情報については、以下のセクションを参照してください。

  • アカウントのプライベートノートブックを有効または無効にします。

  • ユーザーごとのプライベートノートブックの有効化・無効化

• 必要であれば、プライベートノートブックを作成するユーザーに対して、セカンダリロールを適切に設定してください。

  このタスクの完了に関する情報（最近の BCR バンドルが有効になっているかどうかに依存するかもしれません）については、 プライベートノートブックユーザーのすべてのセカンダリロールのアクティブ化 をご参照ください。

プライベートノートブックの作成については、 新しいロールを作成する を参照してください。

プライベートノートブックユーザーのすべてのセカンダリロールのアクティブ化¶

プライベートノートブックを作成する前に、 すべての セカンダリロールを有効にする必要があります。これは、プライベートノートブックがユーザーの所有物であり、ユーザーの主なロールではないからです。

ユーザーのすべてのセカンダリ・ロールを既定のロールで有効にするには、ユーザーまたは管理者は ALTER USER コマンドを使用して、そのユーザーの DEFAULT_SECONDARY_ROLES オブジェクト・プロパティを設定解除するか、 ('ALL') に設定します。

例:

ALTER USER my_user UNSET DEFAULT_SECONDARY_ROLES;
ALTER USER my_user SET DEFAULT_SECONDARY_ROLES = ('ALL');

ユーザーまたは管理者が上記の SQL ステートメントを実行した後、ユーザーは Snowsight (Projects » Notebooks)、または new worksheetで SQL コマンドを実行することで、プライベートノートブックを作成することができます。

既存のワークシートで SQL コマンドを実行したいユーザーは、プライベート・ノートブックを作成する前に、次の SQL ステートメントを実行する必要があります。

USE SECONDARY ROLES ALL;

アカウントのプライベートノートブックを有効または無効にします。¶

Snowflakeアカウントでプライベートノートブックを有効または無効にするには、 ENABLE_PERSONAL_DATABASE パラメーターを使用します。

ENABLE_PERSONAL_DATABASE の特性:

型:

ユーザー --- アカウント > ユーザーに設定可能

データ型:

ブール値

説明:

ユーザーがプライベートノートブックにアクセスできるかどうかを制御します。

値:

TRUE: ユーザーが個人データベースにアクセスできるようにします。

FALSE: ユーザーが個人データベースにアクセスできないようにします。

デフォルト:

FALSE

ALTER ACCOUNT SET ENABLE_PERSONAL_DATABASE = TRUE;

ALTER ACCOUNT SET ENABLE_PERSONAL_DATABASE = FALSE;

SHOW PARAMETERS LIKE 'ENABLE_PERSONAL_DATABASE' IN ACCOUNT;

USE DATABASE USER$;

USE DATABASE USER$bobr;

USE DATABASE USER$jlap;

ERROR: Insufficient privileges to operate on database 'USER$JLAP'

ユーザーごとのプライベートノートブックの有効化・無効化¶

管理者は、アカウント内のすべてのユーザーではなく、アカウント内の特定のユーザーに個人的なデータベースアクセスをさせたい場合があります。指定したユーザーのアクセスを有効にするには、 ALTER USER コマンドを使用して、それらのユーザーに対して ENABLE_PERSONAL_DATABASE パラメーターを TRUE にセットします。例えば、3人のユーザーのアクセスを有効にします。

ALTER USER bobr SET ENABLE_PERSONAL_DATABASE = TRUE;
ALTER USER amya SET ENABLE_PERSONAL_DATABASE = TRUE;
ALTER USER jlap SET ENABLE_PERSONAL_DATABASE = TRUE;

アカウントレベルで個人データベースを有効にした場合、必要に応じて個々のユーザーの個人データベースを無効にすることができます。ユーザーを無効にするには、同じコマンドを実行しますが、パラメーターを FALSE にセットします。例:

ALTER USER jlap SET ENABLE_PERSONAL_DATABASE = FALSE;

ユーザー jlap がいずれかのコマンドで USER$ プレフィックスを指定した場合、個人データベースが存在しないため、コマンドは失敗します。

NotebookSqlException: Failed to fetch a pandas Dataframe. The error is: 060109 (0A000): Personal Database is not enabled for user JLAP.
Please contact an account administrator to enable it and try again.

プライベートノートブックの作成¶

新しいプライベートノートブックを作成するには、以下の手順に従ってください。

1. Snowsight にサインインします。

2. 左側のナビゲーションメニューで Projects » Notebooks を選択します。

3. + Notebook を選択します。

4. Owner リストからユーザー名を選択してください。

5. ノートブックの名前を入力します。

   注釈

   AWS リージョンを使用している場合、ノートブックのランタイム環境を指定することができます: Warehouse Runtime または Container Runtime のいずれかです。

6. Notebook location を選択します。これはノートブックを保存するデータベースとスキーマです。これらはノートブック作成後に変更することはできません。アカウントで個人データベースを有効にした後にプライベートノートブックを作成した場合、個人データベースはデフォルトで Notebook location の下にあらかじめ入力されています。しかし、プライベート・ノートブックを作成していて、個人データベースにスキーマが1つしかない場合、 Notebook location オプションは使用できません。

   注釈

   Notebook location ドロップダウンに、 Create Notebook ダイアログを開いた後に作成されたデータベースが表示されない場合があります。最近作成したデータベース、スキーマ、ウェアハウスが見つからない場合は、ブラウザのウィンドウを再読み込みしてみてください。

   ノートブック内のデータのクエリは、この場所に限定されません。Notebooksでは、アクセスできる場所であればどこでもデータをクエリできます。場所を指定するには、 USE WAREHOUSE と USE SCHEMA を実行します。

7. Python の環境として Run on warehouse または Run on container を選択します。

8. （オプション） ノートブックが発行した Query warehouse を選択して、任意の SQL およびSnowparkのクエリを実行します。

9. ノートブック固有のタスクを実行するには、 Notebook warehouse を選択します。Snowflakeでは、 SYSTEM$STREAMLIT_NOTEBOOK_WH、各アカウントでノートブックを実行するためにプロビジョニングされる、Snowflakeが管理するウェアハウスである $ を使用することを推奨しています。

10. Create を選択してノートブックを作成し、開きます。

プライベートノートブックの整理¶

プライベートノートブックを整理する手段としてスキーマを作成し、使用することができます。デフォルトでは、個人データベースには PUBLIC と INFORMATION_SCHEMA という標準スキーマが含まれています。

通常の方法で新しいスキーマを作成し、使用しますが、スキーマを作成する際には個人用データベースを使用していることを確認してください。例:

USE DATABASE USER$bobr;
CREATE SCHEMA bobr_schema;
USE SCHEMA bobr_schema;

また、 ALTER SCHEMA コマンドを個人データベースのスキーマに対して使用することもできます。 SHOW SCHEMAS コマンドを使用すると、個人データベースに属するスキーマを確認することができます。例:

ALTER SCHEMA bobr_schema RENAME TO bobr_personal_schema;
SHOW TERSE SCHEMAS;

+-------------------------------+----------------------+------+---------------+-------------+
| created_on                    | name                 | kind | database_name | schema_name |
|-------------------------------+----------------------+------+---------------+-------------|
| 2024-10-28 19:33:18.437 -0700 | BOBR_PERSONAL_SCHEMA | NULL | USER$BOBR     | NULL        |
| 2024-10-29 14:11:33.267 -0700 | INFORMATION_SCHEMA   | NULL | USER$BOBR     | NULL        |
| 2024-10-28 12:47:21.502 -0700 | PUBLIC               | NULL | USER$BOBR     | NULL        |
+-------------------------------+----------------------+------+---------------+-------------+

プライベートNotebooksの一般利用可用性¶

その開発のある時点で、個人データベースの外にノートブックを再作成したくなるかもしれません。この変更を行うには、 CREATE NOTEBOOK コマンドを使って元のノートブックを複製します。そうすると、ノートブックが他のユーザーから見えるようになります。

例:

CREATE NOTEBOOK bobr_prod_notebook
  FROM 'snow://notebook/USER$BOBR.PUBLIC.bobr_private_notebook/versions/version$1/'
  QUERY_WAREHOUSE = 'PUBLIC_WH'
  MAIN_FILE = 'notebook_app.ipynb'
  COMMENT = 'Duplicated from personal database';

Notebook BOBR_PROD_NOTEBOOK successfully created.

本番データベースで作成されたノートブックからプライベート・ノートブックを作成することもできます。

FROM 'source_location'

指定したステージングされた場所にある .ipynb ファイルからノートブックを作成することを指定します。

• ステージ上のファイルからノートブックを作成するには、 source_location をステージ上のファイルの場所に設定し、 MAIN_FILE パラメーターをファイルの名前に設定します。

• プライベートノートブックからノートブックを作成する場合（例: プライベートノートブックを共有で使用できるようにする場合）は、このパラメーターを設定します。

  'snow://notebook/USER$username.schema.notebook/versions/version$1/'

  条件:

  • username は、ユーザー名です。

  • schema は、プライベートノートブックを含むスキーマの名前です。

  • notebook は、プライベートノートブックの名前です。

このパラメーターが指定されない場合、ノートブックオブジェクトはテンプレートノートブックから作成されます。

プライベートノートや個人データベースの情報表示¶

個人ユーザーは、 Snowsight を使用して、自分の Notebooks に関する情報を表示できます。 Projects » Notebooks に移動します。ノートブックの所有者がユーザーとしてリストされます。

個人データベースを含むデータベースに関する情報は、 Data » Databases してください。どのデータベースが個人用データベースであるかは、 USER$ というプレフィックスがついているのですぐにわかります。

管理者の可視性¶

MANAGE GRANTS 権限を持つロールは、個々のユーザーが所有する個人オブジェクトを含め、アカウント内のすべてのオブジェクトを可視化できます。例えば、 ACCOUNTADMIN のようなロールは、既定の設定では個人データベースを含むすべてのデータベースを表示できます。これらのロールは、個人データベース内のスキーマやプライベートノートブックの詳細にもアクセスできます。

アカウント内のすべての個人データベースの詳細を表示するには、 DATABASES Account Usage ビュー をクエリします。

SELECT * FROM SNOWFLAKE.ACCOUNT_USAGE.DATABASES;

管理者は、 DESCRIBE NOTEBOOK を使用して、特定のプライベートノートブックのプロパティを表示できます。

DESCRIBE NOTEBOOK USER$.PUBLIC.bobr_private_notebook;

Snowsight の Projects » Notebooks ページでは、管理者は、 Notebooks リスト内の他のユーザーに属するプライベートノートブックオブジェクトを見ることができません。

現在のユーザーの個人データベースを表示します。

SHOW DATABASES LIKE 'USER$BOBR';

個人データベースの場合、 kind 列の値は PERSONAL DATABASE です。

制限事項¶