HTTP接続を使用するUnity Catalog関数ツール

注記

エージェントを外部サービスに接続するには、DatabricksはMCP ServicesまたはUnity Catalog接続プロキシを推奨します。http_requestをラップするUC関数ツールは引き続きサポートされますが、推奨されるアプローチではなくなりました。

外部サービスを呼び出すhttp_request()をラップするUnity Catalog関数を作成できます。このアプローチは、SQLベースのツールの定義に役立ちます。

要件

外部サービス用のUnity Catalog HTTP接続。http_request()関数のconnパラメーターで名前を指定して参照します。

次を使用して関数ツールを作成する http_request()

次の例は、Slackにメッセージを投稿するUnity Catalog関数ツールを作成します。

SQL

CREATE OR REPLACE FUNCTION main.default.slack_post_message(
  text STRING COMMENT 'message content'
)
RETURNS STRING
COMMENT 'Sends a Slack message by passing in the message and returns the response received from the external service.'
RETURN (http_request(
  conn => 'test_sql_slack',
  method => 'POST',
  path => '/api/chat.postMessage',
  json => to_json(named_struct(
    'channel', "C032G2DAH3",
    'text', text
  ))
)).text

CREATE FUNCTION (SQL、Python、Scala、および Java)をご覧ください。

注記

http_request を使用したSQLアクセスは、ユーザーごとのUser-to-Machineおよび動的クライアント登録接続タイプではブロックされます。代わりにPython Databricks SDKを使用してください。