Démarrage rapide : Exécutez votre première requête avec l’extension MSSQL pour Visual Studio Code

Dans ce guide de démarrage rapide, vous utilisez l’extension MSSQL pour Visual Studio Code pour exécuter vos premières instructions Transact-SQL (T-SQL) sur une base de données. Utilisez une base de données de développement existante ou créez-en une, définissez une table, insérez des données d’exemple et interrogez les résultats.

Prerequisites

Pour effectuer ce démarrage rapide, les éléments suivants sont requis :

Si vous avez déjà une base de données de développement, réutilisez-la. Sinon, choisissez un chemin d’installation :

Connectez-vous à votre base de données

Avant d’exécuter une requête, connectez-vous à la base de données à partir du Explorateur d'objets. La boîte de dialogue Connexion vous guide tout au long de la saisie d’un nom de serveur, de la sélection d’un type d’authentification et (éventuellement) de la sélection d’une base de données. Pour obtenir une procédure pas à pas complète des types d’entrée, des méthodes d’authentification et de la gestion des connexions, consultez Se connecter à une base de données avec l’extension MSSQL pour Visual Studio Code.

Une fois connecté, votre serveur apparaît dans le Explorateur d'objets et vous pouvez commencer à exécuter des requêtes.

Utiliser une base de données existante

Si vous avez déjà provisionné une base de données Azure SQL Database free tier, connectez-vous directement à cette base de données. Dans la boîte de dialogue Connexion, sélectionnez ou entrez son nom dans le champ Base de données plutôt que de laisser la base de données par défaut sélectionnée. Vous pouvez également utiliser ce chemin pour une autre base de données de développement existante, y compris une base de données SQL dans Fabric.

  1. Ouvrez un nouvel éditeur de requêtes connecté à la base de données que vous avez choisie.

  2. Exécutez cette requête pour vérifier la base de données active de l’éditeur :

    SELECT DB_NAME() AS current_database;

  3. Vérifiez que le résultat correspond à la base de données que vous souhaitez utiliser. Si ce n’est pas le cas, sélectionnez la bonne connexion à la base de données et vérifiez à nouveau avant d’exécuter des instructions d’exemple.

  4. Ignorez la création d’une base de données et continuez avec Créer une table. Gardez la même connexion à la base de données pour les étapes suivantes.

Important

L'instruction suivante CREATE DATABASE Library ne crée pas de base de données dans le cadre du niveau gratuit d’Azure SQL Database. Ne l’exécute pas pour le chemin de l’offre gratuite. Créez la table tutorielle dans la base de données gratuite que vous avez déjà provisionnée ; ne restaurez ni n’importez d’autre base de données.

Créer une base de données

Si vous avez besoin d’une nouvelle base de données sur SQL Server ou Azure SQL Managed Instance, créez une base de données nommée Library. Si vous avez déjà une base de données de développement, utilisez plutôt Utilisez une base de données existante .

Important

Cette étape crée une base de données générique, et non une base de données de l’offre gratuite. Ajouter une autre base de données cloud peut entraîner des frais. Examinez les tarifs du service et vos autorisations avant de continuer.

  1. Ouvrez un nouvel éditeur de requête : appuyez sur Ctrl+N pour ouvrir un nouvel éditeur de requête, ou cliquez avec le bouton droit sur votre serveur, puis sélectionnez Nouvelle requête.

  2. Créez la base de données. Collez l’extrait suivant dans l’éditeur de requête, puis sélectionnez Exécuter :

    IF NOT EXISTS (SELECT name
               FROM sys.databases
               WHERE name = N'Library')
    CREATE DATABASE Library;

    Ce script crée une base de données appelée Library si elle n’existe pas déjà.

La nouvelle base de données Library apparaît dans la liste des bases de données. Si vous ne le voyez pas immédiatement, actualisez l’Explorateur d’objets.

Créer une table

Créez la table Authors dans votre base de données de développement existante ou dans la base de données Library que vous avez créée.

Important

Exécutez chaque étape séparément et arrêtez si une instruction échoue. Si dbo.Authors existe déjà, ne l’utilisez pas et ne le supprimez pas pour ce guide de démarrage rapide. Choisissez une autre base de données de développement ou changez le nom de la table de manière cohérente dans toutes les instructions d’exemple avant de continuer.

  1. Assurez-vous que l’éditeur de requêtes est connecté à la base de données que vous avez choisie. Pour le chemin de l’offre gratuite, utilisez le nom de la base de données gratuite, non Library ou master. Relancez-le SELECT DB_NAME() AS current_database; si vous ouvrez un autre éditeur ou modifiez les connexions.

  2. Créez la table. Remplacez le texte dans la fenêtre de requête par l’extrait de code suivant, puis sélectionnez Exécuter :

    CREATE TABLE dbo.Authors
(
    id INT IDENTITY (1, 1) NOT NULL PRIMARY KEY,
    first_name NVARCHAR (100) NOT NULL,
    middle_name NVARCHAR (100) NULL,
    last_name NVARCHAR (100) NOT NULL
);

Ce script crée la table Authors avec une colonne IDENTITY pour id, qui génère automatiquement des ID uniques.

Insérer des lignes

Ensuite, insérez des données dans la Authors table.

  1. Remplacez le texte dans la fenêtre de requête par l’extrait de code suivant, puis sélectionnez Exécuter :

    INSERT INTO dbo.Authors (first_name, middle_name, last_name)
VALUES ('Isaac', 'Yudovick', 'Asimov'),
       ('Arthur', 'Charles', 'Clarke'),
       ('Herbert', 'George', 'Wells'),
       ('Jules', 'Gabriel', 'Verne'),
       ('Philip', 'Kindred', 'Dick');

L'échantillon de données est ajouté au Authors tableau.

Visualiser les données

Pour vérifier les données de la table Authors, exécutez la requête suivante :

SELECT *
FROM dbo.Authors
ORDER BY id;

Après une insertion réussie dans la nouvelle table, attendez-vous à cinq lignes dans cet ordre :

id prénom deuxième prénom nom de famille
1 Isaac Yudovick Asimov
2 Arthur Charles Clarke
3 Herbert George Wells
4 Jules Gabriel Verne
5 Philip Kindred Dick

Nettoyer les ressources

Supprimez uniquement le tableau d’exemple que vous avez créé dans ce démarrage rapide.

  1. Exécutez SELECT DB_NAME() AS current_database; et confirmez que vous êtes connecté à la base de données où vous avez créé la table.

  2. Confirmez que vous avez créé dbo.Authors lors de cette procédure guidée et que vous n’avez plus besoin de ses données d’échantillon. Ne continuez pas si la création de table a échoué ou si la table appartient à un autre projet.

  3. Exécutez l’instruction suivante pour supprimer cette table :

    DROP TABLE dbo.Authors;

Ne supprimez pas une base de données existante, y compris la base de données gratuite que vous avez provisionnée, dans le cadre de cet exemple de nettoyage.

Si vous utilisez le palier gratuit, suivez votre allocation restante et examinez le fonctionnement de la mise en pause et des dépassements. Déconnectez les éditeurs de requêtes et la connexion à l'Explorateur d'objets une fois que vous avez terminé. Les sessions ouvertes peuvent empêcher la pause automatique en inactivité ; la déconnexion ne restaure pas les secondes vCore déjà consommées. Une requête réussie ne permet pas d’établir la compatibilité de la charge de travail ni de garantir que l’utilisation future reste dans les limites du quota gratuit.

Contenu connexe

  • Dernière mise à jour :