重要
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
請務必將每個新參數格式化在參數儲存格的新行上。
參數化範例
您可以使用 範例筆記本檔案 來完成本文中的步驟:
- 移至 GitHub 中的筆記本檔案。 選取 [原始]。
- 選取 Ctrl+S 或按一下滑鼠右鍵,然後儲存副檔名為 .ipynb 的檔案。
- 在 Azure Data Studio 中開啟檔案。
設定筆記本以進行參數化
您可以從在 Azure Data Studio 中開啟的範例筆記本開始,或完成下列步驟來建立筆記本。 然後,嘗試使用不同的參數。 所有步驟都會在 Azure Data Studio 筆記本內執行。
建立新的筆記本。 將 核心 變更為 Python 3:
如果系統提示您在套件需要更新時升級 Python 套件,請選取 [ 是]:
確認 核心已 設定為 Python 3:
建立新的程式碼儲存格。 選取 參數 將 儲存格標記為參數儲存格。
x = 2.0 y = 5.0
新增其他儲存格以測試不同的參數:
addition = x + y multiply = x * yprint("Addition: " + str(addition)) print("Multiplication: " + str(multiply))輸出看起來類似於以下示例:
將筆記本另存為 Input.ipynb:
使用參數運行Notebook
在筆記本工具列上,選取 [使用參數執行] 圖示:
一系列新對話方塊會提示您輸入 x 和 y 的新參數:
輸入新參數之後,請檢視新的參數化筆記本。 在工具列上,選取 [全部執行] 以執行所有儲存格並查看新的輸出。 標記的新
# Injected-Parameters儲存格包含傳入的新參數值:
後續步驟
深入瞭解筆記型電腦和參數設置: