Lire des données avec des liaisons d’entrée
Pour vous connecter à une source de données, vous devez configurer une liaison d’entrée. Une liaison d’entrée permet d’écrire un minimum de code pour créer un message. Vous n’avez pas besoin d’écrire du code pour des tâches, telles que l’ouverture d’une connexion de stockage ; le runtime et la liaison Azure Functions prennent en charge ces tâches pour vous.
Types de liaisons d’entrée
Les fonctions de chaîne Azure peuvent avoir plusieurs types d’entrée. Toutefois, tous les types ne prennent pas en charge à la fois l’entrée et la sortie. Utilisez une fonction d’entrée chaque fois que vous voulez ingérer des données de ce type. Ici, nous examinons les types de fonction d’entrée qui prennent en charge les liaisons d’entrée, et quand les utiliser.
Stockage Blob Azure : les liaisons de Stockage Blob permettent de lire les données d’un blob.
Azure Cosmos DB – Les liaisons d’entrée Azure Cosmos DB utilisent l’API SQL pour récupérer un ou plusieurs documents Azure Cosmos DB et les transmettre au paramètre d’entrée de la fonction. L’ID du document ou les paramètres de requête peuvent être déterminés en fonction du déclencheur qui appelle la fonction.
Mobile Apps – La liaison d’entrée de Mobile Apps charge un enregistrement à partir d’un point de terminaison de table mobile et le transmet à votre fonction.
Stockage de tables Azure : vous pouvez lire des données et travailler avec le stockage de tables Azure.
Une liste complète des liaisons prises en charge est disponible ici
Pour créer une liaison en tant qu’entrée, vous devez définir direction comme in. Les paramètres de chaque type de liaison peuvent varier.
Qu’est-ce qu’une expression de liaison ?
Une expression de liaison est un texte spécialisé compris dans function.json, dans les paramètres de fonction ou dans du code, qui est évalué quand la fonction est appelée afin de produire une valeur. Par exemple, si vous disposez d’une liaison de file d’attente Service Bus, vous pouvez utiliser une expression de liaison pour obtenir le nom de la file d’attente à partir des paramètres d’application.
Types d’expressions de liaison
Il existe plusieurs types d’expressions de liaison, notamment :
- Paramètres de l’application
- Nom de fichier d’un déclencheur
- Métadonnées d’un déclencheur
- Charges utiles JSON
- Nouveau GUID
- Date et heure actuelles
La plupart des expressions de liaison sont identifiées par les accolades qui les entourent. Toutefois, les expressions de liaison de paramètres d’application sont entourées de signes de pourcentage, et non d’accolades. Par exemple, si le chemin de liaison de sortie d’objet blob est %Environment%/newblob.txt et que la valeur du paramètre d’application Environnement est Développement, un objet blob est créé dans le conteneur Développement.
Résumé
Les liaisons d’entrée vous permettent de connecter votre fonction à une source de données. Vous pouvez connecter plusieurs types de sources de données, et les paramètres de chaque type varient. Pour résoudre des valeurs provenant de sources d’entrée, utilisez des expressions de liaison dans le fichier function.json, dans les paramètres de fonction ou dans le code.