共用方式為


使用「使用參數執行」動作建立參數化筆記本

重要

Azure Data Studio 將於 2026 年 2 月 28 日停止運行。 建議您使用 Visual Studio Code 的 MSSQL 延伸模組。 如需移轉至 Visual Studio Code 的詳細資訊,請流覽 Azure Data Studio 發生什麼事?

Azure Data Studio 中的參數化功能指以不同的參數集執行相同的記事本。

本文說明如何使用 Python 核心在 Azure Data Studio 中建立和執行參數化筆記本。

Note

目前,您可以搭配 Python、PySpark、PowerShell 和 .NET 互動式核心使用參數化。

Prerequisites

使用參數執行動作

當您使用「使用參數執行筆記本」動作時,使用者可以在 UI 中輸入新參數,以快速設定筆記本的新參數。 然後,使用者可以使用新參數執行筆記本。

Note

請務必將每個新參數格式化在參數儲存格的新行上。

參數化範例

您可以使用 範例筆記本檔案 來完成本文中的步驟:

  1. 移至 GitHub 中的筆記本檔案。 選取 [原始]。
  2. 選取 Ctrl+S 或按一下滑鼠右鍵,然後儲存副檔名為 .ipynb 的檔案。
  3. 在 Azure Data Studio 中開啟檔案。

設定筆記本以進行參數化

您可以從在 Azure Data Studio 中開啟的範例筆記本開始,或完成下列步驟來建立筆記本。 然後,嘗試使用不同的參數。 所有步驟都會在 Azure Data Studio 筆記本內執行。

  1. 建立新的筆記本。 將 核心 變更為 Python 3

    螢幕擷取畫面顯示 [新增筆記本] 功能表選項,並將核心值設定為 Python 3。

  2. 如果系統提示您在套件需要更新時升級 Python 套件,請選取 [ ]:

    螢幕擷取畫面,顯示更新 Python 套件的對話方塊提示。

  3. 確認 核心已 設定為 Python 3

    顯示 Python 3 核心值的螢幕擷取畫面。

  4. 建立新的程式碼儲存格。 選取 參數 將 儲存格標記為參數儲存格。

    x = 2.0
    y = 5.0
    

    螢幕擷取畫面顯示在選取 [參數] 的情況下建立新的參數儲存格。

  5. 新增其他儲存格以測試不同的參數:

    addition = x + y
    multiply = x * y
    
    print("Addition: " + str(addition))
    print("Multiplication: " + str(multiply))
    

    輸出看起來類似於以下示例:

    螢幕擷取畫面,顯示新增以測試新參數的儲存格輸出。

  6. 將筆記本另存為 Input.ipynb

    顯示儲存筆記本檔案的螢幕擷取畫面。

使用參數運行Notebook

  1. 在筆記本工具列上,選取 [使用參數執行] 圖示:

    螢幕擷取畫面,顯示工具列上選取的 [使用參數執行] 圖示。

  2. 一系列新對話方塊會提示您輸入 xy 的新參數:

    顯示為 x 輸入新參數的螢幕擷取畫面。

    顯示輸入 y 新參數的螢幕擷取畫面。

  3. 輸入新參數之後,請檢視新的參數化筆記本。 在工具列上,選取 [全部執行] 以執行所有儲存格並查看新的輸出。 標記的新 # Injected-Parameters 儲存格包含傳入的新參數值:

    顯示新參數輸出的螢幕擷取畫面。

後續步驟

深入瞭解筆記型電腦和參數設置: