Créer et exécuter un notebook SQL Server

S’applique à : SQL Server 2019 (15.x)

Ce tutoriel montre comment créer et exécuter un notebook dans Azure Data Studio à l’aide de SQL Server.

Prérequis

Créer un notebook

Les étapes suivantes montrent comment créer un fichier de notebook dans Azure Data Studio :

  1. Dans Azure Data Studio, connectez-vous à votre serveur SQL Server.

  2. Effectuez la sélection sous Connexions dans la fenêtre Serveurs. Sélectionnez ensuite Nouveau notebook.

  3. Attendez que Noyau et le contexte cible (Attacher à) soient remplis. Vérifiez que Noyau indique SQL, puis définissez Attacher à avec votre serveur SQL Server (dans cet exemple, il s’agit de localhost).

    Set Kernel and Attach to

Vous pouvez enregistrer le notebook à l’aide de la commande Enregistrer ou Enregistrer sous du menu Fichier.

Pour ouvrir un notebook, vous pouvez utiliser la commande Ouvrir le fichier du menu Fichier, sélectionner Ouvrir le fichier dans la page Bienvenue, ou utiliser la commande Fichier : Ouvrir dans la palette de commandes.

Changer la connexion SQL

Pour changer la connexion SQL pour un notebook :

  1. Sélectionnez le menu Attacher à dans la barre d’outils du notebook, puis sélectionnez Changer la connexion.

    Select the Attach to menu in the notebook toolbar

  2. Vous pouvez maintenant sélectionner un serveur de connexion récent ou entrer de nouveaux détails de connexion pour vous connecter.

Exécuter une cellule de code

Vous pouvez créer des cellules contenant du code SQL que vous pouvez exécuter sur place en cliquant sur le bouton Exécuter la cellule (flèche noire ronde) à gauche de la cellule. Les résultats sont affichés dans le notebook après la fin de l’exécution de la cellule.

Par exemple :

  1. Ajoutez une nouvelle cellule de code en sélectionnant la commande + Code dans la barre d’outils.

    Notebook toolbar

  2. Copiez et collez l’exemple suivant dans la cellule, puis cliquez sur Exécuter la cellule. Cet exemple crée une base de données.

    USE master
    GO
    
    -- Drop the database if it already exists
    IF  EXISTS (
            SELECT name
            FROM sys.databases
            WHERE name = N'TestNotebookDB'
       )
    DROP DATABASE TestNotebookDB
    GO
    
    -- Create the database
    CREATE DATABASE TestNotebookDB
    GO
    

    Run cell

Enregistrer le résultat

Si vous exécutez un script qui retourne un résultat, vous pouvez enregistrer ce résultat dans différents formats à l’aide de la barre d’outils affichée au-dessus du résultat.

  • Enregistrer au format CSV
  • Enregistrer au format Excel
  • Enregistrer au format JSON
  • Enregistrer au format XML

Par exemple, le code suivant retourne le résultat de PI.

SELECT PI() AS PI;
GO

Save the result

Étapes suivantes

Découvrez-en plus sur les notebooks :