パラメーター付きノートブックの実行

現在、 ARGUMENTS 文字列で渡されるパラメーターは、区切り文字として空白を使用した sys.argv リストに解析されます。

例:パラメーターでノートブックプロジェクトを実行します。

次の例では、 ARGUMENTS = 'env prod' を使用して2つの引数(envとprod)を渡します。

最初の要素( sys.argv[0] )はノートブックのファイル名で、その後にスペース区切りの引数が続きます。

EXECUTE NOTEBOOK PROJECT "<database_name>"."<schema_name>"."<project_name>"
  MAIN_FILE = 'snow://workspace/<workspace_hash>/path/to/notebook.ipynb' -- Notebook name with full file path
  COMPUTE_POOL = '<compute_pool_name>'
  RUNTIME = '<runtime_version>'    -- For example, V2.2-CPU-PY3.11
  QUERY_WAREHOUSE = '<warehouse_name>'
  ARGUMENTS = 'env prod' -- Can pass in a single string, which can be parsed in the notebook code. Point to the environment configuration.
  REQUIREMENTS_FILE = 'path/to/requirements.txt';
Copy

すべての引数を表示する

セッションに渡されたパラメーターの完全なリストを検査するには、 sys モジュールを使用します。

import sys
print(sys.argv)
Copy

出力例:

['exampletestSCOS.ipynb', 'env', 'prod']
Copy

特定の引数にアクセスする

パラメーターは、リストのインデックスからアクセスされます。sys.argv[0] はノートブック名であるため、最初のユーザーパラメーターは index[1] で始まります。

import sys

# Access the first user parameter
first_param = sys.argv[1]
print(first_param)
Copy

出力例:

env
Copy

完全な構文とパラメーターの詳細については、 EXECUTE NOTEBOOK PROJECT を参照してください。