Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
As funções de dados do utilizador permitem-lhe criar funções Python reutilizáveis que podem ser invocadas através do Microsoft Fabric e a partir de aplicações externas. Escreva a sua lógica de negócio uma vez e chame-a a partir de Pipelines, Notebooks, regras Activator, fluxos de tarefas translytical do Power BI ou de 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.
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?
O Fabric User Data Functions fornece uma plataforma serverless para alojar a sua lógica personalizada e invocá-la a partir de diferentes tipos de itens e fontes de dados do Fabric. Pode usar 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 uma Função de Dados do Utilizador e invoque-a a partir de múltiplos itens do Fabric — Pipelines, Notebooks, regras de Ativadores e fluxos de tarefas transanalíticos 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 User Data Functions fornecem um ambiente de computação serverless com autenticação incorporada, eliminando a necessidade de configurar e manter serviços ou contentores 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
- Escreva uma vez, execute em qualquer lugar: Crie funções que funcionem de forma idêntica, quer sejam invocadas a partir de Pipelines, Notebooks, regras Ativator, 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, casas de lago, 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 de Utilizador integram-se perfeitamente com cargas de trabalho Microsoft 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 num 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 e o contexto de seleção atuais — na carga de dados do pedido, permitindo assim a execução de ações e de cenários de registo 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 - Operações de leitura e escrita em bases de dados Fabric SQL
- Armazéns - Operações de leitura e escrita para dados estruturados
- Lakehouses - Ler e escrever ficheiros de Lakehouse; acesso de leitura apenas a endpoints SQL
- Bases de dados espelhadas - Acesso apenas de leitura a dados espelhados da base de dados
A capacidade de escrita de retorno nos Power BI Translytical Task Flows é 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 ficheiros Fabric SQL Database, Fabric Data Warehouse 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 de Utilizador a partir de uma aplicação Python.
Introdução
Pronto para criar a sua primeira Função de Dados de Utilizador? Escolha o seu ambiente de desenvolvimento preferido:
- Criar funções no portal Fabric - Guia de início rápido com desenvolvimento e testes baseados em navegador
- Develop com Visual Studio Code - Experiência completa em IDE com depuração local e integração com Git
Conteúdo relacionado
- Modelo de programação User Data Functions - Mergulho aprofundado no SDK Python, decoradores e funcionalidades avançadas
- Invocar funções a partir de uma aplicação Python - Aprenda a chamar as suas funções através de endpoints REST a partir de sistemas externos