Créer un élément de fonctions de données utilisateur Fabric dans Visual Studio Code

Les fonctions de données utilisateur Fabric sont une solution serverless qui vous permet de développer rapidement et facilement des applications sur des sources de données natives Fabric. Les avantages sont une flexibilité accrue et une rentabilité accrues de l’informatique serverless dans Fabric. Les fonctions de données utilisateur sont appelées en tant que requêtes HTTP vers un point de terminaison fourni par le service et fonctionnent sur vos sources de données natives Fabric.

Dans ce guide de démarrage rapide, vous allez apprendre à créer un élément de fonctions de données utilisateur dans Visual Studio (VS) Code.

Conditions préalables

• Un espace de travail Fabric
• Visual Studio Code
• Python
• Azure Functions Core Tools v4
• Extension Microsoft Fabric
• Extension des fonctions de données utilisateur

Sélectionnez votre espace de travail

1. Ouvrez VS Code et connectez-vous à Fabric.

2. Dans Fabric, ouvrez votre espace de travail Fabric ou créez un espace de travail.

3. Sélectionnez + Nouvel élément pour ouvrir le volet Nouvel élément.

4. Dans le volet Nouvel élément, sous Développer des données, sélectionnez le type d’élément Fonctions de données utilisateur.

5. Fournissez un nom pour le nouvel élément de fonctions de données utilisateur, puis sélectionnez Créer. L’élément de fonctions de données utilisateur est créé.

6. Dans le ruban, sélectionnez Python comme langage d’exécution.

7. Créez un environnement virtuel pour cet élément de fonctions de données utilisateur.

8. Sélectionnez la version du runtime Python. Les fonctions de données utilisateur nécessitent Python version 3.11.

9. Définissez l’environnement virtuel du dossier en sélectionnant Oui.

10. Ouvrez function_app.py pour ajouter plusieurs fonctions.

    

Écrire votre première fonction

Écrivez un élément de fonctions de données utilisateur avec le décorateur @udf.function() pour définir le début de la fonction. Vous pouvez passer une entrée pour la fonction, comme les types de données primitifs tels que str, int, float, etc. Dans la fonction, vous pouvez écrire votre logique métier personnalisée.

Voici un exemple de fonction 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()}!" 

Gérer des fonctions de données utilisateur dans VS Code

Vous pouvez afficher l’élément de fonctions de données utilisateur dans l’Explorateur Fabric dans VS Code dans l’espace de travail actuellement ouvert.

Toutes les fonctions de l’espace de travail Fabric peuvent être ouvertes dans l’Explorateur dans VS Code pour commencer à modifier. Choisissez la fonction que vous souhaitez ouvrir, puis sélectionnez Ouvrir dans l’Explorateur. Vous pouvez voir les connexions, les bibliothèques et toutes les fonctions écrites dans l’élément de fonctions de données utilisateur.

Gérer les connexions et les bibliothèques

• Connexions : toutes les connexions de données ajoutées pour votre fonction de données utilisateur peuvent être consultées à partir de l’Explorateur Fabric. Cliquez avec le bouton droit et sélectionnez Gérer les connexions dans Fabric pour les éléments de fonctions de données utilisateur.

• Bibliothèques : toutes les bibliothèques ajoutées pour votre élément de fonctions de données utilisateur peuvent être consultées à partir de l’Explorateur Fabric. Cliquez avec le bouton droit et sélectionnez Gérer les bibliothèques dans Fabric pour ajouter de nouvelles bibliothèques pour les éléments de fonctions de données utilisateur.

• Fonctions : vous pouvez afficher toutes les fonctions publiées ici. Sélectionnez une fonction et effectuez ces actions :

  • Exécutez et testez pour tester la fonction dans VS Code sans avoir à utiliser les outils de test d’API.
  • Copiez l’URL publique si cette fonction est appelée publiquement à partir d’une application externe.

Dossier local pour gérer vos fonctions de données utilisateur

L’élément de fonctions de données utilisateur ouvert dans l’Explorateur VS Code est visible dans la vue Dossier local. Le dossier local vous permet de tester et de voir les modifications locales apportées à l’élément de fonction de données utilisateur.

• Fonctions : vous pouvez afficher toutes les fonctions qui se trouvent dans votre fichier local function_app.py. Pour commencer par un exemple, cliquez avec le bouton droit sur Functions et sélectionnez Ajouter une fonction pour ajouter un exemple de fonction.

  

  Pour tester votre fonction localement, appuyez sur F5 pour démarrer le débogage. Vous pouvez également sélectionner l’élément de fonction, puis sélectionner Exécuter et déboguer.

• Afficher les connexions et les bibliothèques pour la fonction locale : vous pouvez afficher toutes les connexions présentes dans local.settings.json et les bibliothèques dans le fichier requirements.txt dans votre environnement local.

  • Synchronisez les connexions à partir de local.settings pour afficher la liste actuelle des connexions sur votre environnement local.
  • Synchronisez requirements.txt pour afficher la liste actuelle des bibliothèques sur votre environnement local.

Publier la fonction Données utilisateur

Une fois que vous avez testé vos modifications, publiez la fonction de données utilisateur sur Fabric. La publication des modifications peut prendre quelques minutes.

Débogage local avec des points d’arrêt

Sélectionnez F5 pour déboguer vos fonctions Fabric. Vous pouvez ajouter un point d’arrêt n’importe où dans votre code. En mode débogage, vos points d’arrêt sont atteints comme prévu et testent votre code comme vous le feriez pour tester une fonction déployée.

Étapes suivantes

• En savoir plus sur le modèle de programmation des fonctions de données utilisateur
• Tutoriel – Appeler des fonctions de données utilisateur à partir d'une application Python