在無塵室中執行筆記本

本文說明如何在無塵室中執行筆記本。筆記本是共同作業者用來在共同作業中執行資料分析的介面。

若要了解如何將筆記本新增至無塵室中，請參閱建立無塵室。

開始之前

若要在無塵室中執行筆記本，您必須是：

注意

建立者會自動指派為其 Databricks 帳戶中無塵室的擁有者。共同作業者的中繼存放區管理員會自動為其 Databricks 帳戶中指派無塵室的擁有權。您可以轉移擁有權。請參閱管理 Unity 目錄物件擁有權。

若要在乾淨的房間里執行筆記本，您必須使用目錄總管。

在 Azure Databricks 工作區中，點擊目錄。
在 [目錄] 窗格頂端，按一下 []，然後選取 [清理空間]。

或者，從 [快速存取] 頁面，按一下 [無塵室 >] 按鈕。
從清單中選取無塵室。
在 [筆記本] 底下，按一下筆記本以預覽模式開啟它。
按一下 [執行] 按鈕。

您只能執行其他合作對象已共享的筆記本。
（選擇性）在 [使用參數執行筆記本] 對話框上，點擊 [+ 新增] 以將參數值傳遞到筆記本任務。
按一下確認核取方塊。
按一下 [執行]。
按一下 [查看詳細資料] 以檢視執行進度。

或者，您可以前往此頁面上的 [執行]，或按一下工作區側邊欄中的 [工作流程]，然後前往 [作業執行] 索引標籤，以檢視執行進度。
檢視筆記本執行的結果。

執行完成之後會出現筆記本結果。若要檢視過去的執行，請移至 [執行]，然後按兩下 [開始 時間] 資料行 的連結。

注意

執行時會自動將 cr_creator_input_catalog 和 cr_collaborator_input_catalog 參數傳遞至潔淨室筆記本。您可以使用這些參數搭配範例數據表進行本機測試。如需作業工作參數的詳細資訊，請參閱參數化作業。

輸出數據表是筆記本運行所產生的暫時只讀數據表，並共享到筆記本運行者的中繼資料庫。如果筆記本建立輸出數據表，筆記本執行器可以在 輸出目錄中存取它， 並與工作區中的其他用戶共用。請參閱在 Databricks Clean Rooms中建立及使用輸出數據表。

您可以使用 Azure Databricks 作業來執行筆記本，並在輸出數據表上執行任務，讓您建置涉及資料潔淨室資產的複雜工作流程。這些功能尤其可讓這類工作流程：

無塵室筆記本工作類型 可讓您選擇並運行無塵室筆記本作為工作流程任務。如需作業，請參閱清理室筆記本工作。
工作流程起始的筆記本執行可以產生 輸出數據表， 可由其他工作流程工作參考。請參閱在 Databricks Clean Rooms中建立及使用輸出數據表。
工作流程可以使用 任務值 來將作業參數值傳遞至潔淨室筆記本，或擷取潔淨室筆記本輸出，並將該輸出傳遞至其他工作流程任務。請參閱使用工作值在工作之間傳遞資訊。
系統會自動產生清理室輸出架構名稱。如果您在參數中包含 {{tasks.<your_task_name>.output.schema_name}} 和 {{tasks.<your_task_name>.output.catalog_name}}，當在下游筆記本任務中執行時，可以從乾淨環境中引用這些值。移至筆記本工作，然後在 [參數]下，選取您的值。

例如，您可以執行下列動作，建立工作流程，以跨工作傳播動態產生的輸出架構名稱：

建立工作類型 Clean Rooms 筆記本 的工作，以執行包含下列工作值設定的筆記本：
```
dbutils.jobs.taskValues.set(key="output_schema", value=dbutils.widgets.get("cr_output_schema"))
```
建立後續工作，以參考 output_schema 值來處理輸出。