ApsaraDB for OceanBase (Deprecated):Modifier et exporter le jeu de résultats d'une instruction SQL

Cette rubrique explique comment modifier et exporter les résultats d'exécution.

Modifier le jeu de résultats

1. Dans la fenêtre SQL, rédigez et exécutez une instruction SQL pour interroger les données de la table employee.

   

   SELECT `emp_no`, `birthday`, `name` FROM `odc_test`.`employee`;
   

2. Dans l'onglet des résultats illustré ci-dessus, cliquez sur l'icône Edit pour modifier le jeu de résultats.

   La barre de navigation de l'onglet des résultats propose également les icônes suivantes.

   Icône	Description
   Modifier	Cliquez sur Edit pour activer le mode d'édition du jeu de résultats actuel. Le mode d'édition prend en charge les opérations suivantes : Add, Copy Current Row, Delete, Cancel, Confirm Modification (qui valide une transaction lorsque la validation automatique est activée) et Modify and Submit (affiché lorsque la validation automatique est désactivée). En mode d'édition, double-cliquez sur la donnée cible pour la modifier directement ou utilisez les icônes précédentes pour effectuer des actions pratiques. Lorsque vous modifiez une cellule, cliquez avec le bouton droit sur celle-ci et sélectionnez Copy ou Set to Null dans le menu contextuel. Remarque Le ResultMetaData est obtenu lors de l'exécution d'une instruction SQL pour indiquer si le jeu de résultats peut être modifié. Si le jeu de résultats ne peut pas être modifié, l'icône Edit est masquée et un message indique que la modification est impossible. Si le jeu de résultats peut être modifié, l'icône Edit est disponible. Cliquez dessus pour accéder à la page de modification du jeu de résultats. Vous pouvez modifier les jeux de résultats issus de requêtes portant sur une seule table ou une seule vue. Toutefois, les jeux de résultats contenant des champs SET et ENUM ne peuvent pas être modifiés.
   Plan	Cliquez sur cette icône pour afficher la consommation réelle des ressources et le plan d'exécution d'une instruction SQL exécutée. Cela permet d'évaluer les performances de l'instruction.
   Trace de bout en bout	Consultez les traces de bout en bout enregistrées lors de l'exécution de l'instruction SQL actuelle. Les traces de bout en bout permettent de connaître rapidement le temps d'exécution d'une instruction SQL ou d'une transaction sur chaque nœud, ce qui facilite l'identification des anomalies. Remarque Vous pouvez afficher les traces de bout en bout uniquement pour OceanBase Database V4.1.0 et versions ultérieures.
   Retour au début	Cliquez sur cette icône pour revenir à la première page.
   Précédent	Cliquez sur cette icône pour accéder à la page précédente.
   Suivant	Cliquez sur cette icône pour accéder à la page suivante.
   Aller en bas	Cliquez sur cette icône pour atteindre la dernière page.
   Rechercher	Saisissez un mot-clé dans le champ de recherche pour trouver les résultats souhaités.
   Télécharger les données	Cliquez sur cette icône pour exporter les résultats de la requête.
   Colonnes	Cliquez sur cette icône pour sélectionner les colonnes à afficher sur la page.
   Mode Colonne	Cliquez sur cette icône pour afficher la ligne de données sélectionnée sous forme de tableau. Dans l'onglet Column Mode , passez à la ligne précédente ou suivante. Le mode colonne facilite la visualisation des données d'une ligne comportant de nombreuses colonnes. Procédez comme suit : Sélectionnez les données à afficher et cliquez sur Column Mode. Dans l'onglet Column Mode , cliquez sur la flèche gauche ou droite pour basculer entre les valeurs de colonne des lignes adjacentes. Placez le pointeur sur un champ de valeur et cliquez sur l'icône de zoom pour afficher les détails. Dans le tableau de l'onglet Column Mode , consultez les commentaires d'une colonne dans la colonne Remarks . Suivez les étapes ci-dessous pour modifier les commentaires : Dans le volet de navigation de gauche, cliquez avec le bouton droit sur la table cible et sélectionnez View Table Structure pour accéder à l'onglet Attribut. Dans le volet de navigation de gauche de l'onglet Attribut, cliquez sur l'onglet Column . Sélectionnez un champ et cliquez sur l'icône Modifier. La boîte de dialogue d'édition du champ s'affiche. Dans le champ Comment , modifiez les commentaires, puis cliquez sur OK. Dans la boîte de dialogue SQL Confirmation , cliquez sur Execute. Consultez les commentaires modifiés dans l'onglet Column Mode .

   Important

   Il est impossible de modifier un jeu de résultats contenant des champs de type SET ou ENUM.

3. Cliquez sur + pour ajouter une ligne et modifier les données.

   

4. Cliquez sur Modify and Submit.

   Remarque

   Si la connexion actuelle utilise le mode de session partagée, les modifications envoyées s'appliquent à toutes les fenêtres.

5. Dans la boîte de dialogue SQL Confirmation , confirmez l'instruction SQL et cliquez sur Execute.

   

6. Les données sont ajoutées à l'onglet Results .

   

   Effectuez les opérations suivantes sur un jeu de résultats pour faciliter le développement quotidien.

   Opération	Description
   Sélectionner les données requises	Sélectionnez les données nécessaires d'un jeu de résultats et copiez-les dans un fichier externe à l'aide de raccourcis clavier. Cliquez également sur un nom de champ ou un ID de ligne pour sélectionner une ligne ou une colonne entière. Il est aussi possible de cliquer sur Export dans la barre d'outils pour exporter les données d'un jeu de résultats vers un fichier local.
   Sélectionner des lignes et des colonnes	Sélectionnez des lignes ou des colonnes consécutives en maintenant la touche Maj enfoncée. Sélectionnez des lignes ou des colonnes non consécutives en maintenant la touche Ctrl ou Command enfoncée.
   Cliquer avec le bouton droit sur une cellule	Cliquez avec le bouton droit sur une cellule et sélectionnez Copy ou Export to Clipboard pour exporter directement les données dans un fichier externe.
   Cliquer avec le bouton droit sur un ID de ligne	Cliquez avec le bouton droit sur un ID de ligne et sélectionnez Copy Row, Freeze this row, Unlock all frozen rows ou Export to Clipboard. Copy Row : Sélectionnez cette option pour copier la ligne choisie. Freeze this row : Sélectionnez cette option pour figer la ligne choisie et l'épingler en haut. Il est possible de figer plusieurs lignes. Les lignes situées sous l'en-tête du tableau et les lignes figées peuvent faire défiler verticalement. Unlock all frozen rows : Sélectionnez cette option pour dégeler toutes les lignes figées. Export to Clipboard : Sélectionnez cette option pour envoyer la ligne entière dans le presse-papiers au format SQL ou CSV.
   Agrandir	Si les données d'une cellule sont trop longues pour s'afficher entièrement, placez le pointeur sur la cellule et cliquez sur l'icône d'agrandissement située à l'extrémité droite de la cellule. Consultez l'intégralité des données dans la fenêtre qui s'affiche. Remarque Les LOB sont affichés sous forme de texte par défaut. Convertissez un LOB au format hexadécimal et téléchargez-le sur votre appareil local.
   Afficher les BLOB	Dans l'onglet des résultats : En mode Oracle, modifiez directement les données textuelles de type CLOB, BLOB ou RAW, éditez les données hexadécimales et importez des fichiers. Un fichier importé ne doit pas dépasser 2 Mo au format texte, 200 Ko au format hexadécimal et 20 Mo au format image. En mode MySQL, modifiez directement les données textuelles de type XLOB (telles que BLOB, MEDIUMBLOB ou TINYBLOB), éditez les données hexadécimales et importez des fichiers.
   Cliquer avec le bouton droit sur le nom de l'onglet d'un onglet de résultats	Par exemple, cliquez avec le bouton droit sur le nom de l'onglet Result 1 et sélectionnez Pin dans le menu contextuel pour épingler l'onglet, afin qu'il reste affiché. Ainsi, lorsque vous exécutez une nouvelle requête, un nouvel onglet de résultats apparaît sans écraser l'onglet épinglé. Cela permet de comparer les résultats des requêtes. Cliquez sur Unpin pour désépingler un onglet de résultats.
   Filtrer, trier et rechercher des données	Chaque nom de champ du jeu de résultats est accompagné d'une icône de filtre, d'une icône de tri et d'une icône de recherche. Utilisez-les pour filtrer, trier et rechercher des données dans une seule colonne.
   Faire glisser le nom de la colonne	Ajustez l'ordre des champs en faisant glisser les noms de colonnes dans un jeu de résultats.
   Ajuster la largeur de la colonne	Ajustez la largeur de la colonne en faisant glisser le bord de la colonne.
   Afficher le type de champ et les remarques dans la barre d'état	Cliquez sur un champ du jeu de résultats pour afficher le type et les remarques de ce champ dans la barre d'état en bas de la page.

Exporter le jeu de résultats

Supposons que vous souhaitiez exporter la table employee vers votre disque local au format EXCEL.

1. Dans le jeu de résultats, cliquez sur .

   

2. Dans le panneau New Export Result Set , spécifiez les informations de la tâche d'exportation et cliquez sur New.

   

   Paramètre	Description
   Query SQL	Rédigez une instruction SQL de requête pour sélectionner les données à exporter.
   Nombre maximal de lignes dans le jeu de résultats	Le nombre de lignes à exporter n'est plus limité par la fenêtre de requête. Définissez le nombre de lignes à exporter.
   Nom du fichier	Saisissez le nom du fichier exporté.
   Format du fichier	Exportez le résultat de la requête sous forme de fichier CSV, SQL ou EXCEL. Pour exporter un fichier SQL, spécifiez Query SQL, Maximum Number of Rows in Result Set, File Name, File Format (sur SQL), File Encoding, Data Desensitization et SQL File Settings (par exemple Table Name). Pour exporter un fichier CSV, spécifiez Query SQL, Maximum Number of Rows in Result Set, File Name, File Format, File Encoding, Data Desensitization et CSV Settings (par exemple Include Column Header, Empty string to null value, Field Separator, Text Identifier et Line Break). Utilisez EXCEL pour ouvrir le fichier CSV exporté. Pour exporter un fichier EXCEL, spécifiez Query SQL, Maximum Number of Rows in Result Set, File Name, File Format, File Encoding, Data Desensitization et Excel File Settings (par exemple Include Column Header et Export SQL to another Sheet). Lors de l'exportation d'un fichier EXCEL, définissez s'il faut inclure les en-têtes de colonne et s'il faut exporter les instructions SQL de requête.
   Encodage du fichier	Spécifiez le format d'encodage du fichier.
   Paramètres du fichier Excel	Spécifiez s'il faut exporter les en-têtes de colonne et s'il faut exporter les instructions SQL vers une autre feuille.

3. Dans l'onglet Ticket-Export Result Set , cliquez sur View dans la colonne Actions de la tâche.

   

4. Dans le panneau Task Details , cliquez sur Download.

   

5. Consultez la table employee_excel exportée sur votre disque local.

   

Références

• Rédiger et exécuter des instructions SQL

• Compiler et déboguer PL

• Analyse de l'exécution

• Générer des données de test