# 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 ] [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)[ group by groupbyfieldlist ] [order by orderbyfieldlist ] Argumentos | Argumento | Descripción | | --- | --- | | distinct [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm) | 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](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/load-data-from-previously-loaded-table.htm#Precedin) | | [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)fieldlist | fieldlist ::= ( \* \| 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.



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.

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)as se usa para asignar un nuevo nombre al campo. | | [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)from | from se usa si los datos se deben cargar desde un archivo usando una carpeta. Al cargar desde un archivo en un espacio en Analítica de Qlik Cloud, debe utilizarse una ruta válida. Vea [Reglas para unas rutas válidas de las carpetas en los espacios](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/manage-data-files-spaces.htm#PathRules).

file ::= [ path ] filename

En Analítica de Qlik Cloud, se admiten estructuras jerárquicas de carpetas y se puede hacer referencia a ellas en la sntencia.

Ejemplos:



Más información y ejemplos en [Cargar archivos desde espacios en Analítica de Qlik Cloud](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm#SpaceStore). | | [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)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 del 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. Para más información, vea [Elementos de especificación de formato](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptSpecifiers/format-specification-items.htm).

Nota informativafrom\_field solo admite comas como delimitador de listas al separar campos en las tablas. | | [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)inline | inline 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](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptSpecifiers/format-specification-items.htm).

Para más información sobre las cargas inline, vea:[Usar cargas inline para cargar datos](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/inline-loads-qs.htm) | | [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)resident | resident 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](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/load-data-from-previously-loaded-table.htm)

[Etiquetas de tabla](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/table-labels.htm) | | [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)autogenerate | autogenerate 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 deberá 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. | | [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)where | where 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 | | [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)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 | | [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)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 } ) | | [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)order by | order 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](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/load-data-from-previously-loaded-table.htm) Nota informativaLa extensión de archivo de las conexiones de DataFiles distingue entre mayúsculas y minúsculas. Por ejemplo: .qvd. Ejemplos: [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm) #### Seleccionar ciertos campos, renombrar y calcular campos Cargue solo tres campos específicos desde un archivo delimitado: `LOAD FirstName, LastName, Number from [lib://DataFiles/data1.csv]; `` ` Renombrar el primer campo como A y el segundo campo como B cuando se carga un archivo sin etiquetas: `LOAD @1 as A, @2 as B from [lib://DataFiles/data3.txt] (ansi, txt, delimiter is '\t', no labels); `` ` Cargar Name como una concatenación de FirstName, un carácter de espacio y LastName: `LOAD FirstName&' '&LastName as Name from [lib://DataFiles/data1.csv];`` ` Cargar Quantity, Price y Value (el producto de Quantity y Price): `LOAD Quantity, Price, Quantity*Price as Value from [lib://DataFiles/data1.csv];` [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm) #### Seleccionar ciertos registros Cargue solo registros únicos, los registros duplicados serán descartados: `LOAD distinct FirstName, LastName, Number from [lib://DataFiles/data1.csv]; `` ` Cargar solo registros donde el campo Litres tenga un valor superior a cero: `LOAD * from [lib://DataFiles/Consumption.csv] where Litres>0; ` [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm) #### Cargue datos que no residan en un archivo y datos autogenerados. Cargar una tabla con datos inline, dos campos denominados CatID y Category: `LOAD * Inline ` `[CatID, Category ` `0,Regular ` `1,Occasional ` `2,Permanent]; ` ` ` Cargar una tabla con datos inline, tres campos denominados UserID, Password y Access: `LOAD * Inline [UserID, Password, Access ` `A, ABC456, User ` `B, VIP789, Admin]; ` ` ` Cargue una tabla con 10.000 filas. El campo A contendrá el número del registro leído (1,2,3,4,5 ...) y el campo B contendrá un número aleatorio entre 0 y 1: `LOAD RecNo( ) as A, rand( ) as B autogenerate(10000);` Nota informativaEl paréntesis tras autogenerate se permite pero no es obligatorio. [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm) #### Cargar datos de una tabla previamente cargada Primero cargamos un archivo de tabla delimitado y lo denominamos tab1: `tab1: ` `SELECT A,B,C,D from [lib://DataFiles/data1.csv]; `` ` Cargar campos de la tabla ya cargada tab1 como tab2: `tab2:` `LOAD A,B,month(C),A*B+D as E resident tab1;` ` ` Cargar campos de la tabla ya cargada tab1 pero solo los registros donde A sea mayor que B: `tab3:` `LOAD A,A+B+C resident tab1 where A>B;` ` ` Cargar campos de la tabla ya cargada tab1 ordenados por A: `LOAD A,B*C as E resident tab1 order by A;` ` ` Cargar campos de la tabla ya cargada tab1, ordenados por el primer campo, luego el segundo campo: `LOAD A,B*C as E resident tab1 order by 1,2;` ` ` Cargar campos de la tabla ya cargada tab1 ordenados por C descendente, luego B en orden ascendente y luego el primer campo por orden descendente: `LOAD A,B*C as E resident tab1 order by C desc, B asc, 1 desc;` [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm) #### Cargar datos de archivos previamente cargados Cargue el campo Types de la tabla previamente cargada Characters como A: `LOAD A from_field (Characters, Types);` [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm) #### Cargar datos de una tabla subsiguiente (preceding load) Cargar A, B y los campos calculados X y Y desde Table1 que se carga en la sentencia SELECT subsiguiente: `LOAD A, B, if(C>0,'positive','negative') as X, weekday(D) as Y; ` `SELECT A,B,C,D from Table1;` ` ` [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm) #### Agrupar datos Cargar campos agrupados (agregados) por ArtNo: `LOAD ArtNo, round(Sum(TransAmount),0.05) as ArtNoTotal from table.csv group by ArtNo; ` ` ` Cargar campos agrupados (agregados) por Week y ArtNo: `LOAD Week, ArtNo, round(Avg(TransAmount),0.05) as WeekArtNoAverages from table.csv group by Week, ArtNo;` ` ` [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm) #### Leer un registro de forma repetida En este ejemplo tenemos un archivo de entrada Grades.csv que contiene las calificaciones de cada alumno condensadas en un campo: `Student,Grades` `Mike,5234` `John,3345` `Pete,1234` `Paul,3352` Las calificaciones, en una escala del 1 al 5, representan las asignaturas Math, English, Science y History. Podemos separar las en valores aparte leyendo cada registro varias veces con una cláusula while, usando la función IterNo( ) como contador. En cada lectura, la calificación se extrae con 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 para verificar si se han leído todas las calificaciones (cuatro por alumno en este caso), lo que significa que se debe leer el siguiente registro del alumno. `MyTab: ` `LOAD Student, ` `mid(Grades,IterNo( ),1) as Grade, ` `pick(IterNo( ), 'Math', 'English', 'Science', 'History') as Subject from [lib://DataFiles/Grades.csv]` `while IsNum(mid(Grades,IterNo(),1));`` ` El resultado es una tabla que contiene los siguientes datos: ![Resulting data table](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Resources/Images/ex_gen_LoadRepeated.png) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm) #### Cargar desde conexiones analíticas Se utilizan los siguientes datos de muestra. ``` Values: Load Rand() as A, Rand() as B, Rand() as C AutoGenerate(50); ``` Cargar datos utilizando una función En estos ejemplos, suponemos que tenemos un complemento, un plugin de conexión analítica llamado P que contiene una función personalizada Calculate(Parameter1, Parameter2). La función devuelve la tabla Resultados que contiene los campos Field1 y Field2. ``` Load * Extension P.Calculate( Values{A, C} ); ``` Cargar todos los campos que se devuelven al enviar los campos A y C a la función. ``` Load Field1 Extension P.Calculate( Values{A, C} ); ``` Cargar solo el campo Field1 al enviar los campos A y C a la función. ``` Load * Extension P.Calculate( Values ); ``` Cargar todos los campos que se devuelven al enviar los campos A y B a la función. Como los campos no se especifican, A y B se utilizan ya que son los primeros en orden en la tabla. ``` Load * Extension P.Calculate( Values {C, C}); ``` Cargar todos los campos que se devuelven al enviar el campo C a ambos parámetros de la función. Load \* Extension P.Calculate( Values {String(A), Mixed(B)}); Cargar todos los campos que se devuelven al enviar el campo A forzado como una cadena y B forzado como un valor numérico a la función. Cargar los datos evaluando un script Load A as A\_echo, B as B\_echo Extension R.ScriptEval( 'q;', Values{A, B} ); Cargar la tabla devuelta por el script q al enviar los valores de A y B. Load \* Extension R.ScriptEval( '$(My\_R\_Script)', Values{A, B} ); Cargar la tabla devuelta por el script almacenado en la variable My\_R\_Script al enviar los valores de A y B. Load \* Extension R.ScriptEval( '$(My\_R\_Script)', Values{B as D, \*} ); Cargar la tabla devuelta por el script almacenado en la variable My\_R\_Script al enviar los valores de B renombrados como D, A y C. Usar \* envía los campos restantes sin referencia. ## Cargar archivos desde espacios en Analítica de Qlik Cloud En Analítica de Qlik Cloud, al cargar datos desde un archivo de datos dentro de un script de carga, puede utilizar una sentencia LOAD o insertar código QVS. En ambos casos, se puede hacer referencia a estructuras de carpetas de espacios jerárquicos en su sentencia de script. Siga las reglas especificadas para unas [Rutas válidas de carpetas de espacio](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/manage-data-files-spaces.htm#PathRules). Además, el archivo y todas las carpetas a las que se hace referencia deben existir ya en la ubicación especificada. De lo contrario, la recarga fallará. Ejemplos: Referencia al archivo en la ruta de nivel superior de un espacio Este ejemplo carga el archivo orders.csv desde un espacio personal. El archivo no se encuentra dentro de ninguna carpeta específica, sino que se encuentra en la ruta de nivel superior del espacio. ``` LOAD * FROM [lib://DataFiles/orders.csv]; ``` En este ejemplo se carga el archivo orders.csv desde un espacio compartido, administradoo de datos . El nombre del espacio es TeamSharedSpace. El archivo no se encuentra dentro de ninguna carpeta específica, sino que se encuentra en la ruta de nivel superior del espacio. ``` LOAD * FROM [lib://TeamSharedSpace:DataFiles/orders.csv]; ``` Ejemplos: Referencias a una ruta específica de carpeta dentro de un espacio En este ejemplo se carga el archivo orders\_Europe.csv desde la carpeta Orders By Region dentro de un espacio personal. ``` LOAD * FROM [lib://DataFiles/Orders By Region/orders_Europe.csv]; ``` En este ejemplo se carga el archivo orders\_Europe.csv desde la carpeta Orders By Region dentro de un espacio compartido, administrado o de datos. El nombre del espacio es SalesSpace. ``` LOAD * FROM [lib://SalesSpace:DataFiles/Orders By Region/orders_Europe.csv]; ``` Para más información sobre cómo hacer referencia a la estructura de carpetas de espacio en los scripts de carga, vea [Hacer referencia a la estructura de carpetas del espacio en el desarrollo de aplicaciones y scripts](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/manage-data-files-spaces.htm#FolderStructureRefExamples).