ノートブックの URI を使用してパラメーター化されたノートブックを作成する

Azure Data Studio での ''パラメーター化'' は、異なるパラメーター セットで同じノートブックを実行することです。

この記事では、Azure Data Studio で Python カーネルを使用してパラメーター化されたノートブックを作成して実行する方法を示します。

前提条件

• Azure Data Studio
• Python

URI パラメーター化

プログラムで URI パラメーター化を使用すると、Azure Data Studio の URI のクエリにパラメーターが追加され、新しいパラメーターを含むノートブックが Azure Data Studio で開かれます。

Azure Data Studio のノートブックの URI では HTTPS、HTTP、FILE URI のスキーマがサポートされ、次の形式が使用されます。

azuredatastudio://microsoft.notebook/open?url=

Azure Data Studio のノートブックの URI でパラメーターを渡すには、次の形式を使用します。

azuredatastudio://microsoft.notebook/open?url=LinkToNotebook?x=1&y=2

URI クエリでは、 & を使用して、挿入する新しいパラメーターを指定します。

パラメーター化の例

この記事の手順は、サンプルのノートブック ファイルを使用して行うことができます。

1. GitHub のノートブック ファイルに移動します。 [Raw]\(未フォーマット\) を選択します。
2. Ctrl + S キーを押すか右クリックし、.ipynb の拡張子でファイルを保存します。
3. Azure Data Studio でそのファイルを開きます。

ノートブックの内容と構造を次に示します。

x = 2.0
y = 5.0

addition = x + y
multiply = x * y

print("Addition: " + str(addition))
print("Multiplication: " + str(multiply))

パラメーター化のためのノートブックを設定する

Azure Data Studio で開いたサンプルのノートブックで開始することも、次の手順を行ってノートブックを作成することもできます。 その後、異なるパラメーターを使用してみます。 手順はすべて Azure Data Studio ノートブック内で行われます。

1. 最初のコード セルに、パラメーターでタグを付ける必要があります。 新しいノートブック ファイルを使用している場合は、新しいコード セルを作成します。 [パラメーター] を選択して、セルをパラメーター セルとしてタグ付けします。

   

2. 任意のブラウザーの検索バーまたは Markdown セルを使用して、ノートブックの URI リンクを開くことができます。 Azure Data Studio のノートブックの URI (次に示します) を使用して、GitHub の入力ノートブックの例をパラメーター化できます。

   次のノートブック URI をコピーし、x と y に新しい値を使用して、GitHub の入力ノートブックの例をパラメーター化します。 ブラウザーの検索バーに URI を貼り付けます。

   azuredatastudio://microsoft.notebook/open?url=https://raw.githubusercontent.com/microsoft/sql-server-samples/master/samples/applications/azure-data-studio/parameterization.ipynb?x=10&y=20

   

   Web ブラウザーからリンクを開くと、Azure Data Studio でノートブックを開くように求められます。 [Azure Data Studio を開く] を選択します。

   

3. 新しいパラメーターを含むノートブックをダウンロードして開くように求めるメッセージが表示されます。

   [はい] を選択し、新しいパラメーター化されたノートブックを表示します。 ツール バーの [すべて実行] を選択してすべてのセルを実行し、新しい出力を表示します。

   # Injected-Parameters というラベルが付いた新しいセルには、渡された新しいパラメーター値が含まれます。

   

次の手順

ノートブックとパラメーター化についてさらに学習します。

• Azure Data Studio でノートブックを使用する方法
• 用紙ミルのパラメーター化
• パラメーターを指定して実行