Outils de fonction du catalogue Unity avec connexion HTTP

Remarque

Pour connecter des agents à des services externes, Azure Databricks recommande les services MCP ou le proxy de connexions de catalogue Unity. Les outils de fonction UC qui enveloppent http_request restent pris en charge, mais ne constituent plus l’approche recommandée.

Vous pouvez créer une fonction Unity Catalog qui encapsule http_request() pour appeler des services externes. Cette approche est utile pour les définitions d’outils sql.

Exigences

Une connexion HTTP du catalogue Unity pour le service externe. Référenez-le par son nom dans le http_request() paramètre de conn la fonction.

Créer un outil de fonction avec http_request()

L’exemple suivant crée un outil fonction de Unity Catalog qui publie un message sur 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

Consultez CREATE FUNCTION (SQL, Python, Scala et Java).

Remarque

L’accès SQL avec http_request est bloqué pour les types de connexion User-to-Machine per User et Dynamic Client Registration. Utilisez plutôt le Kit de développement logiciel (SDK) Azure Databricks Python.