Écrire des requêtes et explorer des données dans le nouvel éditeur SQL

L’interface utilisateur Azure Databricks inclut un éditeur SQL que vous pouvez utiliser pour écrire des requêtes, collaborer avec des collègues, rechercher des données disponibles et créer des visualisations. Cette page présente le nouvel éditeur SQL et les liens vers les pages qui couvrent chaque tâche en détail.

Cette page décrit le nouvel éditeur SQL. Pour en savoir plus sur l’utilisation de l’éditeur SQL hérité, consultez Écrire des requêtes et explorer les données dans l’éditeur SQL hérité.

Note

À compter de la fin de mai 2026, le nouvel éditeur SQL sera activé par défaut pour tous les espaces de travail. La possibilité de désactiver le nouvel éditeur SQL au niveau de l’espace de travail n’est plus disponible. Les utilisateurs individuels pourront toujours basculer vers l’éditeur hérité pendant cette période. À compter de la fin de juillet 2026, l’éditeur SQL hérité sera mis hors service et tous les utilisateurs utiliseront le nouvel éditeur SQL. Voir Ce qui arrive? pour plus de détails.

Ouvrez l’éditeur SQL

Pour ouvrir l’éditeur SQL dans l’interface utilisateur d'Azure Databricks, cliquez sur icône de l’Éditeur SQLÉditeur SQL dans la barre latérale.

L’éditeur SQL s’ouvre sur votre dernière requête ouverte. Si aucune requête n’existe ou que toutes vos requêtes ont été explicitement fermées, la page d’accueil de l’éditeur SQL s’ouvre.

Activer le nouvel éditeur SQL

Utilisez l'option de bascule Nouvel éditeur SQL, à droite des listes déroulantes de catalogue et de schéma, pour activer le nouvel éditeur. Sur les écrans étroits, vous pouvez trouver le bouton New SQL editor en cliquant sur le menu kebab Icône du menu kebab. à droite des sélecteurs de catalogue et de schéma.

Capture d’écran montrant l’éditeur SQL avec le nouvel éditeur de requêtes désactivé

Activez le nouvel éditeur pour toute requête que vous possédez :

  • Cliquez sur New SQL editor: OFF. Un menu contextuel New SQL editor s’ouvre.
    • La case à cocher Apply to all of my queries (Appliquer à toutes mes requêtes) est sélectionnée par défaut. Conservez ce paramètre pour activer l’éditeur pour toutes les requêtes dont vous êtes propriétaire.
    • Pour activer le nouvel éditeur pour la requête active uniquement, décochez la case Appliquer à toutes mes requêtes .
  • Mettez le bouton New SQL editor sur ON.

Le nouvel éditeur SQL ne peut pas être utilisé pour toutes les requêtes. Vous ne pouvez pas passer au nouvel éditeur SQL pour une requête si l’une des conditions suivantes s'applique :

Lorsque vous activez le nouvel éditeur SQL, votre requête s’ouvre dans la nouvelle interface utilisateur. Le jeu de résultats reste vide jusqu’à ce que vous exécutiez la requête.

Note

Les résultats de la requête sont partagés avec tous les collaborateurs et sont limités à 64 000 lignes.

Orientation

Cette rubrique souligne les différences clés de l’interface utilisateur et explique comment trouver et utiliser les fonctionnalités disponibles.

Éditeur SQL avec légendes numérotées marquant le navigateur de fichiers de l’espace de travail, le volet Assistant Databricks, la flèche de réduction du code, la palette de commandes, l’outil de commentaires de code et l’historique des versions.

  1. Ouvrez le système de fichiers de l’espace de travail : vous pouvez ouvrir et organiser vos objets d’espace de travail directement à partir de l’éditeur SQL.
  2. Utilisez le code Genie intégré : Discuter avec Genie Code pour vous aider à écrire, affiner ou comprendre les requêtes. Exécutez le code généré par Genie Code à partir du volet latéral.
  3. Réduire les sections de code : cliquez sur la flèche de réduction à gauche d’un bloc de code pour masquer ou afficher des sections de code de manière sélective. Cela peut faciliter la navigation dans des fichiers volumineux.
  4. Ouvrir la palette de commandes : la palette de commandes inclut des actions courantes, des raccourcis clavier, des thèmes personnalisés et des liens pour vous aider à trouver rapidement ce dont vous avez besoin. Une fois ouverte, utilisez la barre de recherche pour rechercher des outils et des raccourcis spécifiques.
  5. Commentaire sur le code : ajoutez des commentaires au code pour favoriser la collaboration.
  6. Consulter l’historique des versions : examinez les modifications récentes apportées à votre requête.

Utiliser l’éditeur SQL

Les pages suivantes décrivent les tâches principales que vous pouvez effectuer dans le nouvel éditeur SQL :

Tâche Description
Écrire des requêtes Connectez-vous au calcul, parcourez les ressources de données et créez des requêtes.
Exécuter et partager des requêtes Exécutez des requêtes simples ou à instructions multiples, partagez-les et modifiez-les à plusieurs en temps réel.
Afficher les résultats de la requête Explorez, visualisez, téléchargez et filtrez les résultats de la requête.
Utiliser des paramètres Utilisez des paramètres nommés et configurez des widgets de paramètres.
Format personnalisé SQL Personnaliser les options de mise en forme automatique SQL.
Raccourcis clavier Référence des raccourcis clavier courants.

Copier l’ID de requête hérité

Pour obtenir l’ID de requête hérité pour une requête que vous avez migrée vers le nouvel éditeur SQL, copiez-le dans le menu Fichier . L’ID de requête hérité peut être utile pour les appels d’API ou d’autres intégrations qui le référencent.

  1. Ouvrez la requête dans le nouvel éditeur SQL.
  2. Cliquez sur l’icône du menu Kebab. en haut de l’éditeur.
  3. Cliquez surFichier>Copier l’ID de requête héritée.

Désactiver le nouvel éditeur SQL

Note

À compter de la fin mai 2026, l’opt-out au niveau de l’espace de travail pour le nouvel éditeur SQL sera supprimé. Les utilisateurs individuels peuvent toujours basculer vers l’éditeur hérité jusqu’à la fin de juillet 2026, lorsque l’éditeur SQL hérité sera entièrement mis hors service. Voir Ce qui arrive? pour plus de détails.

Pour désactiver le nouvel éditeur SQL :

  • Cliquez sur New SQL editor: ON (Nouvel éditeur SQL : ACTIVÉ). Un menu contextuel New SQL editor s’ouvre.
  • Basculez le bouton New SQL Editor (Nouvel éditeur SQL) sur OFF.
  • Dans la boîte de dialogue de confirmation, sélectionnez s’il faut désactiver le nouvel éditeur pour la requête active uniquement ou pour toutes les requêtes éligibles.
    • La case Disable for all eligible queries (Désactiver pour toutes les requêtes éligibles) est décochée. Conservez ce paramètre si vous souhaitez désactiver le nouvel éditeur uniquement pour la requête active.
    • Pour désactiver le nouvel éditeur SQL pour toutes vos requêtes, cochez la case Désactiver pour toutes les requêtes éligibles.

Pour empêcher l’ouverture automatique des requêtes dans le nouvel éditeur SQL :

  1. Dans l’espace de travail Azure Databricks, cliquez sur votre nom d’utilisateur dans la barre supérieure, puis sélectionnez Settings.
  2. Dans le volet gauche, sous Utilisateur, cliquez sur l’onglet Développeur .
  3. Désactivez Créer et ouvrir toutes les requêtes éligibles dans le nouvel éditeur SQL.

Les administrateurs d’espace de travail peuvent désactiver cette fonctionnalité au niveau de l’espace de travail en visitant le portail en préversion et en recherchant l’éditeur SQL. Consultez les aperçus Manage Azure Databricks.