Criar um item de funções de dados do usuário do Fabric no Visual Studio Code (versão prévia)

As funções de dados do Usuário do Fabric são uma solução sem servidor que permite que você desenvolva aplicativos com rapidez e facilidade sobre fontes de dados nativas do Fabric. As vantagens são maior flexibilidade e custo-efetividade da computação sem servidor no Fabric. As funções de dados do usuário são invocadas como solicitações HTTP para um ponto de extremidade fornecido pelo serviço e operam em 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 Código do Visual Studio (VS).

Pré-requisitos

• Um Workspace do Fabricj
• Visual Studio Code
• Python
• Azure Functions Core Tools – v4.0.3477+
• Extensão do Microsoft Fabric
• Extensão de funções de dados do usuário

Selecione seu espaço de trabalho

1. Abra o VS Code e entre no Fabric.

2. No Fabric, abra o workspace do Fabric ou crie um novo workspace.

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 faixa de opções, selecione Python como o idioma de runtime.

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

8. Selecione a versão de runtime do Python. As funções de dados do usuário exigem o 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.

    

Criar sua primeira função

Escreva um item de funções de dados do usuário 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 exibir o item de funções de dados do usuário no Fabric Explorer no VS Code dentro do workspace aberto no momento.

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

Gerenciar conexões e bibliotecas

• Conexões: todas as conexões de dados adicionadas à função de dados do usuário podem ser exibidas no Fabric Explorer. Clique com o botão direito do mouse e selecione Gerenciar conexões no Fabric para os itens de funções de dados do usuário.

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

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

  • Execute e teste para testar a função no VS Code sem precisar usar ferramentas de teste de API.
  • Copie a URL pública se essa função estiver publicamente acessível invocando do aplicativo externo.

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

O item de funções de dados do usuário aberto no Vs Code Explorer fica visível no modo de exibição de 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 exibir 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 a 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.

• Exibir conexões e bibliotecas para a função local: você pode exibir todas as conexões presentes no local.settings.json e as bibliotecas no arquivo requirements.txt em seu ambiente local.

  • Sincronize conexões de local.settings para mostrar a lista atual de conexões em seu ambiente local.
  • Sincronize 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 suas alterações, publique a função de dados do usuário no Fabric. Pode levar alguns minutos para publicar as alterações.

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

Selecione F5 para depurar suas funções do Fabric. Basta definir um ponto de interrupção em qualquer lugar em seu código. No modo de depuração, os pontos de interrupção são atingidos conforme o esperado e testam seu código, pois você testaria uma função implantada.

Próximas etapas

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