Snowflake Notebooksの使用¶
Snowflake CLI には、コマンドラインから Snowflake notebooks を作成または実行できるようになる以下の snow notebook
コマンドが含まれます。
ノートブックを作成する¶
注釈
バージョン3.4.0以降、 Snowflake CLI は snow notebook deploy
コマンドを snow notebook create
コマンドの代わりに追加しました。下位互換性をサポートするため、 snow notebook create
コマンドを使用してもノートブックを作成できますが、Snowflakeでは新しい ノートブックのデプロイと作成 プロシージャの使用を開始することをお勧めします。
snow notebook create
コマンドは、ステージ上の既存のノートブックからノートブックを作成します。コマンドは新しいノートブックへのリンクを返します。次の例では、指定したステージングされたノートブックから MY_NOTEBOOK を作成します。
snow notebook create MY_NOTEBOOK -f @MY_STAGE/path/to/notebook.ipynb
このコマンドは、接続用に定義されたデフォルトのウェアハウスにノートブックを作成します。 --warehouse
オプションを使用すると、代替のウェアハウスを指定したり、接続でデフォルトのウェアハウスが定義されていない場合に指定したりすることができます。
ノートブックのデプロイと作成¶
snow notebook deploy
コマンドはローカルファイルをステージにアップロードし、選択したデータベースとスキーマの中に新しいNotebookオブジェクトを作成します。プロジェクト定義ファイルには、メインノートブックファイルとクエリウェアハウスを指定する必要があります。--replace
オプションは、指定された Notebook オブジェクトが既に存在する場合、それを置き換えます。
Snowflakeの各ノートブックには、 snowflake.yml
プロジェクト定義ファイルを含める必要があります。
次の例はサンプルの snowflake.yml
ノートブックプロジェクト定義ファイルです。
definition_version: 2
entities:
my_notebook:
type: notebook
query_warehouse: xsmall
notebook_file: notebook.ipynb
artifacts:
- notebook.ipynb
- data.csv
以下のテーブルは、ノートブック プロジェクト定義 のプロパティについて説明しています。
プロパティ |
定義 |
---|---|
タイプ required, string |
|
query_warehouse required, string |
ノートブックをホストするSnowflakeウェアハウス。 |
notebook_file required, string |
ノートブックファイルへのパス。 |
アーティファクト 必須、 文字列シーケンス |
ステージにアップロードされたファイルのリスト。ノートブックファイルはこのリストに含める必要があります。 |
stage_path optional, string |
アーティファクトが保存されるステージへのパス。デフォルト: |
compute_pool optional, string |
コンテナー化されたノートブック が使用するコンピューティングプール。 注釈 コンテナー化されたノートブックは現在、 PuPr にあります。 |
runtime_name optional, string |
コンテナー化されたノートブック で使用するContainer Runtimeの名前。以下の値が有効です。
注釈 コンテナー化されたノートブックは現在、 PuPr にあります。 |
識別子 optional, string |
エンティティの任意のSnowflake識別子。この値には次のような形式があります。
|
次の例は、プロジェクト定義ファイルで指定されたファイルをアップロードし、 my_notebooks
という名前の新しいノートブックを作成します。
snow notebook deploy my_notebook
Uploading artifacts to @notebooks/my_notebook
Creating stage notebooks if not exists
Uploading artifacts
Creating notebook my_notebook
Notebook successfully deployed and available under https://snowflake.com/provider-deduced-from-connection/#/notebooks/DB.SCHEMA.MY_NOTEBOOK
ノートブックを実行する¶
snow notebook executeコマンドはヘッドレスモードでノートブックを実行します。現在のところ、このコマンドはノートブックが正常に実行されたかどうかを示すメッセージを返すだけです。
snow notebook execute MY_NOTEBOOK
Notebook MY_NOTEBOOK executed.