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

donde:

SQL

Es el identificador de comandos SQL que invoca al SQL Translator.

Nota: Los componentes de comando SQL deben aparecer en el orden que se muestra más arriba.

sql statement

Es una declaración SQL admitida. La declaración debe terminar por un punto y coma (;). Puede ocupar más de una línea. Vaya a Declaraciones de SQL admitidas.

Dentro de la declaración SQL, los nombres de campos tienen un límite de 48 caracteres (limitación ANSI estándar de nivel 2). Los nombre de vistas generados por medio de la declaración SQL CREATE VIEW tienen un límite de 18 caracteres y las subconsultas pueden anidarse en hasta 15 niveles de profundidad. Tenga en cuenta que no se admiten subconsultas correlacionadas en FOCUS ni en otros orígenes de datos no relacionales.

ECHO

Son frases de depuración opcionales que capturan la solicitud TABLE generada. Estas opciones se colocan después de la declaración SQL.

FILE[NAME]

Escribe las frases TABLE traducidas en el procedimiento identificado. Si no proporciona un nombre de archivo, se asigna un nombre predeterminado cuando se ejecuta la solicitud. A continuación, se borra el archivo.

Frases TABLE

Son frases opcionales de formato de TABLE. Consulte Frases de formato de TABLE en solicitudes SQL.

END o QUIT

Se requieren para finalizar el procedimiento.

La siguiente solicitud contiene una declaración SQL y comandos de formateo 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

Puede incluir frases de formato de TABLE en una solicitud SQL, sujeto a las siguientes reglas:

• Sólo utilice frases de formato de TABLE acompañadas de SELECT y UNION.
• Introduzca las frases de formato con la palabra TABLE.
• Puede especificar encabezados y pies, describir acciones con la frase ON, o bien utilizar el comando ON TABLE SET. Además, puede utilizar ON TABLE HOLD y ON TABLE PCHOLD para crear un archivo de extracción. También puede especificar pruebas de READLIMIT y RECORDLIMIT.

  Para más detalles sobre encabezados y pies, consulte Cómo usar encabezados, pies, títulos y etiquetas.

  Para más detalles sobre ON TABLE HOLD y ON TABLE PCHOLD, consulte Cómo guardar y reutilizar su salida de informes.

• No puede especificar campos de visualización, campos ACROSS, criterios WHERE o IF (que no se traten de pruebas READLIMIT o RECORDLIMIT) o valores calculados adicionales. Se ignoran las frases BY.

La declaración SQL SELECT se traduce en uno o varios comandos TABLE PRINT o TABLE SUM, en función de si es aplicable la visualización de campos individuales o agregación, en la solicitud. Vaya a Cómo mostrar datos de informes.

La declaración SELECT * de SQL se traduce a un PRINT de cada campo en el archivo máster y utiliza todos los campos del producto cartesiano. Esta es una forma rápida de mostrar un archivo, siempre y cuando quepa en un número razonable de pantallas para mostrarlo o que utilice ON TABLE HOLD o ON TABLE PCHOLD para mantener datos recuperados en un archivo para reutilizarlos. Consulte Cómo guardar y reutilizar su salida de informes.

Se admiten funciones SQL (como COUNT, SUM, MAX, MIN, AVG) en listas SELECT y en condiciones HAVING. Las expresiones se pueden utilizar como argumentos de función.

La función COUNT (*) traduce a una suma del número de registros generados al imprimir todos los campos del archivo máster. Es lo mismo que contar todas las filas en el producto cartesiano que produce una SELECT en todos los campos.

Siempre que sea posible, las expresiones en el predicado WHERE de SQL se traducen a los criterios WHERE correspondientes en la solicitud TABLE. Las expresiones en las listas SELECT generan campos virtuales. Las cláusulas SQL HAVING también se traducen en los criterios WHERE TOTAL correspondientes en la solicitud TABLE. El operador SQL LIKE se traduce directamente al operador LIKE correspondiente, en los criterios WHERE de la solicitud TABLE. Para más detalles sobre la selección de registros en las solicitudes TABLE, consulte Cómo seleccionar registros para su informe.

Sólo se admiten las subconsultas basadas en una igualdad, donde la expresión WHERE se compara con una subconsulta mediante un signo de igual (=). Por ejemplo: Campo WHERE = (SELECT ...).

El operador SQL UNION se traduce en una solicitud TABLE que crea un archivo HOLD para cada origen de datos especificado, seguido de un comando MATCH con la opción HOLD OLD-OR-NEW, que combina registros del primer (antiguo) origen de datos y del segundo (nuevo) origen de datos. Consulte Cómo fusionar orígenes de datos.

Para más información, consulte Declaraciones de SQL admitidas y Cómo Utilizar comandos SQL Translator.

Al realizar joins SQL, los campos unidos deben tener el mismo formato. Los campos join no necesitan estar indexados y no se admiten los que no sean equijoins.

Se admiten joins recursivas, externas e internas. Las joins internas son las predeterminadas.

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 

SQL Translator admite los comandos CREATE TABLE e INSERT INTO table:

• CREATE TABLE crea una nueva tabla de origen de datos. Solamente genera archivos máster de un solo segmento.
• INSERT INTO inserta una fila o bloque de filas en una tabla o una vista. Se admite la inserción de registros sólo con valores de datos reales.

Estos comandos le permiten crear tablas para mejorar la eficiencia de los informes.

Nota: Cuando las aplicaciones están habilitadas, el archivo máster y el origen de datos se graban en el directorio APPHOLD. Cuando se deshabilitan las aplicaciones, el archivo máster y el origen de datos se escriben en el directorio 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

Una vista es un objeto pasajero que hereda la mayoría de las características de una tabla. Al igual que las tablas, está compuesto de filas y columnas:

• CREATE VIEW crea vistas. Fíjese que no coloca la vista en el catálogo del sistema.
• DROP VIEW elimina de manera explícita las tablas pasajeras y las vistas del entorno.

Sugerencia: Para utilizar una vista, emita desde ésta un SELECT. No puede emitir una solicitud TABLE contra la vista porque ésta no se extrae como un origen de datos físico de FOCUS. Para crear un archivo HOLD para datos extraídos, especifique ON TABLE HOLD después de las oraciones SQL. Para obtener información detallada acerca de cómo crear archivos HOLD, vaya a Cómo guardar y reutilizar su salida de informes.

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

A menos que desactive explícitamente esta característica, SQL Translator genera de manera automática conjuntos de repuestas de estilo de producto cartesiano. Se aconseja dejar la configuración CARTESIAN activada, pues apagarla viola los estándares ANSI. Para obtener información detallada acerca del comando SET CARTESIAN, vaya a Cómo fusionar orígenes de datos.

La notación decimal continental muestra números utilizando una coma para señalar la posición decimal y puntos para separar los dígitos significativos en grupos de tres. Esta notación está disponible para solicitudes SQL Translator.

El ejemplo que sigue crea una columna definida como 1.2 + SEATS:

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

Especifique campos en una solicitud SQL con:

• Identificadores delimitados. Un nombre de campo puede contener (mas no empezar con) los símbolos., #, @, _ y $. Debe poner dichos nombres de campo entre comillas dobles al referirse a ellos.
• Nombres de campos cualificados. Califique un nombre de campo con nombres de archivo y de alias. Los alias de los archivos están descritos en la sección sobre uniones en Joins SQL. Consulte el manual Cómo describir datos con el lenguaje WebFOCUS. para más información.
• Nombres de campo con espacios en blanco insertados y caracteres especiales. Una lista SELECT puede especificar nombres de campo con espacios en blanco insertados u otros caracteres especiales. Debe enmarcar estos nombres de campo con comillas dobles. Caracteres especiales con cualquier carácter que no ha sido enumerado como identificador delimitado y no forma parte del conjunto de datos del país o la lengua que corresponde al entorno de FOCUS instalado.

Se puede incluir el siguiente identificador de campo en una solicitud:

"COUNTRY.NAME"

Para calificar el nombre de campo delimitado COUNTRY.NAME con su nombre de campo, utilice:

CAR."COUNTRY.NAME"

Los operadores UNION, INTERSECT y EXCEPT de SQL generan lógica MATCH. El número de archivos que puede participar está determinado por el límite MATCH. Se admite UNION entre paréntesis.

• SELECT A UNION SELECT B recupera filas en A, en B o en ambos. (Este es el equivalente de la frase OLD-OR-NEW del tipo MATCH).
• INTERSECT recupera filas en A y B. (Este es el equivalente de la frase OLD-AND-NEW del tipo MATCH).
• EXCEPT recupera filas en A pero no en B. (Este es el equivalente de la frase OLD-NOT-NEW del tipo MATCH).

La lógica Match fusiona los contenidos de sus orígenes de datos. Consulte Cómo fusionar orígenes de datos.

La lista SELECT, el predicado WHERE y la cláusula HAVING de SQL pueden incluir constantes numéricas, literales colocados entre comillas simples, expresiones y Cualquier funciones escalares. En el ámbito interno, se crea un campo virtual para cada una de éstas, en la lista SELECT. El valor del campo virtual viene incluido en el conjunto de respuestas.