メインコンテンツまでスキップ

実行 ノートブック in クリーンルーム

この記事では、クリーンルームでノートブックを実行する方法について説明します。 ノートブックは、共同作業者が共同作業でデータ分析を実行するために使用するインターフェイスです。

ノートブックをクリーンルームに追加する方法については、「 クリーンルームを作成する」を参照してください。

始める前に​

クリーンルームでノートブックを実行するには、次の条件を満たす必要があります。

  • クリーンルームの所有者、またはクリーンルームに対する EXECUTE CLEAN ROOM TASK 権限を持っている。
  • ノートブックを作成しなかった共同作業者。 ノートブックの作成者はノートブックを実行できません。 これにより、両当事者によるノートブックの暗黙的な承認が強制されます。
注記

作成者は、Databricks アカウントのクリーンルームの所有者として自動的に割り当てられます。 協力組織のメタストア管理者には、 Databricks アカウントでクリーンルームの所有権が自動的に割り当てられます。 オーナー権限を譲渡できます。 「Unity Catalog オブジェクトの所有権の管理」を参照してください。

実行 a ノートブック in a クリーンルーム​

クリーンルームでノートブックを実行するには、Catalog Explorer を使用する必要があります。

  1. Databricks ワークスペースで、[カタログアイコン カタログ] をクリックします。

  2. カタログ ウィンドウの上部にある歯車アイコン 歯車アイコンをクリックし、 Clean Rooms を選択します。

    または、 クイックアクセス ページで、 クリーンルーム> ボタンをクリックします。

  3. リストからクリーンルームを選択します。

  4. [ノートブック ] で、ノートブックをクリックしてプレビュー モードで開きます。

  5. 「実行 」ボタンをクリックします。

    実行できるのは、他のコラボレーターが共有しているノートブックのみです。

  6. (オプション) 「パラメーターを指定してノートブック を実行」ダイアログで、「 + 追加 」をクリックして、パラメーター値をノートブック ジョブ・タスクに渡します。

  7. 確認のチェックボックスをクリックします。

  8. 実行 をクリックします。

  9. [ 詳細を表示 ] をクリックして、実行の進行状況を表示します。

    または、このページで [実行 ] に移動するか、ワークスペース サイドバーの [ワークフロー ] をクリックして [ジョブ 実行 ] タブに移動することで、実行の進行状況を表示することもできます。

  10. ノートブックの実行結果を表示します。

    ノートブックの結果は、実行の完了後に表示されます。 過去の実行を表示するには、[ 実行 ] に移動し、[ 開始時刻 ] 列のリンクをクリックします。

注記

cr_creator_input_catalog パラメーターと cr_collaborator_input_catalog パラメーターは、ランタイム時に自動的にクリーンルーム ノートブックに渡されます。これらのパラメーターは、サンプル・テーブルを使用したローカル・テストに使用できます。 ジョブ タスクのパラメーターの詳細については、「 ジョブのパラメーター化」を参照してください。

出力テーブルを使用したノートブック出力の共有​

出力テーブルは、ノートブックの実行によって生成され、ノートブック ランナーのメタストアに共有される一時的な読み取り専用テーブルです。 ノートブックが出力テーブルを作成すると、ノートブック ランナーは 出力カタログ でそのテーブルにアクセスし、ワークスペース内の他のユーザーと共有できます。 「Databricks クリーンルームでの出力テーブルの作成と操作」を参照してください。

Use Databricks Workflows to run クリーンルーム ノートブック​

Databricks ジョブを使用してノートブックを実行し、出力テーブルでタスクを実行できるため、クリーンルームアセットを含む複雑なワークフローを構築できます。 特に、次のような機能により、次のようなワークフローが可能になります。

  • 「クリーンルーム ノートブック タスク」タイプ では、クリーンルーム ノートブックをワークフロー タスクとして選択して実行できます。クリーンルーム ノートブック タスク for ジョブを参照してください。
  • ワークフロー開始ノートブック 実行は、他のワークフロー タスクで参照できる 出力テーブル を生成できます。 「Databricks クリーンルームでの出力テーブルの作成と操作」を参照してください。
  • ワークフローでは、ジョブ パラメーター値をクリーンルーム ノートブックに渡す タスク値 を使用するか、またはクリーンルーム ノートブック 出力をキャプチャしてその出力を他のワークフロー タスクに渡すことができます。 「タスク値を使用してタスク間で情報を渡す」を参照してください。
  • クリーンルーム出力スキーマ名は自動的に生成されます。 パラメーターに [ {{tasks.<your_task_name>.output.schema_name}} ] と [ {{tasks.<your_task_name>.output.catalog_name}} ] を含めると、ダウンストリーム ノートブック タスクで実行されるときに、クリーンルームからそれらの値を参照できます。 ノートブック タスクに移動し、[ パラメーター] で値を選択します。

たとえば、動的に生成された出力スキーマ名をタスク間で伝達するワークフローを作成するには、次の手順を実行します。

  1. タスク type クリーンルーム ノートブック のタスクを作成し、次のタスク値設定を含むノートブックを実行します。

    dbutils.jobs.taskValues.set(key="output_schema", value=dbutils.widgets.get("cr_output_schema"))

  2. 出力を処理するために、 output_schema 値を参照する後続のタスクを作成します。

に最終更新