Strumenti di funzione del Catalogo Unity con connessione HTTP

Nota

Per connettere gli agenti a servizi esterni, Azure Databricks consiglia i servizi MCP o il proxy di connessioni del catalogo Unity. Gli strumenti di funzione UC che eseguono il wrapping http_request rimangono supportati, ma non sono più l'approccio consigliato.

È possibile creare una funzione di Unity Catalog che incapsula http_request() per chiamare servizi esterni. Questo approccio è utile per le definizioni degli strumenti basate su SQL.

Requisiti

Una connessione HTTP Unity Catalog per il servizio esterno. Riferiscilo per nome nel http_request() parametro della conn funzione.

Crea uno strumento funzionale con http_request()

L'esempio seguente crea uno strumento funzione catalogo Unity che invia un messaggio a 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

Vedere CREATE FUNCTION (SQL, Python, Scala e Java).

Nota

L'accesso SQL con http_request è bloccato per i tipi di connessione User-to-Machine Per User e Registrazione Dinamica del Client. Usare invece Python Azure Databricks SDK.