Partager via

Notebooks SQL (préversion)

Les notebooks SQL de l'extension MSSQL pour Visual Studio Code permettent le développement SQL en utilisant les notebooks Jupyter natifs de Visual Studio Code. Vous pouvez combiner l’exécution interactive des requêtes SQL avec des cellules de documentation Markdown pour créer des collections de requêtes exécutables, des opérations de base de données de documents et partager une analyse reproductible.

Conseil / Astuce

Les notebooks SQL sont actuellement en version préliminaire et peuvent changer en fonction des retours des utilisateurs. Rejoignez la communauté dans GitHub Discussions pour partager des idées ou signaler des problèmes.

Fonctionnalités

Les notebooks SQL offrent ces fonctionnalités :

  • Exécutez des requêtes T-SQL de manière interactive dans des cellules de code notebook avec des résultats inline affichés sous chaque cellule.

  • Utilisez le format natif du bloc-notes Jupyter Visual Studio Code (.ipynb fichiers) pour une compatibilité totale avec les outils de notebook existants.

  • Afficher les résultats de la requête dans une grille de données enrichie avec tri, filtrage, sélection de cellule, mise en surbrillance de valeurs null et options de copie (y compris la copie avec des en-têtes).

  • Écrivez SQL avec IntelliSense, y compris les suggestions de nom de table et de colonne en fonction de votre connexion de base de données active.

  • Ajoutez des cellules de texte Markdown en même temps que des cellules de code SQL pour documenter les requêtes, annoter les résultats et créer des flux de travail de narration.

  • Connectez chaque bloc-notes à une instance SQL Server et basculez entre les bases de données sur le même serveur.

  • Exécutez des cellules individuellement ou exécutez toutes les cellules de manière séquentielle.

  • Utilisez GitHub Copilot pour les suggestions de requête en ligne dans les cellules de code et la création de notebooks par conversation pour générer des notebooks complets à partir de descriptions en langage naturel.

  • Combinez des cellules SQL avec d’autres noyaux de langage (tels que Python) dans le même notebook en installant l’extension Jupyter.

  • Exportez et partagez des notebooks au format .ipynb, que d’autres peuvent ouvrir dans Visual Studio Code ou dans n’importe quel environnement compatible Jupyter.

Prerequisites

Avant d’utiliser des notebooks SQL, vérifiez que les conditions suivantes sont remplies :

Créer un notebook SQL

Vous pouvez créer un bloc-notes SQL de plusieurs façons :

  • Ouvrez la palette de commandes (Ctrl+Maj+P sur Windows et Linux, ou Cmd+Maj+P sur macOS), tapez New Notebook, puis sélectionnez la commande.

  • Accédez au menu Fichier et sélectionnez Nouveau fichier, puis choisissez le type jupyter Notebook.

  • Cliquez avec le bouton droit sur une base de données dans l’Explorateur d’objets de l’extension MSSQL, puis sélectionnez Nouveau notebook dans le menu contextuel.

Lorsque vous créez un bloc-notes, sélectionnez le noyau MSSQL pour activer l’exécution T-SQL dans les cellules de code.

Se connecter à une base de données

Chaque notebook SQL a besoin d’une connexion de base de données active pour exécuter des requêtes. Lorsque vous ouvrez un notebook avec le noyau MSSQL, l’extension vous invite à sélectionner un profil de connexion ou à en créer un.

Important

Chaque notebook prend en charge une connexion serveur unique par noyau. Vous pouvez vous connecter à une instance SQL Server et basculer entre des bases de données sur ce serveur, mais vous ne pouvez pas vous connecter à plusieurs serveurs au sein du même notebook. Pour utiliser un autre serveur, créez un bloc-notes distinct ou modifiez la connexion du bloc-notes.

Écrire et exécuter des cellules SQL

Les cellules de code SQL vous permettent d’écrire et d’exécuter des requêtes T-SQL de manière interactive dans le notebook.

  1. Sélectionnez + Code dans la barre d’outils du bloc-notes pour ajouter une nouvelle cellule de code.

  2. Entrez votre requête T-SQL dans la cellule. La cellule offre la même expérience d’édition SQL qu’un éditeur de requête standard, y compris IntelliSense avec des suggestions de noms de table et de colonne à partir de la base de données connectée.

  3. Sélectionnez Exécuter la cellule (le bouton de lecture à gauche de la cellule) pour exécuter la requête.

  4. Les résultats apparaissent directement sous la cellule dans une grille de données enrichie.

Pour exécuter toutes les cellules du bloc-notes séquentiellement, sélectionnez Exécuter tout dans la barre d’outils du bloc-notes.

Conseil / Astuce

Utilisez Ctrl+Entrée (Windows et Linux) ou Cmd+Entrée (macOS) pour exécuter la cellule active et rester sur celle-ci. Utilisez Maj+Entrée pour exécuter la cellule active et passer à la cellule suivante.

Résultats de la requête

Les résultats de requête dans les notebooks SQL fournissent la même expérience de grille de données enrichie disponible dans l’éditeur de requête standard :

  • Tri : sélectionnez un en-tête de colonne pour trier les résultats croissants ou décroissants.
  • Filtrage : utilisez l’icône de filtre sur les en-têtes de colonne pour filtrer les données de résultat.
  • Sélection de cellule : sélectionnez des cellules individuelles ou des plages de cellules dans la grille des résultats.
  • Mise en surbrillance des valeurs nulles : NULL les valeurs sont visuellement mises en surbrillance dans la grille des résultats pour faciliter l’identification.
  • Options de copie : cliquez avec le bouton droit sur les cellules sélectionnées pour accéder à Copier, Copier avec en-têtes et sélectionner toutes les options.

Ajouter des cellules Markdown

Vous pouvez utiliser des cellules Markdown pour ajouter du texte mis en forme, des en-têtes, des listes et des liens en même temps que vos cellules de code SQL. Utilisez-les pour documenter vos requêtes, expliquer la logique métier ou ajouter des notes sur les résultats attendus.

  1. Sélectionnez + Markdown dans la barre d’outils du bloc-notes pour ajouter une nouvelle cellule de texte.

  2. Tapez votre contenu Markdown. Un aperçu s’affiche lorsque vous tapez.

  3. Sélectionnez en dehors de la cellule pour afficher le texte Markdown.

Sélectionnez à nouveau la cellule pour revenir au mode d’édition.

Utiliser plusieurs noyaux

L’extension MSSQL fournit le noyau SQL prête à l’emploi. Vous pouvez étendre vos notebooks avec davantage de noyaux de langage en installant l’extension Jupyter, qui prend en charge python et d’autres noyaux. Vous pouvez combiner des requêtes de données SQL avec des cellules de traitement et de visualisation de données Python dans le même notebook.

Intégration de GitHub Copilot

GitHub Copilot fonctionne avec des notebooks SQL pour vous aider à écrire des requêtes et à générer des notebooks. Lorsque vous installez l’extension GitHub Copilot, vous obtenez :

  • Suggestions en ligne : lorsque vous tapez dans des cellules de code SQL, GitHub Copilot suggère des complétions de requête en fonction du contexte de votre base de données et des cellules Markdown environnantes.

  • Création de notebooks pilotés par chat : Utilisez GitHub Copilot Chat pour générer des notebooks complets alternant des cellules Markdown et SQL. Décrivez l’analyse que vous souhaitez effectuer et GitHub Copilot crée la structure complète du notebook.

Par exemple, vous pouvez ouvrir GitHub Copilot Chat et utiliser une invite comme suit :

I have a SQL Notebook open connected to AdventureWorks. Create cells for a sales
analysis: list all tables, find top 10 customers by revenue, show revenue by product
category, and demonstrate a safe data modification using BEGIN TRAN / ROLLBACK.

GitHub Copilot génère les cellules de documentation Markdown et les cellules de code T-SQL, que vous pouvez ensuite exécuter individuellement ou tout en même temps à l’aide de Run All.

Changer de base de données

Pour basculer vers une autre base de données au sein de la même connexion de serveur :

  1. Sélectionnez le nom de la base de données affiché dans la zone d’état de connexion du bloc-notes.

  2. Choisissez une autre base de données dans la liste déroulante.

Toutes les exécutions de cellules suivantes utilisent la base de données nouvellement sélectionnée.

Note

Pour basculer vers un autre serveur, vous devez modifier le profil de connexion du bloc-notes. Envisagez de créer un bloc-notes distinct pour chaque serveur avec lequel vous devez travailler.

Limites

Connexion serveur unique par carnet : actuellement, chaque carnet se connecte à une instance SQL Server. Vous pouvez changer de base de données sur ce serveur, mais vous ne pouvez pas vous connecter à un deuxième serveur au sein du même notebook.

Commentaires et support

Si vous avez des idées, des commentaires ou souhaitez vous engager avec la communauté, rejoignez la discussion à l’adresse https://aka.ms/vscode-mssql-discussions. Pour signaler un bogue, visitez https://aka.ms/vscode-mssql-bug. Pour demander une nouvelle fonctionnalité, accédez à https://aka.ms/vscode-mssql-feature-request.

Contenu connexe

  • Last updated on