Vous pouvez exécuter des instructions SQL, des scripts PL/SQL et du code JavaScript dans l'éditeur de feuille de calcul SQL. L'éditeur a notamment pour particularité d'exécuter du code en contexte, de mettre en surbrillance la syntaxe et de déboguer les erreurs.

Vous pouvez entrer des instructions SQL ou des blocs de code PL/SQL pour indiquer des actions telles que la création d'une table, l'insertion de données, la sélection de données ou la suppression de données dans une table. Les mots-clés SQL sont automatiquement mis en surbrillance. Pour plusieurs instructions, vous devez mettre fin aux éléments suivants :

• Chaque instruction non PL/SQL comportant un point-virgule ( ;) ou une barre oblique (/) sur une nouvelle ligne.
• Chaque instruction PL/SQL avec une barre oblique (/) sur une nouvelle ligne.

Pour connaître les instructions SQL*Plus et SQLcl prises en charge dans la feuille de calcul, reportez-vous à Commandes SQL*Plus et SQLcl prises en charge dans SQL Worksheet.

Le mode Editeur PL/SQL est déclenché dans la feuille de calcul lors de l'ouverture des types d'objet suivants : Functions, Procedures, Packages et Types. Cet éditeur vous aide à détecter les erreurs dans votre code PL/SQL lors de la compilation. La sortie inclut des détails d'erreur tels que la ligne et la colonne spécifiques où l'erreur est détectée, ainsi qu'un lien permettant d'accéder à la position appropriée dans le bloc de code.

Le mode de feuille de calcul JavaScript prend en charge la fonctionnalité Multilingual Engine introduite dans Oracle Database version 21c. Pour plus d'informations, reportez-vous à Prise en charge de Multilingual Engine.

Assistance à l'éditeur de code

Si vous appuyez sur Ctrl+Space, l'éditeur fournit une liste des exécutions possibles au point d'insertion que vous pouvez utiliser pour compléter automatiquement le code que vous modifiez. Cette liste est basée sur le contexte de code au point d'insertion.

L'éditeur propose également une liste complète des commandes disponibles via la palette de commandes. Pour ouvrir la palette de commandes, appuyez sur Ctrl+Shift+P. Pour obtenir la liste des touches de raccourci clavier, reportez-vous à la section Keyboard Shortcuts.

Une erreur dans le code est signalée par un point rouge dans la gouttière gauche et une ligne de squiggle sous le texte spécifique. Lorsque vous passez le pointeur de la souris dessus, une fenêtre contextuelle affiche les corrections possibles pour résoudre l'erreur.

Glisser-déplacer des objets pour générer automatiquement des instructions SQL

Vous pouvez faire glisser des objets à partir du volet de gauche et les déposer dans l'éditeur de feuille de calcul dans le volet de droite.

• Si vous faites glisser une table ou une vue, vous êtes invité à sélectionner l'une des instructions SQL suivantes : Insert, Update, Select ou Delete.

  Par exemple, si vous choisissez Sélectionner, une instruction Select est créée avec toutes les colonnes de la table ou de la vue. Vous pouvez ensuite modifier l'instruction, par exemple en modifiant la liste des colonnes ou en ajoutant une clause WHERE.

  

  Si vous choisissez Nom d'objet, le nom de l'objet précédé du nom de schéma est ajouté à la feuille de calcul.

• Si vous faites glisser une fonction ou une procédure, vous pouvez choisir d'insérer le nom ou le code PL/SQL de la fonction ou de la procédure dans la feuille de calcul. Si vous sélectionnez du code PL/SQL, vous pouvez saisir les paramètres avant d'insérer le code dans la feuille de calcul.

Définir les préférences de l'éditeur

Vous pouvez définir les préférences de l'éditeur de code à l'aide de l'option Préférences disponible dans la barre latérale gauche. Certaines options de l'éditeur de code que vous pouvez personnaliser sont Thème (lumière, sombre et contraste élevé), Taille et famille de la police, Taille de l'onglet, Enveloppe Word, Règle, Numéros de ligne, etc.

Icônes de la barre d'outils

La barre d'outils de l'éditeur SQL Worksheet contient des icônes pour les opérations suivantes :

• Liste déroulante Feuille de calcul

  • Ouvrir : ouvrez un fichier à partir du navigateur, de l'appareil ou du stockage d'objets.
  • Ouvrir récent : affiche les fichiers récemment consultés. S'il y a plus de cinq fichiers dans la liste récente, un lien Plus apparaît pour afficher les fichiers supplémentaires.
  • Enregistrer sous : enregistrez un fichier dans le navigateur, l'appareil ou le stockage d'objets.
• Nouveau fichier
  • Sélectionnez Feuille de calcul : créez une feuille de calcul.
  • Sélectionnez PL/SQL : créez un type d'objet PL/SQL. L'éditeur passe en mode PL/SQL.
• Ouvrir : ouvrez un fichier à partir du navigateur, de l'appareil ou du stockage d'objets. Pour ouvrir un fichier à partir de votre appareil, dans le curseur Ouvrir un fichier, cliquez sur Ouvrir un fichier et parcourez pour sélectionner le fichier, ou faites glisser le fichier vers le curseur.

• Exécuter l'instruction : exécutez les instructions sélectionnées ou l'instruction située au niveau du pointeur de la souris dans l'éditeur de feuille de calcul. Les instructions SQL peuvent inclure des variables attachées et des variables de substitution de type VARCHAR2. Une boîte de dialogue s'affiche pour la saisie de valeurs de variable.

• Exécuter le script : exécutez toutes les instructions de l'éditeur de feuille de calcul à l'aide de Script Runner. Les instructions SQL peuvent inclure des variables attachées (mais pas des variables de substitution) de type VARCHAR2. Une boîte de dialogue s'affiche pour la saisie des valeurs des variables attachées.

• Compile (pour la barre d'outils PL/SQL) : Effectuez une compilation PL/SQL du sous-programme.

  Remarque
  
  L'icône Compile n'est pas disponible pour les services de base de données MySQL.

• Plan d'exécution : générez le plan d'exécution de l'instruction. La sortie est affichée dans l'onglet Explain Plan du volet de sortie. Reportez-vous à la section Using the Explain Plan Diagram

  Remarque
  
  L'icône Explain Plan n'est pas disponible pour les services de base de données MySQL.

• Autotrace : exécutez l'instruction et affichez les statistiques d'exécution de l'instruction SQL et le plan d'exécution réel. La sortie s'affiche dans l'onglet Autotrace du volet de sortie.

  Remarque
  
  L'icône Autotrace n'est pas disponible pour les services de base de données MySQL.

• Télécharger le contenu de l'éditeur : téléchargez le contenu de la feuille de calcul en tant que fichier SQL vers le système local.

• Format : formatez l'instruction SQL dans l'éditeur, par exemple en mettant en majuscules les noms des instructions, des clauses, des mots-clés, et en ajoutant des sauts de ligne et des indentations.

• Effacer : enlevez les instructions de l'éditeur.

• Ouvrir en plein écran : ouvrez l'éditeur en mode plein écran.

• Chargement des données : ouvrez l'assistant Chargement des données. Reportez-vous à la section Chargement des données.

  Remarque
  
  L'icône Chargement de données n'est pas disponible pour les services de base de données MySQL.