Quais são as funções de dados dos utilizadores do Fabric?

As funções de dados do utilizador permitem-lhe criar funções Python reutilizáveis que pode chamar a partir de todo o Fabric e de aplicações externas. Escreve a tua lógica de negócio uma vez e chama-a a partir de pipelines, notebooks, regras ativadoras, fluxos de tarefas translíticos do Power BI ou qualquer sistema externo através de endpoints REST.

As funções de dados do utilizador fornecem um ambiente de computação serverless onde pode alojar e executar código Python personalizado diretamente no Fabric. Quer precise de padronizar categorias de produtos, aplicar regras de negócio complexas ou integrar com APIs externas, pode escrever funções que estejam imediatamente disponíveis em toda a sua plataforma de dados. O serviço suporta o runtime Python 3.11.9, bibliotecas públicas do PyPI e conexões de dados Fabric.

GIF animado a mostrar a interface das funções de dados do utilizador do Fabric.

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

Por que usar as funções de dados do utilizador do Fabric?

As funções de dados do utilizador do Fabric fornecem uma plataforma serverless para alojar a sua lógica personalizada e invocá-la a partir de diferentes tipos de itens e fontes de dados Fabric. Use este serviço para escrever lógica de negócio, algoritmos internos e funções reutilizáveis que se integrem nas suas soluções Fabric.

Seguem-se os principais benefícios:

  • Reutilizabilidade: Escreva a sua lógica de negócio uma vez como função de dados do utilizador e invoque-a a partir de múltiplos itens Fabric – pipelines, cadernos, regras ativadoras e fluxos translíticos de tarefas do Power BI. Quando as regras de negócio mudarem, atualiza a função uma vez em vez de modificar código em vários locais.
  • Serverless hosting: Desenvolver funções Python sem gerir infraestrutura. As funções de dados do utilizador fornecem um ambiente computacional serverless com autenticação incorporada, pelo que não precisa de configurar e manter serviços ou contentores de API separados.
  • Conectividade externa: Cada função expõe automaticamente o seu endpoint REST único, permitindo a integração com aplicações externas, serviços web e clientes personalizados. Chama as tuas funções a partir de qualquer sistema que suporte pedidos HTTP.

Capacidades chave

  • Escrever uma vez, executar em qualquer lugar: Criar funções que funcionem de forma idêntica, quer sejam invocadas a partir de pipelines, notebooks, regras ativadoras, Power BI ou chamadas REST externas
  • Ecossistema Rich Python: Use qualquer pacote do PyPI para construir lógica sofisticada — pandas para manipulação de dados, pedidos para chamadas API ou bibliotecas especializadas para o seu domínio
  • Acesso seguro a dados: Ligue-se a fontes de dados Fabric (bases de dados SQL, armazéns, lakehouses, bases de dados espelhadas) com autenticação e segurança incorporadas
  • Desenvolver e publicar fluxos de trabalho: Teste funções antes de as publicar, garantindo que as alterações são validadas antes de ficarem disponíveis para invocação

Capacidades de integração

As funções de dados do utilizador integram-se perfeitamente com cargas de trabalho Fabric e sistemas externos, permitindo-lhe construir soluções de dados abrangentes.

Invocar a partir de itens Fabric

Chame as suas funções de qualquer carga de trabalho Fabric para centralizar a lógica de negócio 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
  • Cadernos - Invocar funções a partir de cadernos PySpark ou Python para fluxos de trabalho de ciência de dados e análise exploratória
  • Regras ativadoras - Funções de disparo em resposta a eventos em tempo real e dados em streaming
  • Power BI fluxos de tarefas transanalíticas - Chame funções diretamente de relatórios de Power BI para experiências de dados interativas. As funções de dados do utilizador podem receber o contexto do relatório – como o filtro atual e o contexto de seleção – na carga útil do pedido, permitindo a execução de ações e cenários de escrita a partir de um relatório. Após a conclusão de uma operação de escrita, a visibilidade dos dados no relatório depende do modo de armazenamento do relatório e das semânticas de atualização: os valores atualizados aparecem imediatamente para relatórios em Direct Lake ou DirectQuery, ou após uma atualização automática desencadeada pelo fluxo de tarefas para relatórios em modo de importação.

Liga-te às fontes de dados Fabric

As suas funções podem aceder de forma segura a dados a partir de toda a plataforma Fabric:

  • Bases de dados SQL - Ler e escrever operações em bases de dados SQL no Fabric
  • Armazéns - Operações de leitura e escrita para dados estruturados
  • Lakehouses - Ler e escrever ficheiros de Lakehouse; acesso só de leitura a endpoints de análise SQL
  • Bases de dados espelhadas - Acesso apenas de leitura a dados espelhados da base de dados
  • Biblioteca de variáveis - Acede a definições de configuração centralizadas como variáveis nas suas funções.
  • Cosmos DB em Fabric - Liga-se ao Cosmos DB em contentores Fabric para operações de dados NoSQL.
  • Eventos empresariais - Detetar alterações nos dados operacionais e publicar eventos empresariais para aplicações a jusante.

Para além das ligações geridas, as funções de dados do utilizador suportam ligações genéricas que pode usar para ligar a itens Fabric ou recursos do Azure usando a identidade do proprietário do item. As ligações genéricas geram um token Microsoft Entra ID com a identidade do proprietário para um tipo de audiência especificado, proporcionando uma forma flexível de autenticação com serviços como o Azure Cosmos DB ou o Azure Key Vault sem configurar ligações geridas individuais. Para mais informações, consulte Ligações genéricas para itens Fabric ou recursos 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 utilizador. As funções de dados do utilizador podem realizar operações de adição, atualização e eliminação contra bases de dados SQL em ficheiros Fabric, armazéns 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 ligar a fontes de dados Fabric.

Chamada a partir de aplicações externas

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

  • Aplicações web - Invocar funções de aplicações web, aplicações móveis ou aplicações de página única
  • Serviços externos - Integrar com sistemas externos, microserviços ou aplicações legadas — por exemplo, enviar mensagens ou atualizações para Microsoft Teams, ou chamar APIs REST externas como parte de ações orientadas pelo fluxo de tarefas
  • Fluxos de trabalho de API - Funções em cadeia com outras APIs para construir cenários de integração complexos
  • Clientes personalizados - Chamada a partir de qualquer linguagem de programação ou plataforma que suporte pedidos HTTP

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

Introdução

Pronto para criar as suas primeiras funções de dados de utilizador? Escolha o seu ambiente de desenvolvimento preferido:

Conteúdo relacionado

  • Last updated on