Editeur de requête

L'éditeur de requête vous permet d'exécuter des requêtes SQL sur un hôte et une base de données spécifiques. Vous pouvez également sauvegarder les requêtes que vous créez.

Exécution de requêtes à l'aide de l'éditeur de requêtes

Accédez à l'éditeur de requête.
Dans Objets de données, sélectionnez la base de données et le schéma dans lesquels vous souhaitez exécuter la requête. Si vous ne choisissez pas de base de données, la base de données par défaut " SYSTEM est sélectionnée. Si vous sélectionnez une base de données mais que vous ne sélectionnez pas de schéma, le schéma par défaut de la base de données est sélectionné.
Saisissez les instructions SQL que vous souhaitez exécuter. Dans l'éditeur de requêtes, chaque instruction SQL est séparée par le séparateur d'instructions par défaut - un point-virgule (;). Lorsque vous exécutez une requête avec le paramètre par défaut, chaque instruction SQL est exécutée dans sa propre session.

Exemple :
```
SELECT * FROM "TESTDB"."ADMIN"."TEST_TABLE" LIMIT 10;

INSERT INTO "TESTDB"."ADMIN"."TEST_TABLE" ("COL1") VALUES (1);

SELECT * FROM "TESTDB"."ADMIN"."TEST_TABLE" LIMIT 10;
```
Les instructions de l'exemple s'exécutent dans deux sessions distinctes.
- Si vous souhaitez exécuter des requêtes qui contiennent des points-virgules dans une même session, voir Exécution d'instructions SQL dans une même session.
- Si vous souhaitez regrouper des requêtes qui contiennent des points-virgules pour les exécuter dans des sessions de variables, voir Exécution de plusieurs instructions SQL dans des sessions différentes.
Si votre requête est une instruction SELECT, une option Set Limit s'affiche. Avec Set Limit, vous pouvez spécifier le nombre de lignes de données à extraire. La valeur par défaut est No limit.
Dans les paramètres de la feuille de travail, vous pouvez ajouter les options suivantes :
- une clause de limitation dans une instruction de sélection qui est supérieure à la limite du nombre maximal de lignes par défaut dans le résultat.
  
  Exemple :
```
select * from table1 limit 10;
```
  La zone Résultats affiche la plus petite valeur de ces deux paramètres.
- définir le champ Séparateur de déclaration comme vide ou saisir un séparateur autre que le point-virgule " ;" . Par exemple, vous pouvez choisir l'esperluette " &.
- définir le délai d'attente de l'éditeur de requêtes en minutes.
Sélectionnez l'une des options suivantes :
- Cliquez sur Exécuter pour exécuter la requête. Vous pouvez exécuter la sélection, l'exécution jusqu'au curseur ou l'exécution à partir du curseur. Les résultats de la requête sont affichés en un seul bloc dans le tableau de bord.
- Cliquez sur l'icône de la disquette qui se trouve dans la barre d'outils " SQLworksheet pour enregistrer la requête en tant que modèle. La requête enregistrée est ajoutée aux Requêtes enregistrées et aux Requêtes > Requêtes récentes.
- Cliquer sur Effacer pour effacer la requête.

L'éditeur de requêtes prend en charge un ensemble de résultats maximum de 519 999 999 lignes. Si une requête dépasse cette limite, elle renvoie l'erreur suivante : " Error: The query result set is too large to load, please add or reduce the row limit.

Exécution de plusieurs instructions SQL dans une même session

Accédez à l'éditeur de requête.
Dans Objets de données, sélectionnez la base de données et le schéma dans lesquels vous souhaitez exécuter la requête. Si vous ne choisissez pas de base de données, la base de données par défaut " SYSTEM est sélectionnée. Si vous sélectionnez une base de données mais que vous ne sélectionnez pas de schéma, le schéma par défaut de la base de données est sélectionné.
Saisissez les instructions SQL que vous souhaitez exécuter.

Exemple :
```
set schema A1; create table TBL1 (COL1 int);
```
Dans les paramètres de la feuille de travail, vous pouvez ajouter les options suivantes :
- Si votre requête est une instruction SELECT, une option Set Limit s'affiche. Avec Set Limit, vous pouvez spécifier le nombre de lignes de données à extraire. La valeur par défaut est No limit. Ajoutez une clause de limite dans une instruction SELECT supérieure au nombre maximal de lignes par défaut dans le résultat.
  
  Exemple :
```
select * from table1 limit 10;
```
  La zone Résultats affiche la plus petite valeur de ces deux paramètres.
- mettre le champ " Statement separator à vide ou taper un séparateur autre que le point-virgule " ;. Par exemple, vous pouvez choisir l'esperluette " &. Lorsque vous utilisez un séparateur vide ou un séparateur autre que le séparateur par défaut, toutes les instructions de la feuille de calcul en cours peuvent s'exécuter ensemble, dans la même session. A présent, les 2 instructions de l'exemple de l'étape 3 s'exécutent dans une session.
- définir le délai d'attente de l'éditeur de requêtes en minutes.
Sélectionnez l'une des options suivantes :
- Cliquez sur Exécuter pour exécuter la requête. Vous pouvez exécuter la sélection, l'exécution jusqu'au curseur ou l'exécution à partir du curseur. Les résultats de la requête sont affichés en un seul bloc dans le tableau de bord.
- Cliquez sur l'icône de la disquette qui se trouve dans la barre d'outils " SQLworksheet pour enregistrer la requête en tant que modèle. La requête enregistrée est ajoutée aux Requêtes enregistrées et aux Requêtes > Requêtes récentes.
- Cliquer sur Effacer pour effacer la requête.

Exécution de plusieurs instructions SQL dans des sessions différentes

Accédez à l'éditeur de requête.
Dans Objets de données, sélectionnez la base de données et le schéma dans lesquels vous souhaitez exécuter la requête. Si vous ne choisissez pas de base de données, la base de données par défaut " SYSTEM est sélectionnée. Si vous sélectionnez une base de données mais que vous ne sélectionnez pas de schéma, le schéma par défaut de la base de données est sélectionné.

Saisissez les instructions SQL que vous souhaitez exécuter.

Exemple :

set schema A1; create table TBL1 (COL1 int) & select * from A1.TBL1

Dans les paramètres de la feuille de travail, vous pouvez ajouter les options suivantes :
- Si votre requête est une instruction SELECT, une option Set Limit s'affiche. Avec Set Limit, vous pouvez spécifier le nombre de lignes de données à extraire. La valeur par défaut est No limit. Ajoutez une clause de limite dans une instruction SELECT supérieure au nombre maximal de lignes par défaut dans le résultat.
  
  Exemple :
```
select * from table1 limit 10;
```
  La zone Résultats affiche la plus petite valeur de ces deux paramètres.
- fixer le champ " Statement separator à un séparateur autre que le point-virgule " ;. Par exemple, vous pouvez choisir l'esperluette " &. Dans l'exemple de l'étape 3, les deux premières instructions sont exécutées dans la même session et la troisième dans une session distincte. l'expression & est utilisée pour séparer la troisième instruction dans la feuille de calcul.
- définir le délai d'attente de l'éditeur de requêtes en minutes.
Sélectionnez l'une des options suivantes :
- Cliquez sur Exécuter pour exécuter la requête. Vous pouvez exécuter la sélection, l'exécution jusqu'au curseur ou l'exécution à partir du curseur. Les résultats de la requête sont affichés dans le panneau en plusieurs blocs (en fonction du nombre de sessions que vous avez choisi d'exécuter).
- Cliquez sur l'icône de la disquette qui se trouve dans la barre d'outils " SQLworksheet pour enregistrer la requête en tant que modèle. La requête enregistrée est ajoutée aux Requêtes enregistrées et aux Requêtes > Requêtes récentes.
- Cliquer sur Effacer pour effacer la requête.