HTTP接続を持つUnity Catalog関数ツール

Note

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

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

Requirements

外部サービス用のUnity Catalog HTTP接続 。 http_request()関数のconnパラメータで名前で参照してください。

関数ツールを作成します http_request()

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

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) を参照してください。

Note

http_requestを使用した SQL アクセスは、ユーザーごとのユーザー間接続と動的クライアント登録接続の種類に対してブロックされます。 代わりに Python Azure Databricks SDK を使用してください。

  • Last updated on