[パラメーターで実行する] アクションを使用してパラメーター化されたノートブックを作成する

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

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

注意

現在、パラメーター化は Python、PySpark、PowerShell、.NET Interactive のカーネルで使用できます。

前提条件

[パラメーターで実行する] のノートブックアクションを使用すると、ユーザーが UI に新しいパラメーターを入力して、ノートブックの新しいパラメーターをすばやく設定できます。ユーザーは、新しいパラメーターを使用してノートブックを実行できるようになります。

注意

新しい行の新しいパラメーターごとに、パラメーターセルを書式設定することが重要です。

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

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

新しい Notebook を作成します。 [カーネル] を [Python 3] に変更します。
パッケージの更新が必要なときに Python パッケージのアップグレードを求められた場合は、 [はい] を選択します。
[カーネル] が [Python 3] に設定されていることを確認します。
新しいコードセルを作成します。 [パラメーター] を選択して、セルをパラメーターセルとしてタグ付けします。
```
x = 2.0
y = 5.0
```
他のセルを追加して、異なるパラメーターをテストします。
```
addition = x + y
multiply = x * y
```
```
print("Addition: " + str(addition))
print("Multiplication: " + str(multiply))
```
出力は次の例のようになります。
ノートブックを Input.ipynb として保存します。

ノートブックのツールバーで、 [パラメーターで実行する] アイコンを選択します。
一連の新しいダイアログが表示され、x と y の新しいパラメーターを入力するように求められます。
新しいパラメーターを入力した後、パラメーター化された新しいノートブックを表示します。ツールバーの [すべて実行] を選択してすべてのセルを実行し、新しい出力を表示します。 # Injected-Parameters というラベルが付いた新しいセルには、渡された新しいパラメーター値が含まれます。

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