Ferramentas funcionais do Unity Catalog com conexão HTTP

Observação

Para conectar agentes a serviços externos, o Azure Databricks recomenda MCP Services ou o proxy de conexões do Unity Catalog. As ferramentas de função UC que encapsulam http_request permanecem compatíveis, mas não são mais a abordagem recomendada.

Você pode criar uma função de Catálogo do Unity que encapsula http_request() para chamar serviços externos. Essa abordagem é útil para definições de ferramenta baseadas em SQL.

Requirements

Uma conexão HTTP do Unity Catalog para o serviço externo. Referencia-o pelo nome no http_request() parâmetro da conn função.

Criar uma ferramenta funcional com http_request()

O exemplo a seguir cria uma ferramenta de função do Catálogo do Unity que posta uma mensagem no 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

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

Observação

O acesso SQL com http_request está bloqueado para os tipos de conexão User-to-Machine Per User e Registro Dinâmico de Cliente. Em vez disso, use o SDK Python Azure Databricks.