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

Lakeflowジョブの ID、アクセス許可、特権を管理する

Lakeflow ジョブは2種類の権限を使用します:ジョブの表示、実行、および管理を行うユーザーを制御する ジョブ権限 と、ジョブがデータやその他のリソースにアクセスするために使用する ID を決定する Run as 権限です。この記事では、ガバナンスのベストプラクティスと合わせて、両方について説明します。

注記

シークレットは、クラシック コンピュート リソースの Spark ドライバーの stdout と stderr ストリームから伏字処理されません。機密データを保護するため、デフォルトでは、専用アクセスモードまたは標準アクセスモードのジョブ コンピュートと汎用コンピュートに対し CAN MANAGE 権限を持つユーザーのみが Spark ドライバー ログを表示できます。同じデフォルトが、プールから作成されたコンピュートリソースに適用されます。CAN ATTACH TO または CAN RESTART の権限を持つユーザーがログを表示できるようにするには、コンピュートのSpark構成フィールドで、次のプロパティ (spark.databricks.acl.needAdminPermissionToViewLogs false) を設定します。

分離なしの共有アクセス モードのレガシーコンピュートでは、 CAN VIEW (ベータ版)、Can Attach To、Can Restart、または CAN MANAGE アクセス許可を持つユーザーが Spark ドライバーLogを表示できます。Logsを読み取ることができるユーザーを CAN MANAGE 権限を持つユーザーのみに制限するには、 spark.databricks.acl.needAdminPermissionToViewLogs を true に設定します。

spark.databricks.acl.needAdminPermissionToViewLogsはコンピュートレベルのSparkプロパティであるため、それが必要な各コンピュートで設定する必要があります。jobs/runs/submit を介して送信される一時的なジョブラン (外部オーケストレーターによってトリガーされるものなど) の場合は、送信時に new_cluster.spark_conf でプロパティを、任意の access_control_list エントリとともに設定します。

ジョブ権限と実行ユーザー​

ジョブは Databricks 内のオブジェクトであり、それらのジョブにアクセスしたり管理したりできる権限があります。このページでは、これらの権限を ジョブ権限 (または許可) として説明します。

ジョブは、ジョブが参照するリソースを操作するための独自の権限を持つユーザー (またはプリンシパル) に代わって実行され、タスクを実行します。ジョブが動作するユーザーは「 実行 ユーザー」と呼ばれ、それらの権限はこのページでは 「実行権限」 (または「アクセス許可」) と呼ばれます。 as ユーザーの権限は、ジョブが実行されるときに使用されます。

例えば、ユーザーAがジョブを作成し、実行ユーザーをユーザーBに設定した場合、そのジョブはユーザーBの権限で実行されます。ユーザーCがジョブを実行しても、そのジョブは引き続きユーザーBの権限で実行されます。これは、アクセス権限を持たないデータセットから情報を取得するためのジョブの実行を許可できることを意味します。

ジョブのデフォルト権限​

ジョブには、デフォルトで次の権限が設定されています。

  • ジョブの作成者に、ジョブに対する IS OWNER 権限が付与されます。
  • ワークスペース管理者には、ジョブに対する CAN MANAGE 権限が付与されます。
  • ジョブの作成者が 別のユーザーとして実行 に設定されている。
  • ジョブ (ジョブ内のタスクを含む) を実行するときは、 実行 ユーザーの権限が使用されます。

デフォルトでは、作成者が所有者と 実行ユーザーの 両方に設定されるため、ジョブを実行するときはデフォルトで作成者の権限が使用されます。Databricksでは、権限を所有者の権限とは別に制御できるように、また所有者が離れたり権限を変更したときにジョブが中断されないように、ユーザー としての実行を サービスプリンシパルに変更することをお勧めします。

ジョブの管理者権限​

デフォルトにより、ワークスペースの管理者は、ジョブの所有者を変更したり、ワークスペース内の任意のユーザーまたはサービスプリンシパルを 実行者として 設定したりできます。 アカウント管理者は、 RestrictWorkspaceAdmins 設定を構成してこの動作を変更できます。 「ワークスペース管理者を制限する」を参照してください。

ジョブがUnity Catalogの権限とどのように連携するか​

「実行として」 設定のユーザーの ID としてジョブを実行します。 タスクを実行するときに、この ID は、それらのタスクで使用される可能性のある次のリソースに対するアクセス許可の付与に対して評価されます。

  • Unity Catalog で管理されるアセット (テーブル、ボリューム、モデル、ビューなど)。
  • レガシー Hive metastoreに登録された資産に対するレガシーなテーブルアクセスコントロール リスト (ACL)。
  • コンピュート、ノートブック、クエリ、およびその他のワークスペースアセットの ACL。
  • Databricks のシークレット。 シークレット管理を参照してください。
注記

Unity Catalog グラントとレガシーテーブル ACL には、互換性のあるコンピュートアクセスモードが必要です。 ジョブのコンピュートの設定を参照してください。

権限が評価される場合​

ジョブ権限は、ユーザーがジョブの編集や実行などのアクションをそのジョブに対して実行するときに評価されます。

権限 としての実行は ジョブの実行中に評価されます。 したがって、各タスクは、タスクの開始時または実行中に権限をチェックする可能性があります。

注記

ジョブ実行の開始時に権限 としてのすべての実行 が検証されるわけではありません。 ジョブの実行中に 実行ユーザーの権限を 変更すると、特に権限を削除すると、ジョブが完了する前に失敗する可能性があります。

ジョブ実行のユーザーとして実行を構成する​

別のユーザーとして実行 設定を変更するには、ジョブに対する CAN MANAGE または IS OWNER のアクセス許可が必要です。

実行名 の設定は、自分自身に設定することも、 サービスプリンシパル User 権限があるワークスペース内の任意のサービスプリンシパルに設定することもできます。

ワークスペース UI でジョブの 実行者 設定を構成するには、次の手順を使用して既存のジョブを選択します。

  1. Databricks ワークスペースのサイドバーで、[ ジョブとパイプライン] をクリックします。
  2. 必要に応じて、[ ジョブ] フィルター と [自分が所有] フィルターを選択すると、ジョブを見つけやすくなります。
  3. リスト内のジョブの名前をクリックします。
  4. 「 ジョブの詳細 」サイドパネルで、「 実行 」フィールドの横にある鉛筆アイコンをクリックします。
  5. ユーザーまたはサービスプリンシパルを検索して選択します。
  6. [ 保存 ]をクリックします。

サービスプリンシパルの操作の詳細については、以下を参照してください。

ランをグループに設定します​

ジョブの Run as ID をグループに設定するのは、ユーザーまたはService Principalに設定するのと同様です。ジョブはそのIDのアクセス許可で実行されます。 Run as ID がグループの場合、すべてのタスクがグループとして実行され、データアクセスにはグループのアクセス許可が使用され、監査Logsには identity_metadata.run_as がグループとして記録されます。ジョブは常にジョブサービスのアプリケーションService Principalによって実行されるため、identity_metadata.run_by は常にそのIDを記録します。ラン中に作成されたワークスペース資産(ノートブック、クエリー、ファイル)はグループが所有します。

グループを仮定している必要はありません。「ランas」をそのグループに設定するには。グループを仮定してジョブを作成すると、Databricks はジョブの「 所有者 」と「 Run as 」の両方を自動的にグループに設定します。 「Run as」をグループに手動で設定することもできます。 「ラン as」をグループに手動で構成するには、次のいずれかを実行する必要があります。

  • グループのメンバーであるか、または
  • そのグループが 排他的アクセス に使用されている場合は、グループに対する**Assume**権限を持っている必要があります。

グループは、ワークスペースに割り当てられたアカウントグループである必要があります。ワークスペースローカルグループをランアス ID として使用することはできません。広範な組み込みグループである admins、users、および account users も同様に使用できません。

ジョブはグループとして実行されるため、ジョブのノートブックやワークスペースファイルに対する読み取りアクセス権など、ジョブが使用するすべてのリソースに対してグループがアクセス権を持っている必要があります。自分自身にアクセス権を付与するだけでは十分ではありません。

To configure ラン as to a グループ:

  1. Databricks ワークスペースのサイドバーで、[ ジョブとパイプライン] をクリックします。
  2. リスト内のジョブの名前をクリックします。
  3. ジョブの詳細 サイドパネルで、 実行 フィールドの横にある鉛筆アイコンをクリックします。
  4. グループを検索して選択してください。
  5. [ 保存 ]をクリックします。

タスクは、 実行者 グループとしてdefaultで実行されます。個々のタスクのコンピュートが、別のプリンシパルに割り当てられた専用アクセスモードのクラスターである場合、そのタスクは代わりに、クラスターに割り当てられたプリンシパルとして実行されます。

グループをロールとして使用する方法の詳細については、役割ベースのアクセス制御(RBAC)を参照してください。

ジョブガバナンスのベストプラクティス​

Databricks では、すべての本番運用ジョブについて、次のことを推奨しています。

  • サービスプリンシパルを用いた本番運用 ジョブの実行

    ジョブは、デフォルトでジョブ作成者 として実行されます 。 実行 ユーザーが組織を離れると、ジョブが失敗する可能性があります。

    実行ユーザーとしてサービスプリンシパルを割り当てると、ジョブ実行はサービスプリンシパルの権限を使用し、ユーザーが退職したり権限が変更されても変更されません。

    デフォルトでは、ワークスペース管理者はジョブの権限を管理し、必要に応じて所有権を再割り当てできます。

    本番運用ジョブにサービスプリンシパルを使用すると、本番運用データへの書き込み権限を制限することもできます。 ユーザーの権限を使用してジョブを実行する場合、そのユーザーには、ジョブに必要な本番運用データを編集するために同じ権限が必要です。

  • 常にUnity Catalog互換のコンピュート設定を使用する

    Unity Catalog データガバナンスでは、サポートされているコンピュート構成を使用する必要があります。

    クラシック コンピュートを使用するジョブの場合、 Databricks では、サポートされているワークロードに対して標準アクセス モードをお勧めします。 必要に応じて、専用のアクセスモードを使用します。

    Unity Catalogで構成されたLakeFlow Pipelinesにはいくつかの制限があります。制限事項を参照してください。

  • 本番運用ジョブのジョブ権限を制限する

    ジョブ権限は、ジョブを表示、実行、または管理できるユーザーを制御します。

    • ジョブ構成を表示したり、ランを監視したりするユーザーには、CAN VIEW アクセス許可が必要です。
    • ジョブのランをTriggerする、停止、または再開するユーザーには、CAN MANAGE RUN権限が必要です。
    • CAN EDIT、CAN MANAGE、またはIS OWNERの権限は、本番運用コードの変更を任せられるユーザーにのみ付与してください。

ジョブへのアクセスの制御​

ジョブのアクセス制御により、ジョブの所有者と管理者は、ジョブに対するきめ細かな権限を付与できます。 次の権限を使用できます。

注記

各アクセス許可には、次の表の下位にあるアクセス許可の付与が含まれています。

権限

権限

IS OWNER

デフォルトで 「実行」 に使用される ID。これを上書きするには、「 実行ユーザー」を 設定できます。

CAN MANAGE

構成、タスク、権限などのジョブ定義を編集できます。スケジュールを停止したり再開したりできます。

CAN EDIT (ベータ版)

ジョブの設定とタスクを編集できますが、実行IDの変更、ジョブの削除、権限の管理はできません。ワークスペースフォルダー内のジョブでのみ使用できます。フォルダーによるジョブとパイプラインの共有をご覧ください。

CAN MANAGE RUN

ジョブの実行をトリガーおよびキャンセルできます。

CAN VIEW

詳細、履歴、ステータスなどのジョブ実行結果を表示できます。

権限

権限

IS OWNER

デフォルトで 「実行」 に使用される ID。これを上書きするには、「 実行ユーザー」を 設定できます。

CAN MANAGE

構成、タスク、権限などのジョブ定義を編集できます。スケジュールを停止したり再開したりできます。

CAN EDIT (ベータ版)

ジョブの設定とタスクを編集できますが、実行IDの変更、ジョブの削除、権限の管理はできません。ワークスペースフォルダー内のジョブでのみ使用できます。フォルダーによるジョブとパイプラインの共有をご覧ください。

CAN MANAGE RUN

ジョブの実行をトリガーおよびキャンセルできます。

CAN VIEW

詳細、履歴、ステータスなどのジョブ実行結果を表示できます。

  • ジョブの作成者には、デフォルトで IS OWNER 権限があります。
  • 1つのジョブに複数の所有者を設定することはできません。
  • グループには、所有者として IS OWNER 権限を割り当てることはできません。
  • 「今すぐ実行」 によってトリガーされたジョブは、 「今すぐ実行」 を発行したユーザー ではなく、「実行 ユーザー (デフォルトでは所有者)」の権限を想定します。
  • ジョブのアクセス制御は 、ジョブとパイプラインの UI に表示されるジョブとその実行に適用されます。以下の場合には適用されません。
    • モジュール化されたコードまたはリンクされたコードを実行するノートブック ワークフロー。これらは、ノートブック自体のアクセス許可を使用します。ノートブックが Git から取得された場合、新しいコピーが作成され、そのファイルは実行をトリガーしたユーザーのアクセス許可を継承します。

    • API によって送信されたジョブ。これらは、API リクエストで access_control_list を明示的に設定しない限り、ノートブックのデフォルトのアクセス許可を使用します。

ジョブのアクセス許可レベルについては、「 ジョブ ACL」を参照してください。

ジョブのアクセス許可を構成する​

ワークスペース UI でジョブのアクセス許可を構成するには、次の手順を使用して既存のジョブを選択します。

  1. Databricks ワークスペースのサイドバーで、[ ジョブとパイプライン] をクリックします。
  2. 必要に応じて、[ ジョブ ] と [自分が所有] フィルターを選択します。
  3. ジョブ の [名前 ] リンクをクリックします。
  4. ジョブの詳細 ペインで、 アクセス許可の編集 をクリックします。 権限設定 ダイアログが表示されます。
  5. ユーザー、グループ、サービスプリンシパルの選択 フィールドをクリックし、ユーザー、グループ、またはサービスプリンシパルの入力を開始します。このフィールドでは、ワークスペースで使用可能なすべての ID が検索されます。
  6. [ 追加 ] をクリックします。
  7. [ 保存 ]をクリックします。

既存の権限を変更または削除するには、 [アクセス許可の編集] をクリックして [権限設定] ダイアログを開きます。権限を変更するには、識別情報の横にあるドロップダウンで別のレベルを選択します。権限を削除するには、識別情報の横にある x をクリックします。

ジョブの所有者を管理する​

ジョブのオーナーを編集できるのは、ワークスペースの管理者のみです。 ジョブ所有者は 1 つだけ割り当てる必要があります。 ジョブの所有者は、ユーザーまたはサービスプリンシパルです。

ノートブックタスクとAPIアクセス​

UI を介してノートブック タスクを実行する場合、ユーザーが基礎となるノートブックにアクセスできる場合にのみ、出力 (ノートブック内) にアクセスできます。ただし、同じジョブを API 経由で実行すると、API ユーザーがノートブックではなくジョブ自体にのみアクセスできる場合でも、実行出力は API に表示されます。