La sentencia LOAD carga campos desde un archivo, desde datos definidos en el script, desde una tabla previamente cargada, desde una página web, desde el resultado de una sentencia SELECT posterior, o bien generando los datos automáticamente.
Sintaxis:
LOAD [ distinct ] fieldlist
[( from file [ format-spec ] |
from_field fieldassource [format-spec]
inline data [ format-spec ] |
resident table-label |
autogenerate size )]
[ where criterion | while criterion ]
[ group_by groupbyfieldlist ]
[order_by orderbyfieldlist ]
Argumentos:
| Argumento | Descripción |
|---|---|
| distinct |
Puede usar distinct como predicado, si solo desea cargar registros únicos. Si hay registros duplicados, se cargará la primera instancia. Si está utilizando load precedentes, debe colocar distinct en la primera sentencia load, ya que distinct solo afecta a la tabla de destino. |
| fieldlist |
fieldlist ::= ( * | field {, field } )
Una lista de los campos que se van a cargar. El asterisco * como una lista de campos indica la totalidad de campos de la tabla. field ::= ( fieldref | expression ) [as aliasname ]La definición de campo debe contener siempre una referencia literal a un campo existente o a una expresión. fieldref ::= ( fieldname |@fieldnumber |@startpos:endpos [ I | U | R | B | T] )fieldname es un texto idéntico a un nombre de campo de la tabla. Tenga en cuenta que el nombre de campo debe ir entre comillas dobles rectas o corchetes si contiene, por ejemplo, espacios. A veces los nombres de campo no están disponibles de forma explícita. Entonces se usa una nomenclatura diferente: @fieldnumber representa el número de campo en un archivo de tabla delimitado. Debe ser un número entero positivo precedido de "@". La numeración se hace siempre desde 1 hasta el número total de campos. @startpos:endpos representa las posiciones inicial y final de un campo en un archivo con registros de longitud fija. Las posiciones deben ser ambas números enteros positivos. Los dos números deben ir precedidos de "@" y separados por dos puntos. La numeración se hace siempre desde 1 hasta el número total de posiciones. En el último campo se utiliza n como posición final.
expression puede ser una función numérica o una función de cadena basada en uno o varios campos de la misma tabla. Para más información, vea la sintaxis de las expresiones. |
| from |
from se usa si se desea que los datos se carguen desde un campo. file ::= [ path ] filename
Si se omite la ruta, QlikView buscará el archivo en el directorio especificado por la sentencia Directory. Si no hay sentencia Directory, QlikView buscará en el directorio de trabajo, que normalmente es el directorio donde se ubica el archivo QlikView. Nota informativaEn una instalación de un servidor QlikView, el directorio de trabajo por defecto es C:\ProgramData\QlikTech\Documents. El directorio de trabajo por defecto puede modificarse en Consola de gestión de QlikView.
El nombre de archivo filename puede contener los caracteres comodín estándar de DOS (* y ?). Esto provocará la carga de todos los archivos en el directorio especificado. format-spec ::= ( fspec-item { , fspec-item } )La especificación de formato consiste en una lista de varios elementos de caracterización, entre paréntesis. |
| from_field | from_field se usa si los datos se deben cargar desde un campo previamente cargado. fieldassource::=(tablename, fieldname) El campo es el nombre de los tablename y fieldname previamente cargados. format-spec ::= ( fspec-item {, fspec-item } )La especificación de formato consiste en una lista de varios elementos de caracterización, entre paréntesis. |
| inline | inline se utiliza si los datos deben introducirse en el script y no cargarse desde un fichero. data ::= [ text ] Los datos insertados mediante una cláusula inline deben estar entre comillas dobles o entre corchetes. El texto en su interior se interpreta de la misma manera que el contenido de un archivo. Por lo tanto, cuando inserte una nueva línea en un archivo de texto, también deberá hacerlo en el texto de una cláusula inline, es decir, pulsando la tecla Intro al escribir la secuencia de script. El número de columnas viene definido por la primera línea. format-spec ::= ( fspec-item {, fspec-item } )La especificación de formato consiste en una lista de varios elementos de caracterización, entre paréntesis. |
| resident | resident se utiliza si los datos debieran cargarse desde una tabla previamente cargada. table label es una etiqueta que precede a la(s) sentencia(s) LOAD o SELECT, que crearon la tabla original. La etiqueta debe ir seguida de dos puntos al final de la línea. Cuando se usa una combinación de sentencias de carga distinct y resident en QlikView 12.00 o posterior, el orden de carga de los datos es diferente de la versión QlikView 11.20. Para definir un orden de carga deseado, agregue una cláusula order by. |
| autogenerate | autogenerate se utiliza si los datos deben ser generados automáticamente por QlikView. size ::= number Number es un entero que indica el número de registros que se han de generar. La lista de campos no debe contener expresiones que requieran datos de una base de datos. En las expresiones solo se permiten constantes y funciones sin parámetros (por ej. rand() o recno()). |
| extension |
Puede cargar datos desde conexiones analíticas. Debe usar la cláusula extension para llamar a una función definida en el complemento de extensión del lado del servidor (SSE), o evaluar un script. Puede enviar una sola tabla al complemento SSE y devuelve una sola tabla de datos. Si el complemento no especifica los nombres de los campos que devuelve, los campos se denominarán Field1, Field2, etc. Extension pluginname.functionname( tabledescription );
Manejo del tipo de datos en la definición de campos de tabla Los tipos de datos se detectan automáticamente en las conexiones analíticas. Si los datos no tienen valores numéricos y al menos una cadena de texto no NULA, el campo se considera texto. En cualquier otro caso se considera numérico. Puede obligar a tener un tipo de datos determinado incluyendo un nombre de campo entre los paréntesis de String() o Mixed().
String() o Mixed() no se pueden usar fuera de las definiciones de campo de la tabla extension, y no puede usar otras funciones QlikView en una definición de campos de tabla. Más información sobre las conexiones analíticas Para crear una conexión analítica en QlikView Server o QlikView Desktop, vea: Conexiones analíticas Puede leer más sobre las conexiones analíticas en el repositorio de GitHub. qlik-oss/server-side-extension |
| where | where es una cláusula que sirve para establecer si un registro debe ir incluido en la selección o no. Se incluye la selección si criterion es True. criterion es una expresión lógica. |
| while |
while es una cláusula que se utiliza para indicar si un registro deberá leerse repetidamente. Se lee el mismo registro siempre que el criterion sea True. Con el fin de resultar útil, una cláusula while ha de incluir la función IterNo( ). criterion es una expresión lógica. |
| group_by |
group by es una cláusula que sirve para definir sobre qué campos deberán agregarse (agruparse) los datos. Los campos de agregación deberán incluirse de alguna manera en las expresiones cargadas. Ningún otro campo más que los de agrupación deberá emplearse fuera de las funciones de agregación en las expresiones cargadas. groupbyfieldlist ::= (fieldname { ,fieldname } ) |
| order_by | order by es una cláusula que sirve para clasificar los registros de una tabla residente antes de que la sentencia load los procese. La tabla residente puede ordenarse por más de un campo en orden ascendente o descendente. La ordenación se hace principalmente por valores numéricos y secundariamente por valor de cotejo nacional. Esta cláusula sólo puede utilizarse cuando la fuente de datos es una tabla residente. Los campos de ordenación especifican por qué campos está ordenada la tabla residente. El campo puede especificarse por su nombre o por su número en la tabla residente (el primer número de campo es el 1). orderbyfieldlist ::= fieldname [ sortorder ] { , fieldname [ sortorder ] } sortorder sirve tanto para ordenación ascendente, asc, como descendente, desc. Si no se especifica sortorder alguno, se asume asc (ascendente). fieldname, path, filename y aliasname son cadenas que representan lo que sus respectivos nombres indican. Cualquier campo de la tabla de origen puede utilizarse como fieldname. No obstante, los campos creados mediante la cláusula as (aliasname) están fuera de ámbito y no pueden utilizarse dentro de la misma sentencia load. |
Si no se especifica ninguna fuente de datos mediante una cláusula from, inline, resident, from_field o autogenerate, los datos se cargarán a partir del resultado de la sentencia SELECT o LOAD inmediatamente posterior. Dicha sentencia posterior no debería llevar ningún prefijo.
Ejemplos:
En este ejemplo hay un archivo de entrada Grades.csv que contiene las notas de cada estudiante condensadas en un campo:
Student,Grades
Mike,5234
John,3345
Pete,1234
Paul,3352
Las notas, en una escala del 1 al 5 representan las asignaturas Math, English, Science y History (matemáticas, inglés, ciencias e historia). Es posible separar las notas en distintos valores leyendo cada registro varias veces con una cláusula while, usando la función IterNo( ) como un contador. En cada lectura, la nota se extrae mediante la función Mid y se almacena en Grade, y la asignatura se selecciona usando la función pick y se almacena en Subject. La cláusula final while contiene la prueba de comprobación para ver si todas las notas se han leído (cuatro por estudiante en este caso), lo que significa que se debería leer el registro del siguiente estudiante.
MyTab:
LOAD Student,
mid(Grades,IterNo( ),1) as Grade,
pick(IterNo( ), 'Math', 'English', 'Science', 'History') as Subject from Grades.csv
while IsNum(mid(Grades,IterNo(),1));
El resultado es una tabla que contiene los siguientes datos:
