Utilisez Visual Studio Code pour créer et exécuter des scripts Transact-SQL pour SQL ServerUse Visual Studio Code to create and run Transact-SQL scripts for SQL Server

Cette rubrique s’applique à : OuiSQL Server (Linux uniquement)aucunbase de données SQL AzureaucunAzure SQL Data Warehouseaucun Parallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (Linux only)noAzure SQL DatabasenoAzure SQL Data WarehousenoParallel Data Warehouse

Cette rubrique montre comment utiliser l'extension mssql pour Visual Studio Code (VS Code) pour développer des bases de données SQL Server.This article shows how to use the mssql extension for Visual Studio Code (VS Code) to develop SQL Server databases.

Visual Studio Code est un éditeur de code graphique pour Linux, MacOS et Windows qui supporte les extensions.Visual Studio Code is a graphical code editor for Linux, macOS, and Windows that supports extensions. L’extension mssql pour VS Code vous permet de vous connecter à SQL Server, d'effectuer des requêtes via Transact-SQL (T-SQL) et d'afficher les résultats.The mssql extension for VS Code enables you to connect to SQL Server, query with Transact-SQL (T-SQL), and view the results.

Installer Visual Studio CodeInstall VS Code

  1. Si vous n'avez pas encore installé Visual Studio Code, téléchargez et installez VS Code sur votre ordinateur.If you have not already installed VS Code, Download and install VS Code on your machine.

  2. Démarrez Visual Studio Code.Start VS Code.

Installer l’extension mssqlInstall the mssql extension

Les étapes suivantes expliquent comment installer l’extension mssql.The following steps explain how to install the mssql extension.

  1. Appuyez sur Ctrl + Maj + P (ou F1) pour ouvrir la Palette de commandes dans Visual Studio Code.Press CTRL+SHIFT+P (or F1) to open the Command Palette in VS Code.

  2. Sélectionnez installer une Extension et type mssql.Select Install Extension and type mssql.

    Conseil

    Pour macOS, la touche CMD est équivalente à CTRL sous Linux et Windows.For macOS, the CMD key is equivalent to CTRL key on Linux and Windows.

  3. Cliquez sur Installer mssql.Click install mssql.

    Install the extension

  4. L'extension mssql prend jusqu'à une minute pour s'installer.The mssql extension takes up to one minute to install. Patientez jusqu'à ce que l’invite vous indique qu’il est correctement installé.Wait for the prompt that tells you it successfully installed.

    Installation success notification

    Note

    Pour MacOS, vous devez installer OpenSSL.For macOS, you must install OpenSSL. C'est un pré-requis pour .Net Core utilisé par l'extension mssql.This is a pre-requisite for .Net Core used by the mssql extension. Suivez les étapes préalables à l'installation décrites dans les instructions .Net Core.Follow the install pre-requisite steps in the .Net Core instructions. Vous pouvez également exécuter les commandes suivantes dans votre Terminal MacOS.Or, you can run the following commands in your macOS Terminal.

    brew update
    brew install openssl
    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/
    

    Note

    Pour Windows 8.1, Windows Server 2012 ou une version inférieure, vous devez télécharger et installer le Windows 10 universelles C Runtime.For Windows 8.1, Windows Server 2012 or lower versions, you must download and install the Windows 10 Universal C Runtime. Téléchargez et ouvrez le fichier zip.Download and open the zip file. Puis exécutez le programme d’installation (fichiers .msu) ciblant la configuration actuelle du système d’exploitation.Then run the installer (.msu file) targeting your current OS configuration.

Créez ou ouvrez un fichier SQLCreate or open a SQL file

L'extension mssql active les commandes mssql et l'IntelliSense T-SQL dans l'éditeur lorsque le mode langage est réglé sur SQL.The mssql extension enables mssql commands and T-SQL IntelliSense in the editor when the language mode is set to SQL.

  1. Appuyez sur Ctrl + N.Press CTRL+N. Visual Studio Code ouvre un nouveau fichier de "Texte brut" par défaut.Visual Studio Code opens a new 'Plain Text' file by default.

  2. Appuyez sur CTRL + K, M et modifiez le mode de langage à SQL.Press CTRL+K,M and change the language mode to SQL.

    SQL language mode

  3. Vous pouvez également ouvrir un fichier existant avec l’extension de fichier .sql.Alternatively, open an existing file with .sql file extension. Le mode de langage est automatiquement initialisé à SQL pour les fichiers ayant l’extension .sql.The language mode is automatically SQL for files that have the .sql extension.

Se connecter à SQL ServerConnect to SQL Server

Les étapes suivantes montrent comment se connecter à SQL Server avec le Visual Studio Code.The following steps show how to connect to SQL Server with VS Code.

  1. Dans VS Code, appuyez sur Ctrl+Maj+P (ou F1) pour ouvrir la palette de commandes.In VS Code, press CTRL+SHIFT+P (or F1) to open the Command Palette.

  2. Ecrivez sql pour afficher les commandes mssql.Type sql to display the mssql commands.

    mssql commands

  3. Sélectionnez la commande MS SQL: Connect.Select the MS SQL: Connect command. Vous pouvez simplement taper sqlcon et appuyez sur entrée.You can simply type sqlcon and press ENTER.

  4. Sélectionnez créer le profil de connexion.Select Create Connection Profile. Cette opération crée un profil de connexion pour votre instance de SQL Server.This creates a connection profile for your SQL Server instance.

  5. Suivez les invites pour spécifier les propriétés de connexion du nouveau profil de connexion.Follow the prompts to specify the connection properties for the new connection profile. Après avoir spécifié chaque valeur, appuyez sur entrée pour continuer.After specifying each value, press ENTER to continue.

    Le tableau suivant décrit les propriétés de profil de connexion.The following table describes the Connection Profile properties.

    ParamètreSetting DescriptionDescription
    Nom du serveurServer name Le nom de l'instance SQL Server.The SQL Server instance name. Pour ce tutoriel, utilisez localhost pour vous connecter à l'instance SQL Server locale de votre machine.For this tutorial, use localhost to connect to the local SQL Server instance on your machine. Si vous vous connectez à un serveur SQL distant, entrez le nom de la machine SQL Server cible ou son adresse IP.If connecting to a remote SQL Server, enter the name of the target SQL Server machine or its IP address. Si vous avez besoin de spécifier un port pour votre instance de SQL Server, utilisez une virgule pour séparer à partir du nom.If you need to specify a port for your SQL Server instance, use a comma to separate it from the name. Par exemple pour un serveur local en cours d’exécution sur le port 1401 entrez localhost, 1401.For example for a local server running on port 1401 you would enter localhost,1401.
    [Facultatif] Nom de la base de données[Optional] Database name La base de données que vous voulez utiliser.The database that you want to use. Pour les besoins de ce tutoriel, ne spécifiez pas de base de données et appuyez sur entrée pour continuer.For purposes of this tutorial, don't specify a database and press ENTER to continue.
    Nom d'utilisateurUser name Entrez le nom d'un utilisateur ayant accès à une base de données sur le serveur.Enter the name of a user with access to a database on the server. Pour ce tutoriel, utilisez le compte SA créé par défaut lors de l'installation de SQL Server.For this tutorial, use the default SA account created during the SQL Server setup.
    Mot de passe (connexion SQL)Password (SQL Login) Entrez le mot de passe de l'utilisateur spécifié.Enter the password for the specified user.
    Enregistrer le mot de passe ?Save Password? Tapez Oui pour enregistrer le mot de passe.Type Yes to save the password. Sinon, tapez Non pour demander le mot de passe chaque fois que le profil de connexion est utilisé.Otherwise, type No to be prompted for the password each time the Connection Profile is used.
    [Facultatif] Entrez un nom pour ce profil[Optional] Enter a name for this profile Nom du profil de connexion.The Connection Profile name. Par exemple, vous pouvez nommer le profil profil local.For example, you could name the profile localhost profile.

    Conseil

    Vous pouvez créer et modifier des profils de connexion dans le fichier de paramètres utilisateur (settings.json).You can create and edit connection profiles in User Settings file (settings.json). Ouvrez le fichier de paramètres en sélectionnant préférences , puis paramètres utilisateur dans le menu Visual Studio Code.Open the settings file by selecting Preference and then User Settings in the VS Code menu. Pour plus d’informations, consultez gérer les profils de connexion.For more information, see manage connection profiles.

  6. Appuyez sur la touche ÉCHAP pour fermer le message d’information qui vous informe que le profil est créé et connecté.Press the ESC key to close the info message that informs you that the profile is created and connected.

    Conseil

    Si vous obtenez un échec de connexion, essayez d'abord de diagnostiquer le problème à partir du message d'erreur dans le panneau Output du VS Code (sélectionnez Sortie dans le menu Vue).If you get a connection failure, first attempt to diagnose the problem from the error message in the Output panel in VS Code (select Output on the View menu). Passez ensuite en revue lesrecommandations de dépannage des connexions.Then review the connection troubleshooting recommendations.

  7. Vérifiez votre connexion dans la barre d’état.Verify your connection in the status bar.

    Connection status

création d'une base de données ;Create a database

  1. Dans l’éditeur, tapez sql pour afficher une liste des extraits de code modifiable.In the editor, type sql to bring up a list of editable code snippets.

    SQL snippets

  2. Sélectionnez sqlCreateDatabase.Select sqlCreateDatabase.

  3. Dans l’extrait de code, tapez TutorialDB pour le nom de la base de données.In the snippet, type TutorialDB for the database name.

    USE master
    GO
    IF NOT EXISTS (
       SELECT name
       FROM sys.databases
       WHERE name = N'TutorialDB'
    )
    CREATE DATABASE [TutorialDB]
    GO
    
  4. Appuyez sur CTRL + MAJ + E pour exécuter les commandes Transact-SQL.Press CTRL+SHIFT+E to execute the Transact-SQL commands. Afficher les résultats dans la fenêtre de requête.View the results in the query window.

    create database messages

    Conseil

    Vous pouvez personnaliser les combinaisons de touches de raccourci pour les commandes d’extension mssql.You can customize shortcut key bindings for the mssql extension commands. Consultez personnaliser des raccourcis.See customize shortcuts.

Créer une tableCreate a table

  1. Supprimez le contenu de la fenêtre d’éditeur.Remove the contents of the editor window.

  2. Appuyez sur F1 pour afficher la Palette de commandes.Press F1 to display the Command Palette.

  3. Ecrivez sql dans la Palette de commandes pour afficher les commandes SQL ou un type sqluse pour MS SQL : Use Database commande.Type sql in the Command Palette to display the SQL commands or type sqluse for MS SQL:Use Database command.

  4. Cliquez sur MS SQL:Use Database, puis sélectionnez la base de données TutorialDB.Click MS SQL:Use Database, and select the TutorialDB database. Le contexte passe alors à la base de données créée dans la section précédente.This changes the context to the new database created in the previous section.

    use database

  5. Dans l’éditeur, tapez sql pour afficher les extraits de code, puis sélectionnez sqlCreateTable et appuyez sur entrez.In the editor, type sql to display the snippets, and then select sqlCreateTable and press enter.

  6. Dans l’extrait de code, tapez employees pour le nom de table.In the snippet, type Employees for the table name.

  7. Appuyez sur l’onglet, puis tapez dbo comme nom de schéma.Press Tab, and then type dbo for the schema name.

    Note

    Après avoir ajouté l’extrait de code, vous devez écrire les noms des tables et des schemas sans faire sortir le focus hors de l’éditeur de Visual Studio Code.After adding the snippet, you must type the table and schema names without changing focus away from the VS Code editor.

  8. Modifier le nom de colonne Column1 en nom et Column2 en emplacement.Change the column name for Column1 to Name and Column2 to Location.

    -- Create a new table called 'Employees' in schema 'dbo'
    -- Drop the table if it already exists
    IF OBJECT_ID('dbo.Employees', 'U') IS NOT NULL
    DROP TABLE dbo.Employees
    GO
    -- Create the table in the specified schema
    CREATE TABLE dbo.Employees
    (
       EmployeesId        INT    NOT NULL   PRIMARY KEY, -- primary key column
       Name      [NVARCHAR](50)  NOT NULL,
       Location   [NVARCHAR](50)  NOT NULL
    );
    GO
    
  9. Appuyez sur CTRL + MAJ + E pour créer la table.Press CTRL+SHIFT+E to create the table.

Insertion et requêteInsert and query

  1. Ajoutez les instructions suivantes pour insérer quatre lignes dans la table employees.Add the following statements to insert four rows into the Employees table. Puis sélectionnez toutes les lignes.Then select all the rows.

    -- Insert rows into table 'Employees'
    INSERT INTO Employees
       ([EmployeesId],[Name],[Location])
    VALUES
       ( 1, N'Jared', N'Australia'),
       ( 2, N'Nikita', N'India'),
       ( 3, N'Tom', N'Germany'),
       ( 4, N'Jake', N'United States')   
    GO   
    -- Query the total count of employees
    SELECT COUNT(*) as EmployeeCount FROM dbo.Employees;
    -- Query all employee information
    SELECT e.EmployeesId, e.Name, e.Location 
    FROM dbo.Employees as e
    GO
    

    Conseil

    En cours de frappe, utilisez l’aide de T-SQL IntelliSense.While you type, use the assistance of the T-SQL IntelliSense. TSQL IntelliSense

  2. Appuyez sur CTRL + MAJ + E pour exécuter les commandes.Press CTRL+SHIFT+E to execute the commands. Les deux ensembles de résultats s'affichent dans la fenêtre résultats.The two result sets display in the Results window.

    Results

Afficher et enregistrer le résultatView and save the result

  1. Dans le menu vue, sélectionnez Toggle Editor Group Layout pour basculer en présentation vertical ou horizontal.On the View menu, select Toggle Editor Group Layout to switch to vertical or horizontal split layout.

    Vertical split

  2. Cliquez sur l'en-tête du panneau Résultats et Messages pour réduire et développer le panneau.Click the Results and Messages panel header to collapse and expand the panel.

    Toggle Messages

    Conseil

    Vous pouvez personnaliser le comportement par défaut de l’extension mssql.You can customize the default behavior of the mssql extension. Consultez personnaliser les options d’extension.See customize extension options.

  3. Cliquez sur l'icône de la grille de maximisation sur la deuxième grille de résultat pour zoomer.Click the maximize grid icon on the second result grid to zoom in.

    Maximize grid

    Note

    L’icône Agrandir s’affiche lorsque votre script T-SQL possède deux ou plusieurs grilles de résultats.The maximize icon displays when your T-SQL script has two or more result grids.

  4. Ouvrez le menu contextuel de la grille à l'aide du bouton droit de la souris sur une grille.Open the grid context menu with the right mouse button on a grid.

    Context menu

  5. Sélectionnez sélectionner tout.Select Select All.

  6. Ouvrez le menu contextuel de grille et sélectionnez enregistrer en tant que JSON pour enregistrer le résultat dans un fichier .json.Open the grid context menu and select Save as JSON to save the result to a .json file.

  7. Spécifiez un nom de fichier pour le fichier JSON.Specify a file name for the JSON file. Dans le cadre de ce didacticiel, tapez employees.json.For this tutorial, type employees.json.

  8. Vérifiez que le fichier JSON est enregistré et ouvert dans Visual Studio Code.Verify that the JSON file is saved and opened in VS Code.

    Save as Json

Étapes suivantesNext steps

Dans un scénario réel, vous pouvez créer un script que vous devrez enregistrer et exécuter plus tard (soit pour l'administration, soit dans le cadre d'un projet de développement plus vaste).In a real-world scenario, you might create a script that you need to save and run later (either for administration or as part of a larger development project). Dans ce cas, vous pouvez enregistrer le script avec une extension .sql.In this case, you can save the script with a .sql extension.

Si vous utilisez T-SQL, consultez didacticiel : écriture d’instructions Transact-SQL et de référence Transact-SQL (moteur de base de données).If you're new to T-SQL, see Tutorial: Writing Transact-SQL Statements and the Transact-SQL Reference (Database Engine).

Pour plus d’informations sur l’utilisation ou pour contribuer à l’extension mssql, consultez le Wiki de projet d’extension mssql.For more information on using or contributing to the mssql extension, see the mssql extension project wiki.

Pour plus d’informations sur l’utilisation de Visual Studio Code, consultez la documentation de Visual Studio Code.For more information on using VS Code, see the Visual Studio Code documentation.