1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

⚡Databricks Agent Engineering入門⚡ Unity Catalog Connectionとは?外部DB・API・MCPへの安全な接続設計

1
Posted at

3-3 Connectionで外部システムとつなぐ.png

📚 参考書籍

※この記事は書籍の一部をベースに再構成しています。もう少し踏み込んだ内容(設計や具体例)は書籍の中でまとめているので、気になる方はそちらもどうぞ。

####『ゼロから触ってわかった!AI Agent Observability入門― MLflow・Databricksで実践するAIエージェントの評価・監視・安全性・説明可能性』
本書は、AI Agentを「作って動かす」だけでなく、その品質をどう観測し、どう評価し、どう守り、どう説明可能にするかを体系的に学ぶための入門書です。
https://link.amazon/B04VaTlR3

📚 その他参考書籍一覧

※全書籍・全ブログ・週刊Databricksリリース情報
https://modern-tech-hub.mellow-launc-5442.chatgpt.site/books

⚡Databricks Agent Engineering入門⚡ Unity Catalog Connectionとは?外部DB・API・MCPへの安全な接続設計

AI GatewayがAgentのAI利用を統制する一方、外部DBやAPIの接続先・認証情報を管理するのがUnity Catalog Connectionです。

1. Connectionとは何か?

Connectionは、外部システムの接続先・認証情報・設定をUnity Catalogで管理するセキュリティ保護可能なオブジェクトです。

APIキーをAgentへ直書きすると、キー更新やAgent追加のたびに修正が必要です。

Agent / Tool → Connection → 外部システム

**「どう接続するか」と「何を実行するか」**を分離できます。

2. 外部データベースにはLakehouse Federation

ConnectionはPostgreSQL、MySQL、SQL Server、Oracle、Snowflakeなどにも対応します。

Lakehouse FederationのQuery Federationでは、主に次のように構成します。

  • Connection:ホスト・認証情報・接続設定を管理
  • Foreign Catalog:外部DBのテーブルをUnity Catalog経由で公開
  • Agent / SQL:許可されたテーブルを参照

外部データの複製なしで読み取りクエリを実行でき、Foreign Catalogの権限も別途必要です。

3. REST API・MCPにはHTTP Connection

HTTP Connectionは外部HTTPサービスの接続先と資格情報を管理します。

  • CRMやチケット管理のREST API
  • 社内業務API
  • 外部MCPサーバー

Bearer TokenやOAuthなどの認証方式に対応します。

2026年11月現在、Schema単位はGA、Metastore単位はPublic Previewです。

外部MCPサーバーはHTTP Connectionを作成後、Unity GatewayへMCP Serviceとして登録し、公開されたToolを利用します。

4. USE CONNECTIONで利用者を制限する

Connectionは作成しただけですべてのAgentから使えるわけではありません。

HTTP Connectionを利用するユーザーやDatabricks AppsのService Principalには、必要に応じてUSE CONNECTIONを付与します。

GRANT USE CONNECTION
ON CONNECTION crm_api
TO `agent_app_sp`;

※接続名・主体名は例です。Foreign Catalogの作成ではCREATE FOREIGN CATALOGなど、用途によって必要な権限が異なります。

例えば、営業AgentにはCRM接続を許可し、文書作成Agentには許可しない設計ができます。

5. Connection ProxyでSecretを渡さない

外部REST APIには、DatabricksのHTTP Connection Proxyを利用できます。

Agent → Databricks認証 → Connection Proxy → 外部API

AgentはDatabricksへ認証し、Proxyが外部サービス用資格情報を付与します。

外部APIキーをAgentに持たせずに済みます。ただし通信先の制限にはネットワークポリシーも必要です。

6. Connection・Tool・Skillの違い

混同しやすい3つの役割を整理します。

要素 主な役割
Connection どこへ・どう認証して接続するか
Tool 接続先で何を実行できるか
Skill Toolをどう組み合わせて業務を進めるか

CRM接続だけでは顧客検索はできません。検索操作をToolに、業務手順をSkillに定義します。

まとめると

  • Connectionで接続情報と認証情報を共通管理する
  • 外部DBはForeign Catalogと組み合わせて参照する
  • REST APIや外部MCPはHTTP Connectionを利用する
  • USE CONNECTIONなどで利用主体を制限する
  • Connection Proxyで資格情報の直接配布を減らす

ConnectionはAgentの能力ではなく、安全な外部接続の土台です。共有資産化すれば、Agentが増えても管理を集約できます。

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?