O que são as funções de dados do usuário do Fabric?

As funções de dados do usuário permitem que você crie funções Python reutilizáveis que podem ser chamadas tanto do Fabric quanto de aplicativos externos. Escreva sua lógica de negócio uma vez e chame-a a partir de pipelines, notebooks, regras ativadoras, fluxos de tarefas translíticos do Power BI ou qualquer sistema externo via endpoints REST.

As funções de dados do usuário fornecem um ambiente de computação sem servidor em que você pode hospedar e executar código de Python personalizado diretamente no Fabric. Se você precisar padronizar categorias de produtos, aplicar regras de negócios complexas ou integrar-se a APIs externas, você pode escrever funções que estão imediatamente disponíveis em toda a sua plataforma de dados. O serviço dá suporte ao runtime do Python 3.11.9, às bibliotecas públicas do PyPI e às conexões de dados do Fabric.

GIF animado mostrando a interface das funções de dados do usuário do Fabric.

Pronto para começar? Siga este guia para criar um novo item de funções de dados do usuário ou usar a extensão do VS Code.

Por que usar as funções de dados do usuário do Fabric?

As funções de dados do usuário do Fabric fornecem uma plataforma serverless para hospedar sua lógica personalizada e invocá-la a partir de diferentes tipos de itens e fontes de dados do Fabric. Use esse serviço para escrever lógica de negócios, algoritmos internos e funções reutilizáveis que se integram às suas soluções Fabric.

Veja a seguir os principais benefícios:

  • Reutilizabilidade: Escreva sua lógica de negócio uma vez como uma função de dados do usuário e invoque-a a partir de múltiplos itens do Fabric - pipelines, notebooks, regras ativadoras e fluxos translíticos de tarefas do Power BI. Quando as regras de negócios forem alteradas, atualize a função uma vez em vez de modificar o código em vários locais.
  • Hospedagem sem servidor: implantar funções do Python sem gerenciar a infraestrutura. As funções de dados do usuário fornecem um ambiente computacional serverless com autenticação embutida, então você não precisa configurar e manter serviços ou contêineres separados da API.
  • Conectividade externa: cada função expõe automaticamente seu próprio ponto de extremidade REST exclusivo, permitindo a integração com aplicativos externos, serviços Web e clientes personalizados. Chame suas funções de qualquer sistema que dê suporte a solicitações HTTP.

Principais capacidades

  • Escreva uma vez, execute em qualquer lugar: Crie funções que funcionem idênticamente, seja invocadas a partir de pipelines, notebooks, regras ativadoras, Power BI ou chamadas REST externas
  • Ecossistema avançado do Python: use qualquer pacote do PyPI para criar lógica sofisticada — pandas para manipulação de dados, solicitações de chamadas à API ou bibliotecas especializadas para seu domínio
  • Acesso seguro a dados: Conecte-se a fontes de dados Fabric (bancos de dados SQL, armazéns, casas de lago, bancos de dados espelhados) com autenticação e segurança integradas
  • Desenvolver e publicar fluxo de trabalho: testar funções antes de publicá-las, garantindo que as alterações sejam validadas antes de se tornarem disponíveis para invocação

Recursos de integração

As funções de dados do usuário se integram perfeitamente com cargas de trabalho Fabric e sistemas externos, permitindo que você construa soluções de dados abrangentes.

Invocar de itens do Fabric

Chame suas funções de qualquer carga de trabalho do Fabric para centralizar a lógica de negócios e manter a consistência:

  • Pipelines de dados - Executar funções como atividades de pipeline para transformações de dados, validações ou lógica de orquestração
  • Notebooks – Invocar funções de notebooks PySpark ou Python para fluxos de trabalho de ciência de dados e análise exploratória
  • Regras de Ativação – Acionar funções em resposta a eventos em tempo real e dados transmitidos em streaming
  • Fluxos de tarefas transanalíticas do Power BI - Executar funções diretamente de relatórios Power BI para experiências de dados interativas. As funções de dados do usuário podem receber o contexto do relatório – como o filtro atual e o contexto de seleção – na carga útil da solicitação, permitindo a execução de ações e cenários de escrita dentro de um relatório. Após a conclusão de um write-back, a visibilidade dos dados no relatório depende do modo de armazenamento do relatório e da semântica de atualização: os valores atualizados aparecem imediatamente para relatórios do Direct Lake ou DirectQuery ou após uma atualização automática disparada pelo fluxo de tarefas para relatórios de modo de importação.

Conectar-se a fontes de dados do Fabric

Suas funções podem acessar dados com segurança de toda a plataforma Fabric:

  • Bancos de dados SQL - Leitura e escrita de operações em bancos de dados SQL no Fabric
  • Warehouses – operações de leitura e gravação para dados estruturados
  • Lakehouses - Ler e escrever arquivos do Lakehouse; acesso somente leitura a endpoints de análise SQL
  • Bancos de dados espelhados – acesso somente leitura a dados de banco de dados espelhados
  • Biblioteca de variáveis - Acesse configurações centralizadas como variáveis nas suas funções.
  • Cosmos DB em Fabric - Conecte-se ao Cosmos DB em contêineres Fabric para operações de dados NoSQL.
  • Eventos de negócios - Detectar mudanças em dados operacionais e publicar eventos de negócios para aplicações posteriores.

Além das conexões gerenciadas, as funções de dados do usuário suportam conexões genéricas que você pode usar para conectar a itens Fabric ou recursos do Azure usando a identidade do proprietário do item. Conexões genéricas geram um token Microsoft Entra ID com a identidade do proprietário para um tipo de audiência especificado, oferecendo uma forma flexível de autenticação com serviços como Azure Cosmos DB ou Azure Key Vault sem configurar conexões gerenciadas individuais. Para mais informações, veja Conexões genéricas para itens Fabric ou recursos do Azure.

A escrita de retorno a partir de fluxos translíticos de tarefas do Power BI é suportada nativamente ao invocar funções de dados do usuário. As funções de dados do usuário podem realizar operações de adição, atualização e exclusão contra bancos de dados SQL em arquivos Fabric, warehouses e lakehouse, tornando-as o ponto ideal de integração para cenários de escrita orientados por fluxo de tarefas.

Saiba mais sobre como se conectar a fontes de dados do Fabric.

Chamadas de aplicativos externos

Cada função de dados do usuário expõe automaticamente seu próprio endpoint REST único para integração com sistemas fora do Fabric:

  • Aplicativos Web – Invocar funções de aplicativos Web, aplicativos móveis ou aplicativos de página única
  • External services – Integrar com sistemas externos, microsserviços ou aplicativos herdados, por exemplo, postar mensagens ou atualizações para Microsoft Teams ou chamar APIs REST externas como parte de ações controladas por fluxo de tarefas
  • Fluxos de trabalho de API – Encadear funções com outras APIs para criar cenários de integração complexos
  • Clientes personalizados – Chamada de qualquer linguagem de programação ou plataforma que dê suporte a solicitações HTTP

Endpoints REST para funções de dados de usuário suportam autenticação Microsoft Entra ID, garantindo acesso seguro a partir de sistemas externos. Aprenda a invocar funções de dados do usuário a partir de uma aplicação Python.

Introdução

Pronto para criar suas primeiras funções de dados de usuário? Escolha seu ambiente de desenvolvimento preferido:

Conteúdo relacionado

  • Last updated on