UiPath Documentation
integration-service
latest
false
Integration Service ユーザー ガイド
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。 Integration Service で提供されるコネクタ パッケージの一部は機械翻訳で処理されています。 新しいコンテンツの翻訳は、およそ 1 ~ 2 週間で公開されます。

Databricks の認証

OAuth 2.0 クライアント資格情報と Databricks OAuth サービス プリンシパルまたは Microsoft Entra ID サービス プリンシパルを使用して、UiPath を Databricks ワークスペースに接続します。

前提条件​

Databricks コネクタは、OAuth 2.0 クライアント資格情報 (マシン間) を使用してサービス プリンシパルとして認証します。次の 2 種類のサービス プリンシパルがサポートされています。

  • Databricks の OAuth サービス プリンシパル。Databricks アカウント コンソールで管理されます。
  • Azure Databricks ワークスペース用の Microsoft Entra ID サービス プリンシパル。

コネクションを作成するには、次の値が必要です。

フィールド説明
ワークスペース ホストワークスペースのホスト名のみで、 https:// や末尾にスラッシュを入れないたとえば、 adb-1234567890123456.7.azuredatabricks.netです。
クライアント IDサービス プリンシパルのアプリケーション ID (UUID)。
クライアント シークレットそのサービス プリンシパルに対して生成された OAuth シークレット。これは個人用アクセス トークンではありません。
OAuth トークン URLトークン エンドポイント。既定値は https://{workspace.host}/oidc/v1/tokenです。
OAuth スコープ要求されるスコープ。既定値は all-apisです。

資格情報を取得する​

  1. Databricks ワークスペースの URL から ワークスペース ホスト を抽出します。たとえば、 https://adb-1234567890123456.7.azuredatabricks.net/browse/folders/workspaceでは、ワークスペース ホストは adb-1234567890123456.7.azuredatabricks.netです。

  2. Databricks アカウント コンソールで、[ ユーザー管理] > [サービス プリンシパル ] に移動し、サービス プリンシパルを作成するか、既存のサービス プリンシパルを選択します。

  3. サービス プリンシパルの アプリケーション ID (UUID) — クライアント ID をコピーします。

  4. サービス プリンシパルで、[ シークレット] > [シークレットを生成] に移動し 、生成された OAuth シークレット (これが クライアント シークレット) をコピーします。シークレットは一度だけ表示されます。

    重要:

    個人用アクセス トークンではなく、OAuth シークレットを使用します。このコネクタでは、個人用アクセス トークンはサポートされていません。

  5. ワークスペースと、オートメーションで使用するすべてのオブジェクト (SQL ウェアハウス、ジョブ、Unity Catalog のセキュリティ保護対象ファイル、ボリューム、Genie スペース、ベクトル検索インデックスなど) へのアクセス権をサービス プリンシパルに付与します。

詳しくは、Databricks のドキュメントの「 OAuth マシン間 (M2M) 認証」 と「 サービス プリンシパルを管理する」 をご覧ください。

注:

既定の [OAuth スコープ ] は all-apis で、トークンはサービス プリンシパルが承認されているすべての API に到達できます。Databricks では、スコープ付き OAuth シークレットもサポートしています。これは、シークレットを sql、 jobs、 unity-catalogなどの特定の API スコープのセットに制限します。スコープを使用する場合でも、スコープはオートメーションが呼び出すすべての Databricks API をカバーする必要があります。そうしないと、それらのアクティビティは実行時に失敗します。

Databricks コネクションを追加する​

  1. 製品ランチャーから [Orchestrator] を選択します。

  2. フォルダーを選択して [ コネクション ] タブに移動します。

  3. [ コネクションを追加] を選択します。

  4. コネクション作成ページを開くには、リストからコネクタを選択します。検索バーを使用してコネクタを検索できます。

  5. [ ワークスペース ホスト]、[ クライアント ID]、[ クライアント シークレット] を入力します。

    利用可能な場合は、フィールドの横にあるメニューを選択し、[ 資格情報アセットを使用 ] または [ Orchestrator アセットを使用 ] を選択して、値を直接入力するのではなく Orchestrator アセットを参照します。詳細については、「 コネクションに資格情報アセットを使用する」をご覧ください。

    Microsoft Entra ID のサービス プリンシパルを使用している場合は、「 Microsoft Entra ID のサービス プリンシパルを使用する 」の説明に従って、 OAuth トークン URL と OAuth スコープ を更新します。それ以外の場合は、両方のフィールドを既定値のままにします。

  6. [接続] を選択します。

これで Databricks のコネクションが追加され、UiPath Studio または Studio Web で使用できるようになりました。

Microsoft Entra ID のサービス プリンシパルを使用する​

Databricks の OAuth サービス プリンシパルではなく Microsoft Entra ID のサービス プリンシパルで認証する場合は、[OAuth トークン URL] と [OAuth スコープ] を以下のように変更します。

  1. OAuth トークン URL を完全に Microsoft ID プラットフォームのトークン エンドポイントに置き換えます。

    https://login.microsoftonline.com/{your-azure-tenant-guid}/oauth2/v2.0/token
    https://login.microsoftonline.com/{your-azure-tenant-guid}/oauth2/v2.0/token
    
    重要:

    リテラルな Azure テナントの GUID を URL に置き換えます。プレースホルダー {your-azure-tenant-guid} ままにしないでください。

  2. [ OAuth スコープ] を Azure Databricks リソース ID に設定し、その後に /.defaultを設定します。

    2ff814a6-3304-4ab8-85cb-cd0e6f879c1d/.default
    2ff814a6-3304-4ab8-85cb-cd0e6f879c1d/.default
    
    注:

    トークン URL のテナント GUID とは異なり、この GUID はプレースホルダーではありません。2ff814a6-3304-4ab8-85cb-cd0e6f879c1d は、すべての Azure 環境における Azure Databricks の固定識別子であるため、図のように正確に入力してください。

詳しくは、Azure Databricks のドキュメントの「 Microsoft Entra ID トークンを手動で取得する」 と「Microsoft Entra サービス プリンシパルで認証 する」をご覧ください。

注:

コネクションの機能は、その背後にあるサービス プリンシパルによって決まります。コネクションは正常に作成されていても、アクティビティの対象のオブジェクトに対する権限がない場合は、実行時に失敗する可能性があります。

このページは役に立ちましたか?

接続

ヘルプ リソース サポート(opens in new window)

学習する UiPath アカデミー(opens in new window)

質問する UiPath フォーラム(opens in new window)

最新情報を取得