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

Databricks コネクタについて

Automation Cloud の Databricks ワークスペース REST API 用の Integration Service コネクタ。ジョブ、ノートブック、Unity Catalog ボリューム、Genie、ベクトル検索をサポートします。

注:

Databricks コネクタはプレビュー機能として利用できます。

REST API 経由で Databricks ワークスペースを自動化し、ノートブック ジョブの実行の送信と監視、Unity Catalog のボリュームと関数の管理、ノートブックのインポートとエクスポート、Genie との会話などを行います。

サポートされているクラウドバージョン​

Databricks コネクタは、AWS、Google Cloud Platform、Azure クラウドの Databricks をサポートします。

注:

このコネクタは、UiPath Maestro TM から Databricks エージェントをトリガーするために使用される Databricks エージェント コネクタとは別です。Databricks コネクタは、一般的なワークスペースの自動化に使用します。

認証​

プロセスの自動化を行う前に、Databricks ワークスペースとのコネクションを確立する必要があります。コネクタは、OAuth 2.0 クライアント資格情報 (マシン間) を使用して、Databricks OAuth サービス プリンシパルまたは Microsoft Entra ID サービス プリンシパルのいずれかで、サービス プリンシパルとして認証します。

詳しい手順については、「 Databricks の認証 」をご覧ください。

イベント​

このコネクタはイベントをサポートしていません。

Activities (アクティビティ)​

コネクションを使用して、データのクエリ、ジョブとノートブックのオーケストレーション、ボリューム ファイルの管理、Genie との会話を行うオートメーションの構築を行うことができます。また、このコネクタには、事前定義済みのアクティビティではカバーされていないワークスペース API エンドポイントにアクセスするための Databricks [HTTP 要求 ] アクティビティも含まれています。

完全なリストについては、「 Databricks アクティビティ 」をご覧ください。

プロバイダーのドキュメント​

詳しくは、Databricks の公式ドキュメントをご覧ください。

既知の問題​

  • 関数オブジェクトにレコードを挿入 — Input Parameters は オブジェクトですが、既定のフィールド ビューでは文字列として送信されるため、呼び出しは失敗します。この問題の回避策としては、[ オブジェクト ビューに切り替え] を使用し、 入力パラメーターを オブジェクトとして渡します。オブジェクト ビューの詳細については、「 データ マッピング エディター」をご覧ください。

よくある質問​

どの Databricks 統合を使用すればよいですか?​

UiPath では、Databricks を使用する方法を 3 つ提供しています。自動化する内容に基づいて選択してください。

連携次の場合に使用します
Databricks (このコネクタ)Databricks ワークスペース自体を自動化します (ジョブのトリガーと監視、ノートブックのインポート、エクスポート、実行、Unity Catalog オブジェクトとボリューム ファイルの管理、Genie を使用した質問、ベクトル検索インデックスのクエリ)。
データベースの種類が Databricks の Database Hubテーブルレベルのデータ処理 (行の読み取り、挿入、更新と削除、およびカスタム SQL の実行) を実行します。Database Hub は Databricks をいくつかの JDBC データベースの 1 つとして扱うため、同じアクティビティが SQL Server、PostgreSQL、Oracle、Redshift に対しても機能します。また、[ レコードの作成時 ] イベントおよび [ レコードの更新時 ] イベントを通じて Databricks トリガーをサポートする唯一のオプションでもあります。
Databricks エージェント[ 外部エージェントを開始して待機] タスクを使用して、モデル サービング エンドポイントから UiPath Maestro TM のエージェンティック プロセスからサービスを提供する Databricks エージェントを呼び出します。

以下の表は、各連携でサポートされている機能を比較したものです。

Database HubDatabricks (プレビュー)Databricks エージェント
最適な用途表データジョブ、ノートブック、Genieエージェントを呼び出す
SQL とテーブル✅✅❌
レイクベース✅読み取り専用 1❌
Data Fabric ソース✅❌❌
ジョブ、ノートブック、ファイル、Unity Catalog、Genie、ベクトル検索❌✅❌
エージェントとサービング エンドポイント❌✅2✅
RelaySQL Server のみ❌❌
認証OAuth、PATOAuth、Microsoft Entra IDOAuth、PAT

1 Unity Catalog に登録されている Lakebase データベースは、[ SQL クエリの実行] を使用して SQL ウェアハウスを介してクエリできます。このアクセスは読み取り専用です。

2 サービング エンドポイントの呼び出し API を呼び出すことができる Databricks の [HTTP 要求 ] アクティビティを使用します。

この 3 つは独立しており、同じオートメーション内で並行して使用できます。

SQL クエリがタイムアウトしました。どうすればよいですか?​

SQL クエリを実行します 。[ 待機タイムアウト] で設定した時間だけ同期的に待機します。それより長い実行時間を持つステートメントの場合は、[ 待機タイムアウト] を [ 0s ] に、[ 待機タイムアウト時 ] を [ CONTINUE] に設定します。その後、このアクティビティはステートメント ID をすぐに返します。ステータスが SUCCEEDEDになるまで、[SQL ステートメントの結果を取得] を使用してポーリングできます。

コネクションは機能しているのに、アクティビティが権限エラーで失敗するのはなぜですか?​

コネクションはサービス プリンシパルとして認証されます。コネクションを作成すると、資格情報が有効であることが証明されるだけです。サービス プリンシパルには、SQL ウェアハウス、ジョブ、セキュリティで保護された Unity Catalog、ボリューム、Genie 空間、ベクトル検索インデックスなど、アクセスする各オブジェクトへのアクセス権も付与する必要があります。Databricks でこれらのアクセス許可を付与して、リトライします。

必要なエンドポイントは、どのアクティビティでもカバーされていません。どのような選択肢がありますか?​

[Databricks の HTTP 要求] アクティビティを使用します。このアクティビティは、同じ接続を使用して任意の Databricks ワークスペースの REST API エンドポイントを呼び出します。application/jsonのみを受け付け、ファイルのアップロードやダウンロードはサポートしていません。

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

接続

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

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

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

最新情報を取得