Utiliser SQL Database Projects

L’extension Projets SQL Database est un outil de développement qui peut être installé dans Visual Studio Code. Cette extension est conçue pour faciliter le développement et la gestion des bases de données SQL dans un environnement basé sur les projets. Elle est compatible avec plusieurs plateformes SQL, notamment SQL Server, Azure SQL Database, Azure SQL Managed Instance et Azure Synapse SQL.

Il est possible de créer ou de modifier des schémas de base de données et les modifications sont enregistrées dans un fichier au format .dacpac. Vous pouvez publier le projet SQL Database à l’aide de l’extension SQL Database Projects ou en publiant le fichier .dacpac avec l’interface de ligne de commande SqlPackage.

Avec l’extension SQL Database Projects, vous pouvez soit créer un projet vide, soit créer un projet à partir d’une base de données connectée. Vous pouvez ensuite ajouter, modifier ou supprimer des objets tels que des tables, des vues, des procédures stockées, des fonctions et des scripts personnalisés.

Installer l’extension Database Projects

L’extension SQL Database Projects est installée dans le cadre de l’extension mssql. L’extension mssql pour Visual Studio Code vous permet de vous connecter à un SQL Server, d’interroger des bases de données avec T-SQL et d’afficher les résultats.

La dernière version du SDK .NET doit être installée. Si ce n’est pas le cas, vous serez invité à procéder à son installation.

Importer et modifier un schéma

Maintenant que vous avez installé l’extension SQL Database Projects, vous êtes prêt à créer un projet de base de données. Dans cet exemple, nous nous connectons à une instance Azure SQL Database existante.

Créer un projet de base de données

Le projet de base de données est le point de départ de la conception, du développement et de la gestion de votre schéma de base de données. Il fournit un environnement structuré dans lequel vous pouvez définir des tables, des vues, des procédures stockées et d’autres objets de base de données.

1. Dans le menu de gauche de Visual Studio Code, sélectionnez Projets de base de données, puis Créer.
2. Sélectionnez Azure SQL Database à partir d’un projet vide sous Sélectionner le type de projet de base de données.
3. Sélectionnez ou entrez un nom pour votre projet sous Nom du projet.
4. Sélectionnez ou accédez au dossier sur votre ordinateur local où le projet sera enregistré sous Emplacement.
5. Lorsque vous y êtes invité, sélectionnez Oui pour un projet de type SDK. Le projet de données est créé.

Ajouter une connexion

Avant de commencer à utiliser votre base de données dans Visual Studio Code, vous devez établir une connexion à votre instance Azure SQL Database. Cette connexion vous permet d’interagir avec votre base de données directement à partir de l’IDE, ce qui vous donne la possibilité d’exécuter des requêtes, de gérer les objets de base de données et d’effectuer d’autres tâches liées à la base de données. Suivez les étapes permettant d’ajouter une connexion à votre instance Azure SQL Database.

1. Dans le volet du menu de gauche, sélectionnez SQL Server.
2. Sélectionnez Ajouter une connexion.
3. Entrez le nom de l’instance SQL Server sous Nom du serveur. Vous pouvez copier et coller le nom du serveur à partir du portail Azure.
4. Entrez le nom de la base de données.
5. Sélectionnez le type d’authentification, le nom d’utilisateur et le mot de passe.
6. Entrez un nom pour le profil de connexion sous Nom du profil. Cette étape est facultative.
7. La connexion à la base de données apparaît sous le nœud Connexions.

Créer un projet SQL Database à partir d’une base de données existante

La création d’un projet SQL Database à partir d’une base de données existante vous permet d’importer votre schéma de base de données actuel dans un format de projet structuré. Suivez ces étapes pour créer un projet SQL Database à partir d’une base de données existante.

1. Cliquez avec le bouton droit sur la base de données, puis sélectionnez Créer un projet à partir d’une base de données.
2. Sélectionnez votre base de données sous Sélectionner une base de données.
3. Sélectionnez votre projet sous Entrer le nom du projet.
4. Accédez à votre dossier sous Sélectionner un emplacement ou créer un projet.
5. Sélectionnez Schéma/Type d’objet sous Sélectionner une structure de dossiers.
6. Sélectionnez Non (par défaut) sous Inclure les autorisations dans le projet.
7. Sélectionnez Oui (recommandé) sous Projet de type SDK (préversion).
8. Lorsque vous y êtes invité, sélectionnez Oui pour faire confiance aux auteurs des fichiers.
9. Développez l’arborescence des objets de la base de données pour afficher les tables et les autres objets.
10. Pour modifier le schéma, sélectionnez un objet.
11. Sélectionnez Fichier > Enregistrer, puis fermez l’onglet.

Déployer les modifications de schéma

Pour déployer les modifications vers votre instance Azure SQL Database après avoir modifié le schéma de votre base de données (par exemple en ajoutant de nouvelles tables, en mettant à jour des colonnes existantes ou en créant des procédures stockées), effectuez les étapes suivantes.

1. Dans la barre d’activité, sélectionnez Database Projects.
2. Sélectionnez Générer en cliquant avec le bouton droit sur votre projet.
3. Sélectionnez ensuite Publier en cliquant avec le bouton droit sur votre projet.
4. Sélectionnez Publier vers un serveur logique Azure SQL existant sous Sélectionner l’emplacement de publication du projet.
5. Sélectionnez Ne pas utiliser de profil sous Sélectionner le profil de publication à charger.
6. Sélectionnez votre base de données sous Choisir un profil de connexion dans la liste ci-dessous.
7. Sélectionnez Publier sous Choisir une action.
8. Actualisez la vue de la base de données pour vérifier que les modifications ont bien été apportées au schéma.