Démarrage rapide : utiliser Visual Studio Code pour se connecter et interroger la base de données Azure SQL ou Azure SQL Managed Instance

S’applique à :Azure SQL DatabaseAzure SQL Managed Instance

Visual Studio Code est un éditeur de code graphique pour Linux, macOS et Windows. Il prend en charge des extensions, notamment l’extension MSSQL permettant d’interroger SQL Server, Azure SQL Database, Azure SQL Managed Instance, la base de données SQL de Microsoft Fabric et d’autres plateformes. Dans ce guide de démarrage rapide, vous utilisez Visual Studio Code pour vous connecter à Azure SQL Database ou Azure SQL Managed Instance, puis vous exécutez des instructions Transact-SQL pour interroger, ajouter, mettre à jour et supprimer des données.

Prérequis

Installation de Visual Studio Code

Vérifiez que la dernière version de Visual Studio Code est installée. Pour obtenir des conseils d’installation, consultez Installer Visual Studio Code.

Configurer Visual Studio Code

Pour configurer Visual Studio Code pour la connexion à Azure SQL Database ou Azure SQL Managed Instance, vous devez installer les extensions et dépendances nécessaires en fonction de votre système d’exploitation. Pour commencer, suivez les étapes ci-dessous pour votre système d'exploitation spécifique.

Windows

Chargez l’extension MSSQL en suivant ces étapes :

  1. Ouvrez Visual Studio Code.
  2. Ouvrez le volet Extensions (ou Ctrl + Maj + X).
  3. Recherchez sql et installez l’extension SQL Server (mssql).

Pour des conseils supplémentaires sur l’installation, voir l’extension MSSQL pour Visual Studio Code.

macOS

Pour macOS, il faut installer OpenSSL, qui est un prérequis pour .NET Core utilisé par l’extension MSSQL. Ouvrez votre terminal et entrez les commandes ci-après pour installer brew et OpenSSL.

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew update
brew install openssl
mkdir -p /usr/local/lib
ln -s /usr/local/opt/openssl/lib/libcrypto.1.0.0.dylib /usr/local/lib/
ln -s /usr/local/opt/openssl/lib/libssl.1.0.0.dylib /usr/local/lib/

Linux (Ubuntu)

Chargez l’extension MSSQL en suivant ces étapes :

  1. Ouvrez Visual Studio Code.
  2. Ouvrez le volet Extensions (ou Ctrl + Maj + X).
  3. Recherchez sql et installez l’extension SQL Server (mssql).

Pour des conseils supplémentaires sur l’installation, voir l’extension MSSQL pour Visual Studio Code.

Obtenir les informations de connexion du serveur

Obtenez les informations de connexion dont vous avez besoin pour vous connecter à Azure SQL Database. Vous aurez besoin du nom complet du serveur ou de l’hôte, du nom de la base de données et des informations de connexion pour les procédures suivantes.

  1. Connectez-vous au portail Azure.

  2. Accédez à la page Bases de données SQL ou Instances managées SQL.

  3. Dans la page Vue d’ensemble, vérifiez le nom de serveur complet à côté de Nom de serveur pour une base de données SQL, ou le nom de serveur complet à côté de Hôte pour une instance managée SQL. Pour copier le nom du serveur ou de l’hôte, pointez dessus et sélectionnez l’icône Copier.

Définition du mode de langage sur SQL

Dans Visual Studio Code, définissez le mode de langage sur SQL pour activer les commandes mssql et T-SQL IntelliSense.

  1. Ouvrez une nouvelle fenêtre Visual Studio Code.

  2. Appuyez sur Ctrl + N. Un nouveau fichier texte brut s’ouvre.

  3. Sélectionnez Texte brut dans le coin inférieur droit de la barre d’état.

  4. Dans la liste déroulante Sélectionner un mode de langage qui s’affiche, sélectionnez SQL.

Connectez-vous à votre base de données

Utilisez Visual Studio Code pour établir une connexion à votre serveur.

Important

Avant de poursuivre, vérifiez que votre serveur est prêt et que vous avez vos informations de connexion. Une fois que vous avez commencé à saisir les informations concernant le profil de connexion, si vous modifiez le focus à partir de Visual Studio Code, vous devez redémarrer la création du profil.

  1. Dans Visual Studio Code, appuyez sur Ctrl+Maj+P (ou F1) pour ouvrir la Palette de commandes.

  2. Tapez connect, puis choisissez MS SQL :Connecter.

  3. Sélectionnez + Créer un profil de connexion.

  4. Suivez les instructions pour spécifier les propriétés de connexion du nouveau profil. Après avoir spécifié chaque valeur, appuyez sur Entrée pour continuer.

    Propriété Valeur suggérée Description
    Nom du serveur Nom complet du serveur Quelque chose comme : <Contoso-server-name>.database.windows.net.
    Nom de la base de données Nom de votre base de données Pour le parcours du niveau gratuit, saisissez le nom de la base de données gratuite que vous avez déjà provisionnée. Pour le chemin Adventure Works, saisissez la base de données contenant les tables types, telles que mySampleDatabase.
    Authentification Connexion SQL Ce didacticiel utilise l’authentification SQL.
    Nom d'utilisateur Nom d'utilisateur Nom d'utilisateur du compte d'administrateur de serveur utilisé pour créer le serveur.
    Mot de passe (connexion SQL) Mot de passe Mot de passe du compte d'administrateur de serveur utilisé pour créer le serveur.
    Enregistrer le mot de passe ? Oui ou Non Sélectionnez Oui si vous ne souhaitez pas entrer le mot de passe à chaque fois.
    Entrez un nom pour ce profil Nom de profil, par exemple mySampleProfile Un profil enregistré permet d’accélérer votre connexion lors des connexions suivantes.

    Si cela aboutit, une notification s’affiche et indique que votre profil est créé et connecté.

Interroger une base de données existante de type free tier

Utilisez ce chemin si vous vous êtes connecté à une nouvelle base de données Azure SQL Database du niveau gratuit, qui est vide.

  1. Exécutez cette requête dans l’éditeur :

    SELECT DB_NAME() AS current_database;
    
  2. Confirmez que le résultat est le nom de la base de données gratuite que vous avez provisionnée, et non master ou une autre base de données. Si cela ne correspond pas, reconnectez-vous à la base de données prévue avant de continuer.

  3. Suivez Créer une table, insérer des lignes et Visualiser les données dans le guide de démarrage rapide de la première requête MSSQL. Ces étapes créent dbo.Authors et interrogent ses cinq lignes d’exemple dans votre base de données existante. Vous avez besoin d’une autorisation pour créer la table et modifier ses données. Ignorez l’étape générique de ce démarrage rapide : Créer une base de données ; CREATE DATABASE Library ne provisionne pas une base de données de niveau gratuit.

  4. Suivez les instructions Nettoyer les ressources de ce quickstart pour ne supprimer que la table d’exemple que vous avez créée, après avoir vérifié la propriété de la base de données et de la table. Ne perdez pas votre base de données gratuite.

  5. Suivez votre allocation restante et examinez les pauses et les comportements de dépassement. Déconnectez les éditeurs de requêtes et l'Explorateur d'objets lorsque vous avez terminé. Les connexions ouvertes peuvent empêcher la pause automatique au repos ; la déconnexion ne restaure pas l’utilisation déjà consommée.

Vous pouvez continuer à créer dans la même base de données. La complétion des requêtes n’établit pas la compatibilité de la charge de travail ni ne garantit que l’utilisation future reste dans la limite du quota gratuit. N’exécutez pas les exemples Adventure Works suivants, sauf si vous avez choisi séparément le parcours utilisant la base de données d’exemple et que vous disposez des tables requises.

Interroger des données

Les autres exemples de requête, d’insertion, de mise à jour et de suppression utilisent Adventure Works, et non le parcours reposant sur une base de données vide du niveau gratuit.

Exécutez l’instruction Transact-SQL SELECT suivante pour interroger les 20 premiers produits par catégorie.

  1. Dans la fenêtre de l'éditeur, collez la requête SQL suivante.

    SELECT pc.Name AS CategoryName,
        p.name AS ProductName
    FROM [SalesLT].[ProductCategory] pc
    INNER JOIN [SalesLT].[Product] p
        ON pc.ProductCategoryId = p.ProductCategoryId;
    
  2. Appuyez sur Ctrl + Shift + E pour exécuter la requête et afficher les résultats à partir des tables Product et ProductCategory.

    Capture d’écran d’une requête pour récupérer des données à partir de 2 tables.

Insertion des données

Exécutez l’instruction Transact-SQL INSERT suivante pour ajouter un nouveau produit dans la table SalesLT.Product.

  1. Remplacez la requête précédente par celle-ci.

    INSERT INTO [SalesLT].[Product] (
        [Name],
        [ProductNumber],
        [Color],
        [ProductCategoryID],
        [StandardCost],
        [ListPrice],
        [SellStartDate]
     )
     VALUES (
        'myNewProduct',
        123456789,
        'NewColor',
        1,
        100,
        100,
        GETDATE()
     );
    
  2. Appuyez sur Ctrl + Shift + E pour insérer une nouvelle ligne dans la table Product.

Mettre à jour des données

Exécutez l’instruction Transact-SQL UPDATE suivante pour mettre à jour le produit ajouté.

  1. Remplacez la requête précédente par celle-ci :

    UPDATE [SalesLT].[Product]
    SET [ListPrice] = 125
    WHERE Name = 'myNewProduct';
    
  2. Appuyez sur Ctrl + Shift + E pour mettre à jour la ligne spécifiée dans la table Product.

Suppression de données

Exécutez l’instruction Transact-SQL DELETE suivante pour supprimer le nouveau produit.

  1. Remplacez la requête précédente par celle-ci :

    DELETE FROM [SalesLT].[Product]
    WHERE Name = 'myNewProduct';
    
  2. Appuyez sur Ctrl + Shift + E pour supprimer la ligne spécifiée dans la table Product.