Documentation Invantive
Forums d'Invantive SupportConnectez-vous/inscrivez-vous

Éditeur SQL

Le formulaire « SQL Editor » permet à Invantive UniversalSQL d’accéder au contenu d’un databases.

Commencez par choisir la base de données à utiliser. La base de données sélectionnée s’affiche dans le groupe de menus jusqu’à ce que la connexion soit interrompue :

Le menu d'Invantive Cloud affichant « SQL Editor », « Dashboard », une base de données connectée et « Licensing ».

L’éditeur SQL s’ouvre et affiche trois groupes :

L'éditeur SQL d'Invantive Cloud avec une requête et l'onglet « Available Objects » répertoriant les objets du dictionnaire de données.

Boutons

Le bouton « Exécuter » exécute l’instruction Invantive UniversalSQL dans laquelle le curseur est positionné. Une sélection s’exécute comme une seule instruction, même lorsqu’elle contient une ligne vide. Le raccourci clavier est Ctrl+Entrée.

À partir de la version 28.0 et dans sa version bêta 27.1, le bouton « Execute All » exécute toutes les instructions de la sélection, ou de l’ensemble du texte si rien n’est sélectionné, les unes après les autres. Les instructions sont séparées par une ligne vide, comme dans l’outil de requête. L'exécution s'arrête à la première instruction qui échoue. Le raccourci clavier est Ctrl+Maj+Entrée.

Le bouton « Déconnecter » permet de se déconnecter de la base de données et supprime également celle-ci du groupe de menus.

Le bouton « SQL Grammar » affiche le code Grammar à titre de référence.

Éléments

La fenêtre de l’éditeur SQL s’affiche au premier plan. La zone s'agrandit pour afficher davantage de texte si nécessaire.

L'onglet « Objets disponibles » affiche les objets par conteneur de données. Double-cliquez sur un objet pour insérer une instruction permettant de récupérer les données dans l’éditeur SQL.

L’onglet « Résultats » affiche les résultats de la requête :

L'onglet « Results » de l’éditeur Invantive Cloud SQL, affichant une requête sur les phases du projet et trois lignes renvoyées.

Le champ « Search » permet de saisir un texte afin de limiter les résultats aux seules lignes contenant ce texte dans n’importe quelle colonne.

Après « Exécuter tout », les résultats affichent la dernière instruction ayant renvoyé des lignes. Une liste située au-dessus des résultats permet de sélectionner le résultat d’une autre instruction.

L'onglet « Output » affiche les lignes écrites avec dbms_output. À partir de la version 28.0 et dans sa version bêta 27.1, les lignes s’affichent pendant l’exécution de l’instruction, et une instruction qui échoue conserve ses lignes.

Exécution des instructions

À partir de la version 28.0 et dans sa version bêta 27.1, un repère dans la marge à gauche des numéros de ligne indique où se trouve chaque instruction pendant son exécution :

  • une flèche pendant l’exécution de l’instruction ;
  • une coche lorsqu’elle aboutissait ;
  • une croix en cas d’échec ;
  • un carré lorsqu’elle était interrompue.

Les lignes de l’instruction en cours d’exécution et d’une instruction ayant échoué sont surlignées. Un lecteur d'écran annonce ces mêmes changements à voix haute.

Le bouton « Annuler » interrompt l’exécution des instructions. Le fait de quitter la page les interrompt également. Une instruction dont l’exécution dépasse la limite fixée par Invantive Cloud est interrompue ; le temps pris en compte correspond uniquement à la durée d’exécution.

Avancement

L'onglet « Progress » affiche le déroulement de l'instruction en cours d'exécution : chaque étape de l'exécution est représentée par une carte, les lignes indiquent le passage des lignes d'une étape à la suivante, et chaque carte affiche les lignes, le temps, les appels et le nombre d'octets de cette étape. Le panneau s’affiche selon l’apparence claire ou sombre de la page. Le point d’interrogation situé à droite de la barre d’outils ouvre l’aide du panneau, qui explique chaque symbole figurant sur une carte à l’aide d’une fiche numérotée par type de carte. Les boutons « Pace », « Freeze All » et « Release 10 Rows » de la barre d’outils suspendent l’exécution de l’instruction dans son intégralité. Ces modifications concernent le moment où les lignes sont transmises, et non la valeur renvoyée par l’instruction. À partir de la version 28.0 et dans sa version bêta 27.1, un rythme ou l’option « Freeze All » sélectionné avant « Execute » s’applique à l’instruction dès son début. Avec « Freeze All », chaque étape attend avant d’interroger un conteneur de données, de sorte que l’image montre ce que l’instruction va faire ; « Unleash All » permet de poursuivre l’exécution. Avec « Exécuter tout », chaque instruction suivante suit les indications de la barre d’outils au moment de son lancement. Un clic sur une carte ouvre un tiroir sous l’image contenant les figures de cette étape et trois boutons :

  • « Peek at the Rows » conserve une copie des lignes transmises par l’étape et les affiche sous les noms attribués aux colonnes dans l’instruction. Au maximum cent lignes sont conservées, pour un volume maximal d’un mégaoctet.
  • « Freeze This Step » suspend l’étape pendant que le reste de l’instruction s’exécute. Le bouton reste enfoncé tant que l'étape est suspendue ; appuyer à nouveau dessus permet à l'étape de se poursuivre. Depuis la version 28.0 et dans sa version bêta 27.1, le bouton « Unleash All » de la barre d’outils permet également de les libérer ; auparavant, il fallait appuyer à nouveau sur le bouton pour y parvenir.
  • « Libérer 10 lignes » permet à une étape bloquée de laisser passer dix lignes, puis de se figer à nouveau. Jusqu’à « Libérer 27.0 » inclus, ce bouton s’intitule « Conserver dix lignes », et celui de la barre d’outils s’intitule « Étape 10 ».

Étapes identiques

De nombreuses étapes qui effectuent la même action, comme la lecture à chaque itération d’une boucle, sont représentées par une seule carte portant leur numéro. Son tiroir répertorie les étapes une par ligne, avec les lignes, la durée, les appels et l’échec de chacune d’entre elles. À partir de la version 28.0 et dans sa version bêta 27.1, les boutons situés dans le tiroir d’une telle carte agissent sur l’ensemble de ces étapes, y compris celles qui interviennent plus tard dans la même exécution, comme la lecture de l’itération suivante de la boucle. « Freeze This Step » s’affiche ici sous la forme « Freeze These Steps ». « Libérer 10 lignes » laisse passer dix lignes parmi toutes ces étapes, et « Jeter un œil aux lignes » conserve les lignes de chacune d’entre elles. Auparavant, ces boutons n’agissaient que sur la première des étapes, qui, dans une boucle, est généralement terminée.

Notes de Version