Amazon
Web Services
Microsoft Azure
Google Cloud Platformクリーンルームでノートブックを実行する
プレビュー
この機能はパブリックプレビュー段階です。
この記事では、クリーンルームでノートブックを実行する方法について説明します。 ノートブックは、共同作業者が共同でデータ分析を実行するために使用するインターフェースです。
クリーン ルームにノートブックを追加する方法については、「クリーン ルームを作成する」を参照してください。
始める前に
クリーン ルームでノートブックを実行するには、次の条件を満たす必要があります。
クリーンルームの所有者、またはクリーンルームに対する
EXECUTE CLEAN ROOM TASK権限を持っている。ノートブックを作成しなかった共同作業者。 ノートブックの作成者はノートブックを実行できません。 これにより、両当事者によるノートブックの暗黙的な承認が強制されます。
注：
作成者は、Databricks アカウント内のクリーン ルームの所有者として自動的に割り当てられます。 共同作業者の組織のメタストア管理者には、Databricks アカウント内のクリーン ルームの所有権が自動的に割り当てられます。 オーナー権限を譲渡できます。 Unity Catalogオブジェクトの所有権の管理」を参照してください。
クリーンルームでノートブックを実行する
クリーン ルームでノートブックを実行するには、カタログ エクスプローラーを使用する必要があります。
Databricks ワークスペースで、
カタログをクリックします。[カタログ] ウィンドウの上部にある [
] 歯車アイコンをクリックし、[Clean Rooms] を選択します。または、[ クイックアクセス ]ページで、[ クリーンルーム]> ボタンをクリックします。
リストからクリーンルームを選択します。
[ノートブック]で、ノートブックをクリックしてプレビュー モードで開きます。
実行ボタンをクリックします。
他の共同作業者が共有したノートブックのみを実行できます。
(オプション) 「パラメーターを指定してノートブック を実行」ダイアログで、「 + 追加 」をクリックして、パラメーター値をノートブック ジョブ・タスクに渡します。
ジョブ タスクのパラメーターの詳細については、「 ジョブのパラメーター化」を参照してください。
確認のチェックボックスをクリックします。
実行をクリックします。
実行の進行状況を表示するには、 「詳細を表示」をクリックします。
あるいは、このページの「実行」に移動するか、ワークスペースのサイドバーの「ワークフロー」をクリックして「ジョブ実行」タブに移動すると、実行の進行状況を確認できます。
ノートブックの実行結果を表示します。
実行が完了すると、ノートブックの結果が表示されます。 過去の実行を表示するには、 「実行」に移動し、 「開始時刻」列のリンクをクリックします。
クリーンルーム ノートブックを実行するためにDatabricksワークフローを使う
Databricks ジョブを使用してノートブックを実行し、出力テーブルでタスクを実行できるため、クリーンルームアセットを含む複雑なワークフローを構築できます。 特に、次のような機能により、次のようなワークフローが可能になります。
「クリーンルーム ノートブック タスク」タイプでは、クリーンルーム ノートブックをワークフロー タスクとして選択して実行できます。ジョブ用クリーンルーム ノートブック タスクを参照してください。
ワークフロー開始ノートブック 実行は、他のワークフロー タスクで参照できる 出力テーブル を生成できます。 「Databricks クリーンルームでの出力テーブルの作成と操作」を参照してください。
ワークフローでは、ジョブ パラメーター値をクリーンルーム ノートブックに渡す タスク値 を使用するか、またはクリーンルーム ノートブック 出力をキャプチャしてその出力を他のワークフロー タスクに渡すことができます。 「タスク値を使用してタスク間で情報を渡す」を参照してください。
たとえば、動的に生成された出力スキーマ名をタスク間で伝達するワークフローを作成するには、次の手順を実行します。
タスク type クリーンルーム ノートブック のタスクを作成し、次のタスク値設定を含むノートブックを実行します。
dbutils.jobs.taskValues.set(key="output_schema", value=dbutils.widgets.get("cr_output_schema"))
出力を処理するために、
output_schema値を参照する後続のタスクを作成します。