Criar um item de funções de dados do utilizador do Fabric no Visual Studio Code

As funções de dados do usuário de malha são uma solução sem servidor que permite desenvolver aplicativos de forma rápida e fácil sobre fontes de dados nativas da malha. As vantagens são maior flexibilidade e custo-benefício da computação sem servidor no Fabric. As funções de dados do usuário são chamadas como pedidos HTTP para um endpoint fornecido pelo serviço e operam nas suas fontes de dados nativas do Fabric.

Neste início rápido, você aprenderá a criar um item de funções de dados do usuário no Visual Studio (VS) Code.

Pré-requisitos

• Um espaço de trabalho de malha
• Código do Visual Studio
• Python
• Ferramentas Principais do Azure Functions v4
• Extensão do Microsoft Fabric
• Extensão das funções de dados do usuário

Selecione seu espaço de trabalho

1. Abra o VS Code e faça login no Fabric.

2. No Fabric, abra seu espaço de trabalho do Fabric ou crie um novo espaço de trabalho.

3. Selecione + Novo item para abrir o painel Novo item.

4. No painel Novo item, em Desenvolver dados, selecione o tipo de item Funções de dados do usuário .

5. Forneça um nome para o novo item de funções de dados do usuário e selecione Criar. O novo item de funções de dados do usuário é criado.

6. Na barra de ferramentas, selecione Python como a linguagem de tempo de execução.

7. Crie um ambiente virtual para este item de funções de dados do usuário.

8. Selecione a versão de tempo de execução do Python. As funções de dados do usuário requerem Python Versão 3.11.

9. Defina o ambiente virtual para a pasta selecionando Sim.

10. Abra function_app.py para adicionar mais de uma função.

    

Escreva a sua primeira função

Escreva um item de funções de dados de utilizador com o decorador @udf.function() para definir o início da função. Você pode passar uma entrada para a função, como tipos de dados primitivos como str, int, float, etc. Dentro da função, você pode escrever sua lógica de negócios personalizada.

Aqui está um exemplo da função hello_fabric.

@udf.function()
def hello_fabric(name: str) -> str:
    # Use logging to write custom logs to help trace and debug issues 
    logging.info('Python UDF trigger function processed a request.')
    logging.info('Executing hello fabric function.')
    
    return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!" 

Gerenciar funções de dados do usuário no VS Code

Você pode ver o item de funções de dados do usuário no explorador do Fabric no VS Code na área de trabalho aberta atualmente.

Todas as funções no espaço de trabalho Malha podem ser abertas no Explorer no VS Code para iniciar a edição. Escolha a função que pretende abrir e, em seguida, selecione Abrir no Explorer. Você pode ver conexões, bibliotecas e todas as funções escritas no item de funções de dados do usuário.

Gerenciar conexões e bibliotecas

• Conexões: Todas as conexões de dados adicionadas para sua função de dados do usuário podem ser visualizadas no Explorador de malha. Clique com o botão direito do mouse e selecione Gerir ligações no Fabric para os itens de funções de dados de utilizador.

• Bibliotecas: Todas as bibliotecas adicionadas ao item de funções de dados do usuário podem ser visualizadas no Fabric Explorer. Clique com o botão direito do mouse e selecione Gerenciar bibliotecas no Fabric para adicionar novas bibliotecas para os itens de funções de dados do usuário.

• Funções: Você pode ver todas as funções publicadas aqui. Selecione uma função e execute estas ações:

  • Executar e testar para testar a função no VS Code sem ter que usar ferramentas de teste de API.
  • Copie URL pública se esta função for acessível publicamente invocar a partir de aplicativo externo.

Pasta local para gerenciar suas funções de dados de usuário

O item das funções de dados do utilizador aberto no explorador do VS Code está visível na vista da pasta Local. A pasta local permite testar e ver as alterações locais feitas no item de função de dados do usuário.

• Funções: Você pode visualizar todas as funções que estão em seu arquivo local function_app.py . Para começar com um exemplo, clique com o botão direito do mouse em Funções e selecione Adicionar uma função para adicionar uma função de exemplo.

  

  Para testar sua função localmente, pressione F5 para iniciar a depuração. Você também pode selecionar o item de função e selecionar Executar e depurar.

• Ver conexões e bibliotecas para a função local: Você pode ver todas as conexões que estão presentes no local.settings.json e as bibliotecas no arquivo requirements.txt em seu ambiente local.

  • Sincronizar conexões de local.settings para mostrar a lista atual de conexões em seu ambiente local.
  • Sync requirements.txt para mostrar a lista atual de bibliotecas em seu ambiente local.

Publicar a função de dados do usuário

Depois de testar as alterações, publique a função de dados do usuário no Fabric. Pode levar alguns minutos para publicar quaisquer alterações.

Depuração local com pontos de interrupção

Selecione F5 para depurar as funções do Fabric. Você pode adicionar um ponto de interrupção em qualquer lugar do seu código. No modo de depuração, os seus pontos de interrupção são atingidos tal como esperado, testando o seu código tal como testaria uma função implantada.

Próximos passos

• Saiba mais sobre o modelo de programação de funções de dados do usuário
• Tutorial: Invocar funções de dados do usuário a partir de um aplicativo Python