次の方法で共有

Databricks Git フォルダーでの自動化にサービス プリンシパルを使用する

Azure Databricks アカウント コンソールまたは Databricks CLI を使用して、ワークスペースの Git フォルダーにアクセスする権限を持つサービス プリンシパルを作成できます。

新しいサービス プリンシパルを作成するには、「 サービス プリンシパル」を参照してください。 ワークスペースにサービス プリンシパルがある場合は、Git 資格情報をそれにリンクして、自動化の一部としてワークスペースの Git フォルダーにアクセスできます。

Git フォルダーにアクセスするためのサービス プリンシパルを許可する

Azure Databricks アカウント コンソールを使用して、サービス プリンシパルの Git フォルダーへの承認されたアクセスを提供するには:

  1. Azure Databricks ワークスペースにログインします。 これらの手順を完了するには、ワークスペースに対する管理者特権が必要です。 ワークスペースの管理者特権がない場合は、ワークスペースを要求するか、アカウント管理者に問い合わせてください。

  2. ページの右上隅にあるユーザー名をクリックし、[設定] 選択します。

  3. 左側のナビゲーション ペインで [ワークスペース管理者] を選択し、その後 [ID とアクセス] を選択します。その後、[サービス プリンシパル] の [管理] ボタンを選択します。

    ワークスペース設定の [サービス プリンシパル] ページ

  4. サービス プリンシパルの一覧から、Git 資格情報で更新するサービス プリンシパルを選択します。 新しいサービス プリンシパルを作成するには、[サービス プリンシパルの追加]を選択することもできます。

    Databricks アカウント コンソールを使用したサービス プリンシパルの作成または追加

  5. [Git 統合] タブを選択します (サービス プリンシパルを作成しなかった場合、またはサービス プリンシパル マネージャー特権が割り当てられていない場合は、グレー表示されます)。その下で、資格情報の Git プロバイダー (GitHub など) を選択し、[Git アカウントのリンク] を選択して、[リンク] を選択します。

    独自の Git 資格情報をリンクしない場合は、Git 個人用アクセス トークン (PAT) を使用することもできます。 代わりに PAT を使用するには、[ 個人用アクセス トークン ] を選択し、サービス プリンシパルのアクセスを認証するときに使用する Git アカウントのトークン情報を指定します。 Git プロバイダーから PAT を取得する方法の詳細については、「リモート リポジトリを Azure Databricksに接続 & Git 資格情報を構成する」を参照してください。

    Git 資格情報を Databricks サービス プリンシパル にリンクする

  6. リンクする Git ユーザー アカウントを選択するように求められます。 サービス プリンシパルがアクセスに使用する Git ユーザー アカウントを選択し、[続行] 選択します。 (使用するユーザー アカウントが表示されない場合は、[別のアカウント使用] を選択します)。

  7. 次のダイアログで、「Databricksの承認」を選択します。 メッセージ "アカウントのリンク中..." がしばらく表示された後、 更新されたサービス プリンシパルの詳細が表示されます。

    正常にリンクされた Git 資格情報の確認画面

選択したサービス プリンシパルは、自動化の一部として Azure Databricks ワークスペースの Git フォルダー リソースにアクセスするときに、リンクされた Git 資格情報を適用するようになりました。

API を使用する

Databricks ノートブック セル内から任意の Databricks REST API を呼び出すには、最初に Databricks SDK を %pip install databricks-sdk --upgrade (最新の Databricks REST API 用) でインストールし、その後 ApiClient から databricks.sdk.core をインポートします。

注

%pip install databricks-sdk --upgradeが "パッケージが見つかりませんでした" というエラーを返した場合、databricks-sdk パッケージは以前にインストールされていません。 --upgrade フラグを指定せずにコマンドを再実行します: %pip install databricks-sdk。

また、ノートブックから Databricks SDK API を実行して、ワークスペースのサービス プリンシパルを取得することもできます。 Python と Databricks SDK for Python の使用例を次に示します。

curlや Terraform などのツールを使用することもできます。 Azure Databricks ユーザー インターフェイスを使用することはできません。

Azure Databricks のサービス プリンシパルの詳細については、「 サービス プリンシパル」を参照してください。 サービス プリンシパルと CI/CD の詳細については、「CI/CD のサービス プリンシパル」を参照してください。 ノートブックから Databricks SDK を使用することに関する詳細については、「Databricks ノートブックから Databricks SDK for Python を使用する」を参照してください。