SQL 
sql statement;
[ECHO|FILE]
[TABLE phrases]
END

où :

SQL

est l'identifiant de la commande SQL, qui appelle le traducteur SQL.

Remarque : les composants de la commande SQL doivent s'afficher dans l'ordre présenté ci-dessus.

sql statement

est une déclaration SQL prise en charge. La déclaration doit se terminer par un point virgule (;). Elle peut s'étendre sur plus d'une ligne. Reportez-vous à Déclarations SQL prises en charge.

Dans l'instruction SQL, les noms de champ sont limités à 48 caractères (une limitation standard ANSI de niveau 2). Les noms de vue générées à travers l'instruction SQL CREATE VIEW sont limitées à 18 caractères et les sous requêtes peuvent être nivelées jusqu'à 15 niveaux de profondeur. Les sous-interrogations corrélées ne sont pas prises en charge par FOCUS et d'autres sources de données non relationnelles.

ECHO

sont des phrases de débogage facultatives qui capturent la requête TABLE générée. Ces options sont spécifiées après la déclaration SQL.

FILE [name]

écrit les phrases TABLE traduites dans la procédure nommée. Si vous ne spécifiez pas de nom de fichier, un nom par défaut lui est attribué lors de l'exécution de la requête. Le fichier est supprimé par la suite.

TABLE phrases

sont des phrases de formatage TABLE facultatives. Consultez Phrases de formatage TABLE dans les requêtes SQL.

END ou QUIT

est nécessaire pour terminer la procédure.

La requête suivante comprend une déclaration SQL et des commandes de formatage TABLE :

SQL
SELECT BODYTYPE, AVG(MPG), SUM(SALES)
FROM CAR
WHERE RETAIL_COST > 5000
GROUP BY BODYTYPE;
TABLE HEADING CENTER
"AVERAGE MPG AND TOTAL SALES PER BODYTYPE"
END

Vous pouvez inclure des phrases de formatage TABLE dans une requête SQL en respectant les règles suivantes :

• Vous pouvez seulement utiliser les phrases de formatage TABLE avec SELECT et UNION.
• Vous devez commencer les phrases de formatage avec le mot TABLE.
• Vous pouvez spécifier des en-têtes et des pieds de page, décrire des actions avec une phrase ON, ou utiliser la commande ON TABLE SET. En outre, vous pouvez utiliser les commandes ON TABLE HOLD ou ON TABLE PCHOLD pour créer un fichier d'extraction. Vous pouvez aussi spécifier des tests READLIMIT et RECORDLIMIT.

  Pour plus de détails à propos des en-têtes et pieds de page, consultez Utilisation d'en-têtes, pieds de page, titres et étiquettes.

  Pour plus de détails sur ON TABLE HOLD ou ON TABLE PCHOLD, consultez Enregistrer et réutiliser la sortie de rapport.

• Vous ne pouvez pas spécifier de champs d'affichage supplémentaires, de critères WHERE ou IF (autres que les tests READLIMIT ou RECORDLIMIT) ou de valeurs calculées ; les phrases BY sont ignorées.

La déclaration SQL SELECT se traduit en une ou plusieurs commandes TABLE PRINT ou TABLE, selon que l'affichage de champs individuels ou l'agrégation sont appliqués à la requête. Consultez Affichage de données de rapport.

La déclaration SQL SELECT * se traduit en une impression (PRINT) de chaque champ dans le fichier Master, et utilise tous les champs du produit cartésien. Cela constitue une moyenne rapide d'afficher un fichier, à condition qu'il soit réparti sur un nombre raisonnable d'écrans pour l'affichage, ou à condition que vous utilisiez ON TABLE HOLD ou ON TABLE PCHOLD pour retenir des données récupérées dans un fichier pour la réutilisation. Consultez Enregistrer et réutiliser la sortie de rapport.

Les fonctions SQL (telles que COUNT, SUM, MAX, MIN, AVG) sont prises en charge dans les listes SELECT et les conditions HAVING. Les expressions peuvent servir d'arguments de fonction.

La fonction COUNT (*) se traduit en un décompte du nombre d'enregistrements produits en imprimant tous les champs du fichier Master. Ceci est équivalent à compter toutes les lignes du produit cartésien qui résultent d'une sélection (SELECT) de tous les champs.

Dans la mesure du possible, les expressions du prédicat SQL WHERE sont traduites en des critères WHERE correspondants dans la requête TABLE. Les expressions des listes SELECT génèrent des champs virtuels. Les clauses SQL HAVING se traduisent aussi en des critères WHERE TOTAL correspondants dans la requête TABLE. L'opérateur SQL LIKE se traduit directement en l'opérateur LIKE correspondant dans les critères WHERE de la requête TABLE. Pour plus de détails sur la sélection d'enregistrements dans les requêtes TABLE, consultez Sélection d'enregistrements pour votre rapport.

Seules les sous-interrogations basées sur l'égalité, où l'expression WHERE est comparée à une sous-interrogation par l'utilisation d'un signe égal (=), sont prises en charge. Par exemple, champ WHERE = (SELECT ...).

L'opérateur SQL UNION se traduit en une requête TABLE qui crée un fichier HOLD pour chaque source de données spécifiée, suivie d'une commande MATCH avec l'option HOLD OLD-OR-NEW, qui combine des enregistrements provenant de la première (ancienne) source de données et de la deuxième (nouvelle) source de données. Consultez Fusion de sources de données.

Pour des informations connexes, consultez Déclarations SQL prises en charge et Utiliser les commandes du traducteur SQL.

Lors de l'exécution de jointures SQL, les champs joints doivent être au même format. Les champs joints ne doivent pas être indexés, et les non équijonctions sont prises en charge.

Les jointures récursives, externes et internes sont prises en charge. La jointure interne est la jointure par défaut.

SQL
SELECT fieldlist FROM file1 [alias1], file2 [alias2]
[WHERE where_condition];
END

SQL
SELECT fieldlist FROM file1 [alias1] INNER JOIN file2 [alias2]
ON join_condition [INNER JOIN ...]
[WHERE where_condition];
END

SQL
SELECT fieldlist FROM file1 {LEFT|RIGHT|FULL} JOIN file2 
ON join_condition [{LEFT|RIGHT|FULL} JOIN ...]
WHERE where_condition 
END

SQLJNMnn						

SQL
 SELECT T.A, T.B
 FROM T, U
 WHERE T.A = U.B;
END

SQL
   SELECT A.SEATS, B.SEATS
   FROM CAR A, CAR B
   WHERE A.MODEL = B.MODEL;
END

SQL
SELECT   
       B.FIELD1 AS B_FIELD1, B.FIELD2 AS B_FIELD2, 
       D.FIELD1 AS D_FIELD1, D.FIELD2 AS D_FIELD2   
FROM   
((FILE1 B FULL OUTER JOIN FILE2 C ON B.FIELD2 = C.FIELD2 )   
           FULL OUTER JOIN FILE3 D ON C.FIELD2 = D.FIELD2 )   
WHERE B.FIELD1 < 2   
END 

Le Traducteur SQL prend en charge le tableau des commandes CREATE TABLE et INSERT INTO :

• CREATE TABLE crée un nouveau tableau de source de données. Elle ne génère que des fichiers Master à segment unique.
• INSERT INTO insère une ligne ou un bloc de lignes dans un tableau ou une vue. L'insertion à enregistrement unique avec des valeurs de données réelles est prise en charge.

Ces commandes vous permettent de créer des tableaux afin d'améliorer l'efficacité de reporting.

Remarque : lorsque les applications sont actives, le fichier maître et la source de données sont écrits dans le répertoire APPHOLD. Lorsque les applications sont désactivées, le fichier Master et la source de données sont écrits dans le répertoire TEMP.

-* Single-record insert example.
-*
SQL
CREATE TABLE U (A INT, B CHAR(6), C CHAR(6), X INT, Y INT);
END
SQL
INSERT INTO U (A,B,C,X,Y) VALUES (10, '123456','654321', 10, 15);
END

Une vue est un objet transitoire qui hérite la plupart des caractéristiques d'un tableau. Comme un tableau, elle se compose de lignes et de colonnes :

• CREATE VIEW crée des vues. Notez qu'elle ne met pas la vue dans le catalogue système.
• DROP VIEW supprime explicitement les tableaux et vues transitoires de l'environnement.

Conseil : pour utiliser une vue, lancez une commande SELECT de la vue. Vous ne pouvez par lancer une requête TABLE par rapport à une vue car celle-ci n'est pas extraite comme source de données FOCUS physique. Pour créer un fichier HOLD pour les données extraites, spécifiez ON TABLE HOLD après les déclarations SQL. Pour des détails sur la création de fichiers HOLD, consultez Enregistrer et réutiliser la sortie de rapport.

CREATE VIEW viewname AS subquery ;

SQL
CREATE VIEW XYZ
 AS SELECT CAR, MODEL
 FROM CAR;
END

SQL
 SELECT CAR, MODEL
 FROM XYZ;
END

SQL
 DROP VIEW XYZ;
END

Le traducteur SQL génère automatiquement des jeux de réponses de produit cartésien, à moins que ne vous désactiviez explicitement cette fonctionnalité. Cependant, il est conseillé de laisser le paramètre CARTESIAN activé (ON), car la désactivation n'est pas conforme avec les standards ANSI. Pour des détails sur la commande SET CARTESIAN, consultez Fusion de sources de données.

La notation décimale continentale affiche des numéros en utilisant une virgule pour indiquer la décimale et des périodes pour séparer des chiffres importants en groupes de trois. Cette notation est disponible pour les requêtes du traducteur SQL.

L'exemple suivant crée une colonne définie comme 1.2 + SEATS :

SET CDN=ON
SQL
   SELECT SEATS + 1,2
   FROM CAR;
END

Vous pouvez spécifier des champs dans une requête SQL avec :

• Des identifiants délimités. Un nom de champ peut contenir (mais ne peut pas commencer par) les symboles ., #, @, _, et $. Lorsque vous référencez de tels champs, vous devez les entourer de guillemets doubles.
• Des noms de champ qualifiés. Vous pouvez qualifier un nom de champ avec des noms de fichier et des alias. Les alias de fichier sont décrits à la rubrique traitant des jointures Jointures SQL. Consultez le manuel Description de données en langage WebFOCUS pour plus d'informations.
• Des noms de champ avec des espaces incorporés et des caractères spéciaux. Une liste SELECT peut spécifier des noms de champ avec des espaces incorporés ou d'autres caractères spéciaux. Vous devez mettre de tels champs entre guillemets doubles. Un caractère spécial est tout caractère qui n'est pas listé comme identifiant délimité et ne fait pas partie du jeu de caractères nationaux de l'environnement FOCUS installé.

L'identifiant de champ suivant peut être compris dans une requête :

"COUNTRY.NAME"

Pour qualifier le nom de champ délimité COUNTRY.NAME de son nom de fichier, utilisez :

CAR."COUNTRY.NAME"

Les opérateurs SQL UNION, INTERSECT et EXCEPT s'appuient sur la logique MATCH. Le nombre de champs pris en charge est déterminé par la limite de MATCH. UNION avec parenthèses est pris en charge.

• SELECT A UNION SELECT B récupère des lignes de A ou B, ou des deux. (C'est équivalent à la phrase MATCH OLD-OR-NEW).
• INTERSECT récupère des lignes de A ou B. (C'est équivalent à la phrase MATCH OLD-AND-NEW.)
• EXCEPT récupère des lignes de A, non pas de B. (C'est équivalent à la phrase OLD-NOT-NEW).

La logique MATCH fusionne le contenu de vos sources de données. Consultez Fusion de sources de données.

La liste SQL SELECT, le prédicat WHERE et la clause HAVING peut inclure des constantes numériques, des littéraux entourés de guillemets simples, des expressions et toute fonction scalaire. Un champ virtuel est créé de façon interne pour chacun de ces éléments dans la liste SELECT. La valeur du champ virtuel est fournie dans le jeu de réponses.