Saltar al contenido principal

Load

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 generando los datos automáticamente. También se pueden cargar datos desde conexiones analíticas.

Sintaxis:  

LOAD [ distinct ] fieldlist

[( from file [ format-spec ] |

from_field fieldassource [format-spec]|

inline data [ format-spec ] |

resident table-label |

autogenerate size ) |extension pluginname.functionname([script] tabledescription)]

[ where criterion | while criterion ]

[ group by groupbyfieldlist ]

[order by orderbyfieldlist ]

Argumentos
ArgumentoDescripción
distinct

Puede usar distinct como un predicado si solo desea cargar registros únicos. Si hay registros duplicados, se cargará la primera instancia.

Si está usando loads precedentes necesita colocar distinct en la primera sentencia load, puesto que distinct solo afecta a la tabla de destino.

Load precedente

fieldlistfieldlist ::= ( * | field{, * | field } )

Una lista de los campos que se van a cargar. Usar * como una lista de campos indica todos los 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 que es 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 delimitada. Debe ser un entero positivo precedido por "@". La numeración se hace siempre desde 1 hasta el número de campos.

@startpos:endpos representa las posiciones de inicio 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 estar precedidos por "@" y separados por dos puntos. La numeración se hace siempre desde 1 hasta el número de posiciones. En el último campo, n se usa como posición final.

  • Si @startpos:endpos va seguido inmediatamente por los caracteres I o U, los bytes leídos se interpretarán como un binario firmado (I) o un entero no firmado (U) (orden de bytes de Intel). El número de posiciones leídas debe ser 1, 2 o 4.
  • Si @startpos:endpos va inmediatamente seguido por el carácter R, los bytes leídos se interpretarán como un número real binario (IEEE de 32 bits o coma flotante de 64 bits). El número de las posiciones leídas debe ser 4 u 8.
  • Si @startpos:endpos va inmediatamente seguido por el carácter B, los bytes leídos se interpretarán como números BCD (Binary Coded Decimal) según el estándar COMP-3. Se puede especificar cualquier número de bytes.

expression puede ser una función numérica o una función de cadena basada en uno o varios campos más de la misma tabla. Para más información, vea la sintaxis de las expresiones.

as se usa para asignar un nuevo nombre al campo.

from

from se usa si los datos deben cargarse desde un archivo usando una carpeta o una conexión de datos de archivos web.

file ::= [ path ] filename

Ejemplo: 'lib://Table Files/'

Si la ruta se omite, Qlik Sense busca el archivo en el directorio especificado por la sentencia Directory. Si no hay sentencia Directory, Qlik Sense busca en el directorio de trabajo, C:\Users\{user}\Documents\Qlik\Sense\Apps.

Directory

Nota informativaEn una instalación de servidor de Qlik Sense, el directorio de trabajo se especifica en Qlik Sense Repository Service, por defecto es C:\ProgramData\Qlik\Sense\Apps. Consulte la ayuda de Consola de gestión de Qlik para obtener más información.

El filename puede contener los DOS caracteres comodín estándar ( * 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.

Elementos de especificación de formato

Nota de sugerenciaPuede usar la especificación de formato URL is para anular la URL de una conexión de datos de archivos web, por ejemplo, si necesita crear una URL dinámica basada en otros datos que se cargaron.

En el modo de elaboración de scripts de legado, se admiten también los diguientes formatos de ruta:

  • Absoluta

    Ejemplo: c:\data\

  • relativa al directorio de trabajo de la app Qlik Sense.

    Ejemplo: data\

  • Dirección URL (HTTP o FTP), que apunta a una ubicación en Internet o una intranet.

    Ejemplo: http://www.qlik.com

from_fieldfrom_field se usa si los datos se deben cargar desde un campo previamente cargado.

fieldassource::=(tablename, fieldname)

El campo es el nombre del tablename y fieldname previamente cargados.

format-spec ::= ( fspec-item {, fspec-item } )

La especificación de formato consiste en una lista con varios elementos de especificación entre paréntesis. Para más información, vea Elementos de especificación de formato.

Nota informativafrom_field solo admite comas como delimitador de listas al separar campos en las tablas.
inlineinline se usa si los datos se deben escribir dentro del script y no se cargan desde un archivo.

data ::= [ text ]

Los datos insertados mediante una cláusula inline deben ir incluidos entre caracteres específicos: corchetes, comillas o tildes invertidas. 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 debe hacerlo en el texto de una cláusula inline pulsando la tecla Intro al escribir la secuencia de script.

En una carga inline sencilla, el número de columnas viene definido por la primera línea.

format-spec ::= ( fspec-item {, fspec-item } )

Puede personalizar la carga inline con muchos de los mismos elementos de especificación de formato que están disponibles para otras tablas cargadas. Estos elementos se muestran entre paréntesis. Para más información, vea Elementos de especificación de formato.

Para más información sobre el uso de cargas inline, vea Usar cargas inline para cargar datos.

residentresident se usa si los datos se deben cargar desde una tabla previamente cargada.

table label es una etiqueta que precede a la sentencia o sentencias LOAD o SELECT que crearon la tabla original. La etiqueta debe ir seguida de dos puntos al final de la línea.

Cargar datos de una tabla previamente cargada

Etiquetas de tabla

autogenerateautogenerate se utiliza si los datos deben ser generados automáticamente por Qlik Sense.

size ::= number

Number es un número entero que indica la cantidad de registros que se generarán.

La lista de campos no debe contener expresiones que requieran datos de una fuente de datos externa o una tabla previamente cargada, a menos que nos refiramos a un único valor de campo de una tabla previamente cargada con la función Peek.

extension

Puede cargar datos desde conexiones analíticas. Necesita usar la cláusula extension para llamar a una función definida en el complemento plugin (SSE) de extensión del lado del servidor o evaluar un script.

Puede enviar una única tabla al complemento SSE y devuelve una sola tabla de datos. Si el complemento plugin no especifica los nombres de los campos que se devuelven, los campos se denominarán Field1, Field2 y así sucesivamente.

Extension pluginname.functionname( tabledescription );

  • Cargar datos utilizando una función en un complemento plugin SSE

    tabledescription ::= (table { ,tablefield} )

    Si no indica campos de tabla, los campos se usarán en orden de carga.

  • Cargar los datos evaluando un script en un complemento plugin SSE

    tabledescription ::= ( script, table { ,tablefield} )

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 forzar el tipo de datos encerrando un nombre de campo en Cadena() o Mixto().

  • Cadena() obliga al campo a ser de texto. Si el campo es numérico, se extrae la parte de texto del valor dual, no se realiza ninguna conversión.
  • Mixto() obliga al campo a ser dual.

Cadena() o Mixto() no se pueden usar fuera de las definiciones de campo de la tabla de extensión y no puede usar otras funciones Qlik Sense en una definición de campo de tabla.

Debe configurar las conexiones analíticas antes de poder usarlas.

Qlik Sense Enterprise: Crear una conexión analítica (solo en inglés)

Qlik Sense Desktop: Configurar conexiones analíticas en Qlik Sense Desktop

Puede leer más sobre las conexiones analíticas en el repositorio de GitHub. qlik-oss/server-side-extension

wherewhere es una cláusula utilizada para indicar si un registro debe incluirse en la selección o no. La selección se incluye si criterion es True.

criterion es una expresión lógica

while

while es una cláusula utilizada para indicar si un registro debe leerse repetidamente. Se lee el mismo registro siempre y cuando el criterion sea True. Para ser útil, una cláusula while debe incluir por lo general 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 deben agregarse (agruparse) los datos. Los campos de agrupació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 byorder by es una cláusula utilizada 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 solo puede utilizarse cuando al 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 es o bien asc ascendente o desc descendente. Si no se especifica sortorder, se asume asc.

fieldname, path, filename y aliasname son cadenas de texto que representan lo que sus respectivos nombres implican. Cualquier campo de la tabla fuente se puede usar como fieldname. Sin embargo, los campos creados a través de la cláusula (aliasname) están fuera del alcance y no se pueden usar dentro de la misma sentencia load.

Si no se proporciona ninguna fuente de datos por medio de una cláusula from, inline, resident, from_fieldextensión o una cláusula 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.

Cargar datos de una tabla previamente cargada

Ejemplos:  

Nota informativaLa extensión de archivo de las conexiones de DataFiles distingue entre mayúsculas y minúsculas. Por ejemplo: .qvd.

¿Esta página le ha sido útil?

No dude en indicarnos en qué podemos mejorar si encuentra algún problema en esta página o su contenido, como, por ejemplo, errores tipográficos, pasos que falta o errores técnicos.