ユーザーを管理する
この記事では、Databricksユーザーを追加、更新、削除する方法について説明します。
Databricks ID モデルの概要については、 「Databricks ID」を参照してください。
ユーザーのアクセスを管理するには、「 認証とアクセス制御」を参照してください。
ユーザー管理の概要
Databricksでユーザーを管理するには、アカウント管理者またはワークスペース管理者のいずれかである必要があります。
アカウント管理者は、アカウントにユーザーを追加し、管理者ロールを割り当てることができます。 また、ワークスペースがID フェデレーションを使用している限り、ユーザーをワークスペースに割り当て、ワークスペース間でユーザーのデータ アクセスを構成することもできます。
ワークスペース管理者は、 Databricksワークスペースにユーザーを追加し、ワークスペース管理者ロールを割り当て、クラスターの作成機能や指定されたペルソナベースの環境へのアクセス機能など、ワークスペース内のオブジェクトや機能へのアクセスを管理できます。 Databricks ワークスペースにユーザーを追加すると、そのユーザーはアカウントにも追加されます。
ワークスペース管理者は、ワークスペース内の
admins
グループのメンバーであり、削除できない予約済みグループです。
重要
Databricks は、2024 年 3 月 6 日に ID フェデレーションと Unity Catalog の新しいワークスペースを自動的に有効にし始め、アカウント全体で徐々にロールアウトが進められています。 ワークスペースで ID フェデレーションがデフォルトで有効になっている場合、無効にすることはできません。 詳細については、「Unity Catalogの自動有効化」を参照してください。
IDプロバイダーからユーザーをDatabricksアカウントに同期する
アカウント管理者は、SCIMプロビジョニングコネクターを使用すると、IDプロバイダー(IdP)のユーザーをDatabricksのアカウントと同期できます。
重要
ID をワークスペースに直接同期する SCIM コネクタが既にある場合は、アカウント レベルの SCIM コネクタが有効になっているときに、それらの SCIM コネクタを無効にする必要があります。 「ワークスペース レベルの SCIM プロビジョニングをアカウント レベルに移行する」を参照してください。
手順については、「 ユーザーとグループを Databricks アカウントに同期する」を参照してください。
アカウント内のユーザーを管理する
アカウント管理者は 、アカウント コンソールDatabricks を使用して にユーザーを追加できます。Databricksのユーザーには、ワークスペース、データ、またはコンピュートリソースへのデフォルト アクセス権はありません。
アカウントコンソールを使用してアカウントにユーザーを追加する
アカウント管理者として、アカウントコンソールにログインします。
サイドバーで、[ユーザー管理] をクリックします。
[ユーザー]タブで、[ユーザーの追加]をクリックします。
ユーザーの名前とメールアドレスを入力します。
[ユーザーを追加]をクリックします。
注:
ユーザーは50を超えるDatabricksアカウントに所属することはできません。
ユーザーにワークスペースへのアクセス権を付与するには、ユーザーをワークスペースに追加する必要があります。 「ワークスペース内のユーザーを管理する」を参照してください。
アカウント管理者のロールをユーザーに割り当てる
アカウント管理者として、アカウントコンソールにログインします。
サイドバーで、[ユーザー管理] をクリックします。
ユーザー名を見つけてクリックします。
[ロール] タブで、[Marketplace管理者] または [アカウント管理者] をオンにします。
アカウントコンソールを使用してユーザーをワークスペースに割り当てる
アカウント コンソールを使用してワークスペースにユーザーを追加するには、ワークスペースで ID フェデレーションが有効になっている必要があります。 ワークスペース管理者は、ワークスペース管理者設定ページを使用して、ユーザーをワークスペースに割り当てることもできます。 「ワークスペース管理設定ページを使用してユーザーをワークスペースに割り当てる」を参照してください。
アカウント管理者として、アカウントコンソールにログインします。
サイドバーで、[ワークスペース] をクリックします。
ワークスペース名をクリックします。
[権限] タブで、[権限を追加] をクリックします。
ユーザーを検索して選択し、権限レベル(ワークスペースユーザーまたは管理者)を割り当て、[保存]をクリックします。
アカウントコンソールを使用してワークスペースからユーザーを削除する
アカウント コンソールを使用してワークスペースからユーザーを削除するには、ワークスペースで ID フェデレーションが有効になっている必要があります。 ユーザーがワークスペースから削除されると、そのユーザーはワークスペースにアクセスできなくなりますが、ユーザーの権限は維持されます。 ユーザーが後でワークスペースに再度追加された場合、以前の権限が回復されます。
アカウント管理者として、アカウントコンソールにログインします
サイドバーで、[ワークスペース] をクリックします。
ワークスペース名をクリックします。
[権限]タブでユーザーを見つけます。
ユーザー行の右端にあるケバブメニューをクリックし、[削除] を選択します。
確認ダイアログで、[削除の確認]をクリックします。
Databricksアカウントのユーザーを非アクティブ化する
アカウント管理者は、Databricksアカウント全体でユーザーを非アクティブ化できます。非アクティブ化されたユーザーは、Databricksアカウントまたはワークスペースにログインできません。ただし、ユーザーの権限とワークスペースオブジェクトはすべて変更されません。ユーザーが非アクティブ化されると、次のようになります。
ユーザーは、どの方法でもアカウントまたはワークスペースにログインできません。
このユーザーによって生成されたトークンを使うアプリケーションまたはスクリプトはDatabricks APIにアクセスできなくなります。トークンは残りますが、ユーザーが非アクティブ化されている間は認証には使用できません。
ユーザーが所有するノートブックは残ります。
ユーザーが所有するクラスターは引き続き実行されます。
ユーザーによって作成されたスケジュールジョブは、失敗を防ぐために新しい所有者に割り当てる必要があります。
ユーザーが再アクティブ化されると、同じ権限で Databricks にログインできます。 Databricks では、ユーザーを削除することは破壊的なアクションであるため、ユーザーを削除するのではなく、アカウントから非アクティブ化することをお勧めします。 非アクティブ化されたユーザーのステータスは、アカウントコンソールで 「非アクティブ 」と表示されます。 また、特定のワークスペースからユーザーを非アクティブ化することもできます。 「Databricks ワークスペースでユーザーを非アクティブ化する」を参照してください。
アカウントコンソールを使用してユーザーを非アクティブ化することはできません。 代わりに、アカウント Users API.例えば:
curl --netrc -X PATCH \
https://${DATABRICKS_HOST}/api/2.1/accounts/{account_id}/scim/v2/Users/{id} \
--header 'Content-type: application/scim+json' \
--data @update-user.json \
| jq .
update-user.json
:
{
"schemas": [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ],
"Operations": [
{
"op": "replace",
"path": "active",
"value": [
{
"value": "false"
}
]
}
]
}
Databricksアカウントからユーザーを削除する
アカウント管理者は、Databricksアカウントからユーザーを削除できます。ワークスペース管理者にはその権限がありません。アカウントからユーザーを削除すると、そのユーザーはワークスペースからも削除されます。
重要
ユーザーをアカウントから削除すると、IDフェデレーションが有効になっているかどうかに関係なく、ワークスペースからもそのユーザーが削除されます。アカウント内のすべてのワークスペースにアクセスできなくする場合を除き、ユーザーのアカウントレベルの削除は避けることを推奨します。ユーザーを削除すると次のような影響が生じることに注意してください。
このユーザーによって生成されたトークンを使うアプリケーションまたはスクリプトはDatabricks APIにアクセスできなくなります。
ユーザーが所有するジョブは失敗になります。
ユーザーが所有するクラスターが停止します。
このユーザーによって作成された、[所有者として実行] 資格情報を使用して共有されているクエリーまたはダッシュボードは、共有が失敗しないように新しい所有者に割り当てる必要があります。
ユーザーがアカウントから削除されると、そのユーザーはアカウントやワークスペースにアクセスできなくなりますが、ユーザーの権限は維持されます。 後でユーザーがアカウントに再度追加された場合、以前の権限が回復されます。
アカウントコンソールを使ってユーザーを削除するには、次の手順を実行します。
アカウント管理者として、アカウントコンソールにログインします。
サイドバーで、[ユーザー管理] をクリックします。
ユーザー名を見つけてクリックします。
[ユーザー情報]タブで、右上にあるケバブメニューをクリックし、[削除]を選択します。
確認ダイアログで、[削除の確認]をクリックします。
アカウントコンソールを使用してユーザーを削除する場合は、そのアカウントに設定されているSCIMプロビジョニングコネクタまたはSCIM APIアプリケーションを使用してユーザーも削除する必要があります。これを行わない場合、SCIMプロビジョニングは次回の同期時にユーザーを追加し直します。「IDプロバイダーのユーザーとグループの同期」を参照してください。
を使用して Databricksアカウントからユーザーを削除するには、アカウント管理者である必要があります。SCIMAPIsユーザーとグループをDatabricksアカウントと同期する および アカウント グループ APIを参照してください。
ワークスペース内のユーザーを管理する
ワークスペース管理者は、ワークスペース管理者設定ページを使用してユーザーを追加および管理することができます。
ワークスペース管理設定ページを使用してユーザーをワークスペースに割り当てる
ワークスペース管理設定ページを使用してワークスペースにユーザーを追加するには、以下の手順を実行します。
ワークスペース管理者として、Databrickワークスペースにログインします。
Databricks ワークスペースの上部バーにあるユーザー名をクリックし、 [設定]を選択します。
[IDとアクセス]タブをクリックします。
「ユーザー」の横にある「管理」をクリックします。
[ユーザーを追加]をクリックします。
ワークスペースに割り当てる既存のユーザーを選択するか、 「新規追加」をクリックして新しいユーザーを作成します。
[追加] をクリックします。
Databricks 確認メールを送信します。 5分以内に確認メールが届かない場合は、迷惑メールフォルダの確認を依頼してください。 ワークスペースに新しいユーザーを追加すると、そのユーザーは Databricks アカウントにも追加されます。
注:
ワークスペースでID フェデレーションが有効になっていない場合は、ワークスペースに新しいユーザーを追加するオプションのみが表示されます。 既存のアカウントユーザーとユーザー名(Eメールアドレス)を共有するユーザーを追加すると、それらのユーザーは統合されます。
注:
ワークスペースREST APIsの Google ID 認証を有効にするには、ワークスペースのユーザーとしてGoogle サービス アカウントE メール アドレスを追加します。 Google ID トークンによる認証をご覧ください。 Google サービス アカウント アドレスを使用して Web アプリケーションにログインすることはできません。 サービス アカウント をユーザーとして追加することは、 Databricksアカウント として追加することとは異なります。 Google サービス アカウントの E メール アドレスをワークスペースのユーザーとして追加すると、 Databricks招待通知の E メールを送信しません。
ワークスペース管理設定ページを使用してワークスペース管理者ロールをユーザーに割り当てる
ワークスペース管理者設定ページを使用してワークスペース管理者ロールを割り当てるには、次の手順を実行してください。
ワークスペース管理者として、Databrickワークスペースにログインします。
Databricks ワークスペースの上部バーにあるユーザー名をクリックし、 [設定]を選択します。
[IDとアクセス]タブをクリックします。
「ユーザー」の横にある「管理」をクリックします。
ユーザーを選択します。
[権限] タブをクリックします。
[管理者アクセス]の横にあるトグルをクリックします。
ワークスペース ユーザーからワークスペース管理者ロールを削除するには、同じ手順を実行しますが、管理者アクセスの切り替えをオフにします。
Databricksワークスペースでユーザーを非アクティブ化します
ワークスペース管理者は、Databricksワークスペース内のユーザーを非アクティブ化できます。非アクティブ化されたユーザーは、ワークスペースにログインしたり、Databricks APIからワークスペースにアクセスしたりすることはできませんが、ユーザーのすべての権限とワークスペースオブジェクトは変更されません。ユーザーが非アクティブ化されると、次のようになります。
ユーザーはどの方法でもワークスペースにログインできません。
ワークスペース管理者設定ページでは、ユーザーのステータスが非アクティブとして表示されます。
このユーザーによって生成されたトークンを使うアプリケーションまたはスクリプトはDatabricks APIにアクセスできなくなります。トークンは残りますが、ユーザーが非アクティブ化されている間は認証には使用できません。
ユーザーが所有するノートブックは残ります。
ユーザーが所有するクラスターは引き続き実行されます。
ユーザーによって作成されたスケジュールジョブは、失敗を防ぐために新しい所有者に割り当てる必要があります。
ユーザーが再アクティブ化されると、同じ権限でワークスペースにログインできます。 Databricks では、ユーザーを削除することは破壊的なアクションであるため、ユーザーを削除するのではなく非アクティブ化することをお勧めします。 ワークスペースの管理者設定ページを使用してユーザーを非アクティブ化することはできません。 代わりに、ワークスペース Users API.例えば:
curl --netrc -X PATCH \
https://<databricks-instance>/api/2.0/preview/scim/v2/Users/<user-id> \
--header 'Content-type: application/scim+json' \
--data @update-user.json \
| jq .
update-user.json
:
{
"schemas": [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ],
"Operations": [
{
"op": "replace",
"path": "active",
"value": [
{
"value": "false"
}
]
}
]
}
ワークスペース管理者設定ページを使用してワークスペースからユーザーを削除する
ユーザーがワークスペースから削除されると、そのユーザーはワークスペースにアクセスできなくなりますが、ユーザーの権限は維持されます。 ユーザーが後でワークスペースに再度追加された場合、以前の権限が回復されます。
ワークスペース管理者として、Databrickワークスペースにログインします。
Databricks ワークスペースの上部バーにあるユーザー名をクリックし、 [設定]を選択します。
[IDとアクセス]タブをクリックします。
「ユーザー」の横にある「管理」をクリックします。
ユーザー行の右端にあるユーザーと ケバブのメニューを見つけて、[ 削除] を選択します。
[削除] をクリックして確定します。
APIを使用してユーザーを管理する
アカウント管理者とワークスペース管理者は、Databricks APIを使用してDatabricksアカウントとワークスペースのユーザーを管理できます。
APIを使用してアカウント内のユーザーを管理する
管理者は、アカウントユーザーAPIを使用して、Databricksアカウントにユーザーを追加し、管理できます。アカウント管理者とワークスペース管理者は、別のエンドポイントURL使用してAPIを呼び出します:
アカウント管理者は
{account-domain}/api/2.1/accounts/{account_id}/scim/v2/
を使用します。ワークスペース管理者は
{workspace-domain}/api/2.0/account/scim/v2/
を使用します。
詳細については、アカウント ユーザー APIを参照してください。
APIを使用してワークスペース内のユーザーを管理する
アカウント管理者とワークスペース管理者は、ワークスペース割り当てAPIを使用して、IDフェデレーションが有効になっているワークスペースにユーザーを割り当てることができます。ワークスペース割り当てAPIは、Databricksアカウントとワークスペースを介してサポートされます。
アカウント管理者は
{account-domain}/api/2.0/accounts/{account_id}/workspaces/{workspace_id}/permissionassignments
を使用します。ワークスペース管理者は
{workspace-domain}/api/2.0/preview/permissionassignments/principals/{user_id}
を使用します。
「ワークスペース割り当てAPI」を参照してください。
ワークスペースでIDフェデレーションが有効になっていない場合、ワークスペース管理者はワークスペースレベルのAPIを使用してユーザーをワークスペースに割り当てることができます。「ワークスペースユーザー API」を参照してください。