Narzędzia funkcji katalogu Unity z połączeniem HTTP

Uwaga / Notatka

Aby połączyć agentów z usługami zewnętrznymi, Azure Databricks zaleca usługi MCP lub serwer proxy połączeń Unity Catalog. Narzędzia funkcji UC, które stanowią opakowanie dla http_request, pozostają obsługiwane, ale nie są już zalecanym rozwiązaniem.

Możesz utworzyć funkcję Unity Catalog, która opakowuje http_request() do wywołania usług zewnętrznych. Takie podejście jest przydatne w przypadku definicji narzędzi opartych na języku SQL.

Requirements

Połączenie HTTP w Unity Catalog dla usługi zewnętrznej. Odniesienie do niej po nazwie w http_request() parametrze funkcji conn .

Stwórz narzędzie funkcyjne z pomocą http_request()

Poniższy przykład tworzy funkcję katalogu Unity, która publikuje komunikat w usłudze Slack.

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

Zobacz CREATE FUNCTION (SQL, Python, Scala i Java).

Uwaga / Notatka

Dostęp SQL z http_request jest blokowany dla typów połączeń User-to-Machine Per User i Dynamic Client Registration. Zamiast tego użyj zestawu SDK Python Azure Databricks.