Partager via


Créer des fonctions Azure avec l’extension Liaisons SQL pour Visual Studio Code via la palette de commandes

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Vue d’ensemble

Liaisons Microsoft SQL pour Visual Studio Code permet aux utilisateurs de développer des fonctions Azure avec des liaisons Azure SQL. Pour plus d’informations, consultez Créer des fonctions Azure avec l’extension Liaisons SQL pour Visual Studio Code. Pour installer l’extension, consultez Extension Liaisons SQL pour Visual Studio Code.

Palette de commandes

Exécutez la commande MS SQL: Create Azure Function with SQL Binding à partir de la palette de commandes pour créer une fonction avec une liaison SQL.

Capture d’écran d’une commande de la palette de commandes Visual Studio Code MS SQL : Créer une fonction Azure avec une liaison SQL (préversion).

L’extension vous invite ensuite à sélectionner le type d’objet à insérer (Input binding) ou pour lequel faire un upsert (Output binding), Table ou View.

Capture d’écran d’une invite pour sélectionner le type d’objet.

Ensuite, l’extension vous invite à sélectionner un profil de connexion à utiliser pour la fonction Azure ou à créer un profil de connexion.

Capture d’écran d’une invite pour le profil de connexion.

Une fois que vous avez sélectionné ou créé un profil de connexion, l’extension vous invite à sélectionner la base de données à partir de la connexion sélectionnée à utiliser pour la fonction Azure.

Capture d’écran d’une invite pour une base de données.

Une fois que vous avez sélectionné une base de données, l’extension vous invite à sélectionner une table ou une vue à utiliser ou à entrer une table ou une vue à interroger ou sur laquelle faire un upsert. Cette invite est basée sur le type d’objet que vous avez sélectionné précédemment.

Notes

La fonction Azure avec liaison SQL à partir d’un View n’est prise en charge que pour les liaisons Input.

Invite pour une table :

Capture d’écran d’une invite pour la table.

Invite pour une vue :

Capture d’écran d’une invite pour la vue.

L’extension vous invite ensuite à entrer le nom de la fonction à utiliser pour la fonction Azure.

Capture d’écran d’une invite pour entrer le nom de la fonction.

Si vous avez déjà des chaînes de connexion stockées dans local.settings.json, l’extension vous invite à sélectionner la chaîne de connexion à utiliser pour la fonction Azure ou à créer une chaîne de connexion.

Capture d’écran d’une invite pour sélectionner le paramètre de chaîne de connexion.

Si vous sélectionnez Create new local app setting, l’extension vous invite à entrer le nom et la valeur de la chaîne de connexion.

Capture d’écran d’une invite pour entrer la chaîne de connexion.

Si vous créez la Azure Function with SQL Binding pour un projet de fonction Azure existant, l’extension vous demande si vous voulez inclure le mot de passe de la chaîne de connexion dans le fichier local.settings.json.

Capture d’écran d’une invite pour enregistrer le mot de passe dans la chaîne de connexion SQL.

Si vous répondez Yes, le mot de passe est enregistré dans le fichier local.settings.json. Si vous répondez No, l’extension vous avertit que le mot de passe ne sera pas enregistré dans le fichier local.settings.json (illustré ici) et que vous devez ajouter manuellement le mot de passe au fichier local.settings.json ultérieurement.

Capture d’écran d’un avertissement concernant l’ajout manuel d’un mot de passe à la chaîne de connexion SQL.

L’extension vous invite ensuite à fournir l’espace de noms pour la fonction Azure.
Capture d’écran d’une invite pour l’espace de noms pour la fonction Azure.

Si vous créez un projet de fonction Azure avec une liaison SQL, l’extension vous demande si vous voulez inclure le mot de passe de la chaîne de connexion dans le fichier local.settings.json.

Une notification de progression apparaît pour indiquer que la fonction Azure est terminée.

Capture d’écran d’un message d’information indiquant que vous avez terminé la création du projet de fonction Azure.

Une fois la fonction Azure créée, l’extension génère le code pour une liaison Input ou Output. Pour plus d’informations, consultez Code généré pour les fonctions Azure avec des liaisons SQL.

Ouvrir une fonction Azure

Ouvrez la fonction Azure C# dans un éditeur, puis exécutez la commande MS SQL: Add SQL Binding à partir de la palette de commandes pour ajouter une liaison SQL à une fonction existante.

Capture d’écran d’une commande de la palette de commandes Visual Studio Code MS SQL : Ajouter une liaison SQL (préversion).

L’extension vous invite ensuite à sélectionner la fonction Azure dans le fichier actif auquel ajouter la liaison SQL. Capture d’écran des fonctions Azure trouvées dans le projet.

Si vous créez une fonction Azure avec une liaison SQL depuis une table, l’extension vous invite à sélectionner le type de liaison à utiliser : une liaison Input (récupère des données auprès d’une base de données) ou Output (enregistre des données dans une base de données).

Si vous avez déjà des chaînes de connexion stockées dans local.settings.json, l’extension vous invite à sélectionner la chaîne de connexion à utiliser pour la fonction Azure ou à créer une chaîne de connexion.

Capture d’écran d’une invite pour sélectionner ou créer un nouveau paramètre de chaîne de connexion.

Si vous sélectionnez Create new local app setting, l’extension vous invite à entrer le nom et la valeur de la chaîne de connexion.

Capture d’écran d’une invite pour entrer la chaîne de connexion.

L’extension vous invite ensuite à sélectionner une méthode de chaîne de connexion pour sélectionner un profil de connexion ou entrer une chaîne de connexion à utiliser pour la liaison SQL.

Capture d’écran d’une invite pour sélectionner la méthode de paramètre de chaîne de connexion.

Si vous décidez de sélectionner un profil de connexion, l’extension vous invite à sélectionner la base de données dans la connexion sélectionnée à utiliser pour la fonction Azure.

Une fois que vous avez sélectionné une base de données, l’extension vous invite à sélectionner une table à utiliser ou à entrer une table ou une vue à interroger ou sur laquelle faire un upsert.

Invite pour une table :

L’extension vous invite ensuite à indiquer si vous souhaitez inclure le mot de passe de la chaîne de connexion dans le fichier local.settings.json.

Capture d’écran d’une invite pour enregistrer le mot de passe dans la chaîne de connexion SQL.

Si vous répondez Yes, le mot de passe est enregistré dans le fichier local.settings.json. Si vous répondez No, l’extension vous avertit que le mot de passe ne sera pas enregistré dans le fichier local.settings.json (illustré ici) et que vous devez ajouter manuellement le mot de passe au fichier local.settings.json ultérieurement.

Capture d’écran d’un avertissement concernant l’ajout manuel d’un mot de passe à la chaîne de connexion SQL.

Une fois la fonction Azure créée, l’extension génère le code pour une liaison Input ou Output. Pour plus d’informations, consultez Code généré pour les fonctions Azure avec des liaisons SQL.