# Load L'instruction LOAD charge des champs à partir d'un fichier, de données définies dans le script, d'une table déjà chargée, d'une page Web, du résultat d'une instruction SELECT ultérieure ou via la génération automatique de données. 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 ] Arguments Load | Argument | Description | | --- | --- | | distinct[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) | Vous pouvez utiliser distinct comme prédicat pour charger seulement des enregistrements uniques. En cas d'enregistrements en double, la première instance sera chargée.

Si vous utilisez preceding loads, vous devez placer distinct dans la première instruction load, car distinct affecte uniquement la table de destination. | | fieldlist | fieldlist ::= ( \* \| field {, field } )

Liste des champs à charger. L'utilisation du symbole \* comme liste de champs signifie inclure tous les champs de la table.

field ::= ( fieldref \| expression ) [as aliasname ]

La définition du champ doit toujours contenir un littéral, une référence à un champ existant ou une expression.

fieldref ::= ( fieldname \|@fieldnumber
\|@startpos:endpos
[ I \| U \| R \| B \| T] )

fieldname est un texte identique à un nom de champ dans la table. Notez que le nom du champ doit être mis entre guillemets doubles droits ou entre crochets s'il contient des espaces, par exemple.
Les noms des champs ne sont pas toujours disponibles de manière explicite. Une notation différente est alors utilisée :


@fieldnumber représente le numéro du champ dans un fichier de table délimité. Il doit s'agir d'un entier positif précédé d'un arobase (@). La numérotation est toujours effectuée de 1 jusqu'au nombre total de champs.


@startpos:endpos représente les positions de début et de fin d'un champ dans un fichier contenant des enregistrements de longueur fixe. Ces positions doivent être toutes deux des entiers positifs. Les deux nombres doivent être précédés d'un arobase (@) et séparés par deux-points. La numérotation est toujours effectuée de 1 jusqu'au nombre total de positions. Dans le dernier champ, n est utilisé comme position de fin.



expression peut correspondre à une fonction numérique ou une fonction de chaîne basée sur un ou plusieurs autres champs de la même table. Pour plus d'informations, consultez la syntaxe des expressions.

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)as est utilisé pour attribuer un nouveau nom au champ. | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
from | from est utilisé si les données doivent être chargées à partir d'un fichier.

file ::= [ path ] filename



Si le chemin d'accès est omis, QlikView recherche le fichier dans le répertoire que lui indique l'instruction Directory. Si aucune instruction Directory n'est spécifiée, QlikView recherche le fichier dans le répertoire de travail, qui correspond généralement au répertoire dans lequel se trouve le fichier QlikView.

Note InformationsDans une installation QlikView Server, le répertoire de travail correspond à C:\ProgramData\QlikTech\Documents. Il est possible de modifier le répertoire de travail par défaut à partir de la console Console de gestion QlikView.

L'argument filename peut contenir les caractères génériques DOS standard (\* et ?). Tous les fichiers correspondants sont alors chargés dans le répertoire indiqué.

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

La spécification du format se compose d'une liste de plusieurs éléments de spécification du format, mis entre parenthèses.

[Directory](https://help.qlik.com/fr-FR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Directory.htm)

[From](https://help.qlik.com/fr-FR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/From.htm) | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
from\_field | from\_field est utilisé si les données doivent être chargées à partir d'un champ précédemment chargé.

fieldassource::=(tablename, fieldname)

Le champ correspond au nom des arguments tablename et fieldname précédemment chargés.

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

La spécification du format se compose d'une liste de plusieurs éléments de spécification du format, mis entre parenthèses. | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
inline | inline est utilisé si les données doivent être saisies dans le script au lieu d'être chargées à partir d'un fichier.

data ::= [ text ]

Les données saisies à l'aide d'une clause inline doivent être encadrées par des caractères spécifiques : des crochets, des guillemets ou des backticks (`). Le texte placé entre ces guillemets ou crochets est interprété de la même manière que le contenu d'un fichier. C'est pourquoi vous devez également insérer une nouvelle ligne dans la clause inline, là où vous en auriez inséré une dans un fichier texte : en appuyant sur la touche Entrée lors de la saisie du script.

Dans un chargement inline simple, le nombre de colonnes est défini par la première ligne.

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

Vous pouvez personnaliser le chargement inline à l'aide d'un grand nombre des éléments de spécification de format disponibles pour d'autres tables chargées. Ces éléments sont répertoriés entre parenthèses. Pour plus d'informations, consultez [Éléments de spécification du format](https://help.qlik.com/fr-FR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptSpecifiers/format-specification-items.htm).

Pour plus d'informations sur les chargements inline, voir [Chargement de données depuis des tables inline](https://help.qlik.com/fr-FR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/inline-loads-qv.htm). | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
resident | resident est utilisé si les données doivent être chargées à partir d'une table précédemment chargée.

table label est une étiquette précédant l'instruction LOAD ou SELECT ayant créé la table de départ. L'étiquette doit être saisie avec deux-points à la fin.

Lorsque vous utilisez une combinaison d'instructions de chargement distinct et resident dans QlikView12.00 ou version ultérieure, l'ordre de chargement des données diffère de celui de QlikView11.20. Pour définir l'ordre de chargement souhaité, ajoutez une clause order by.

[Chargement de données à partir d'une table déjà chargée](https://help.qlik.com/fr-FR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/load-data-from-previously-loaded-table.htm)

[Étiquettes de table](https://help.qlik.com/fr-FR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/table-labels.htm) | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
autogenerate | autogenerate est utilisé si les données doivent être générées automatiquement par QlikView.

size ::= number

Number est un entier indiquant le nombre d'enregistrements à générer. La liste des champs ne doit pas contenir d'expressions qui requièrent des données provenant d'une base de données. Ne sont admises dans les expressions que des constantes et des fonctions sans paramètres (par ex. rand() ou recno()). | | extension | Vous pouvez charger des données à partir de connexions analytiques. Vous devez utiliser la clause extension pour appeler une fonction définie dans le plug-in SSE (Server-Side Extension) ou pour évaluer un script.

Il est possible d'envoyer une seule table au plug-in SSE ; une seule table de données est alors renvoyée. Si le plug-in ne précise pas les noms des champs renvoyés, les champs seront nommés Field1, Field2, et ainsi de suite.

Extension pluginname.functionname( tabledescription );



Gestion des types de données dans la définition des champs de table

Les types de données sont automatiquement détectés dans les connexions analytiques. Si les données ne comportent aucune valeur numérique et comprennent au moins une chaîne de texte non NULLE, le champ est interprété comme du texte. Dans tous les autres cas, il est considéré comme de type numérique.

Vous pouvez appliquer un type de données forcé en entourant le nom d'un champ à l'aide de String() ou Mixed().



Il est impossible d'utiliser String() ou Mixed() en dehors des définitions de champ de table extension. De plus, vous ne pouvez pas utiliser d'autres fonctions QlikView dans une définition de champ de table.

Informations complémentaires sur les connexions analytiques

Pour créer une connexion analytique dans QlikView Server ou QlikView Desktop, consultez : [Connexions analytiques](https://help.qlik.com/fr-FR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Analytic_connections.htm).

Vous trouverez des informations complémentaires sur les connexions analytiques dans le référentiel GitHub : [qlik-oss/server-side-extension](https://github.com/qlik-oss/server-side-extension). | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
where | where est une clause utilisée pour indiquer si un enregistrement doit être inclus ou pas dans la sélection. La sélection est incluse si l'expression criterion est définie sur True.

criterion est une expression logique. | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
while | while est une clause utilisée pour indiquer si un enregistrement doit être lu plusieurs fois. Le même enregistrement est lu tant que l'expression criterion est définie sur True. Pour être utile, une clause while doit généralement inclure la fonction IterNo( ).

criterion est une expression logique. | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
group\_by | group by est une clause utilisée pour déterminer les champs sur lesquels les données doivent être agrégées (groupées). Les champs d'agrégation doivent être inclus d'une manière ou d'une autre dans les expressions chargées. Aucun autre champ que les champs d'agrégation ne peut être utilisé en dehors des fonctions d'agrégation dans les expressions chargées.

groupbyfieldlist ::= (fieldname { ,fieldname } ) | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
order\_by | order by est une clause utilisée pour trier les enregistrements d'une table résidente avant qu'ils ne soient traités par l'instruction load. La table résidente peut être triée par un ou plusieurs champs, par ordre croissant ou décroissant. Le tri est principalement effectué par valeur numérique, puis par valeur de paramètres régionaux de classement national. Cette clause peut uniquement être utilisée lorsque la source de données est une table résidente.

Les champs de tri indiquent les champs selon lesquels la table résidente est triée. Le champ peut être spécifié par son nom ou par son numéro dans la table résidente (le premier champ est le numéro 1).

orderbyfieldlist ::= fieldname [ sortorder ] { , fieldname [ sortorder ] }

sortorder correspond soit à asc pour un ordre croissant, soit à desc pour un ordre décroissant. Si aucun argument sortorder n'est spécifié, c'est asc qui est utilisé.

fieldname, path, filename et aliasname sont des chaînes textuelles représentant ce que ces noms désignent. N'importe quel champ de la table source peut être utilisé comme fieldname. Toutefois, les champs créés via la clause as (aliasname) ne sont pas concernés et ne peuvent pas être utilisés dans la même instruction load. | Si aucune source de données n'est fournie par les clauses from, inline, resident, from\_field ou autogenerate, les données sont chargées à partir du résultat de l'instruction SELECT ou LOAD qui suit immédiatement. L'instruction qui suit ne doit pas comporter de préfixe. [Instruction LOAD antérieure](https://help.qlik.com/fr-FR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/preceding-load.htm) [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Chargement de différents formats de fichier Chargez un fichier de données délimité défini à l'aide des options par défaut : `LOAD * from data1.csv; ` Chargez un fichier délimité, en spécifiant la virgule comme délimiteur et en incluant les étiquettes incorporées : `LOAD * from 'c:\userfiles\data1.csv' (ansi, txt, delimiter is ',', embedded labels); ` Chargez un fichier délimité, en spécifiant la tabulation comme délimiteur et en incluant les étiquettes incorporées : `LOAD * from 'c:\userfiles\data2.txt' (ansi, txt, delimiter is '\t', embedded labels);` Chargez un fichier dif avec les en-têtes incorporés : `LOAD * from file2.dif (ansi, dif, embedded labels);` Chargez trois champs à partir d'un fichier d'enregistrements fixes sans en-têtes : `LOAD @1:2 as ID, @3:25 as Name, @57:80 as City from data4.fix (ansi, fix, no labels, header is 0, record is 80); ` Chargez un fichier QVX en spécifiant un chemin d'accès absolu : `LOAD * from C:\qdssamples\xyz.qvx (qvx);` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Sélection de certains champs, modification de noms de champ et calcul de champs Chargez uniquement trois champs spécifiques à partir d'un fichier délimité : `LOAD FirstName, LastName, Number from data1.csv; ` Renommez le premier champ A et le deuxième champ B lors du chargement du fichier sans étiquettes : `LOAD @1 as A, @2 as B from data3.txt (ansi, txt, delimiter is '\t', no labels); ` Chargez le nom (Name) sous la forme d'une concaténation du prénom, d'un espace et du nom de famille, soit FirstName, espace et LastName : `LOAD FirstName&' '&LastName as Name from data1.csv; ` Chargez Quantity, Price et Value (le produit de Quantity et Price) : `LOAD Quantity, Price, Quantity*Price as Value from data1.csv;` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Sélection de certains enregistrements Chargez exclusivement des enregistrements uniques, les doublons étant ignorés : `LOAD distinct FirstName, LastName, Number from data1.csv; ` Chargez uniquement des enregistrements où le champ Litres est doté d'une valeur supérieure à zéro : `LOAD * from Consumption.csv where Litres>0; ` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Chargement de données ne se trouvant pas dans un fichier et de données générées automatiquement Chargez une table comportant des données intégrées, deux champs nommés CatID et Category : ` LOAD * Inline ` ` [CatID, Category ` ` 0,Regular ` ` 1,Occasional ` ` 2,Permanent]; ` Chargez une table comportant des données intégrées, trois champs nommés UserID, Password et Access : ` LOAD * Inline [UserID, Password, Access ` ` A, ABC456, User ` ` B, VIP789, Admin]; ` Chargez une table comportant 10 000 lignes. Le champ A contiendra le numéro de l'enregistrement lu (1,2,3,4,5...) tandis que le champ B contiendra un nombre aléatoire compris entre 0 et 1 : `LOAD RecNo( ) as A, rand( ) as B autogenerate(10000);` Note InformationsLa parenthèse après autogenerate est autorisée, mais elle n'est pas obligatoire. [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Chargement de données à partir d'une table déjà chargée Nous commençons par charger un fichier de table délimité, que nous nommons tab1 : ` tab1: ` `SELECT A,B,C,D from transtable; ` Chargez les champs de la table tab1 déjà chargée sous tab2 : `tab2:` `LOAD A,B,month(C),A*B+D as E resident tab1;` Chargez les champs de la table tab1 déjà chargée mais uniquement les enregistrements où le champ A est supérieur au champ B : `tab3:` `LOAD A,A+B+C resident tab1 where A>B;` Chargez les champs de la table tab1 déjà chargée en les classant d'après le champ A : `LOAD A,B*C as E resident tab1 order by A;` Chargez les champs de la table tab1 déjà chargée, en les classant d'après le premier champ, puis le deuxième champ : `LOAD A,B*C as E resident tab1 order by 1,2;` Chargez les champs de la table tab1 déjà chargée en les classant d'après le champ C par ordre décroissant, puis d'après le champ B par ordre croissant et enfin d'après le premier champ par ordre décroissant : `LOAD A,B*C as E resident tab1 order by C desc, B asc, 1 des;` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Chargement de données à partir de champs déjà chargés Chargez le champ Types de la table Characters déjà chargée sous A : `LOAD A from_field (Characters, Types);` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Chargement de données à partir d'une table suivante (instruction load antérieure) Chargez les champs A, B et les champs calculés X et Y à partir de la table Table1 chargée dans l'instruction SELECT ultérieure : ` LOAD A, B, if(C>0,'positive','negative') as X, weekday(D) as Y; ` `SELECT A,B,C,D from Table1;` [Instruction LOAD antérieure](https://help.qlik.com/fr-FR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/preceding-load.htm) [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Groupement de données Chargez les champs (agrégés) par numéro d'article (ArtNo) : `LOAD ArtNo, round(Sum(TransAmount),0.05) as ArtNoTotal from table.csv group by ArtNo; ` Chargez les champs (agrégés) par semaine et par numéro d'article (Week et ArtNo) : `LOAD Week, ArtNo, round(Avg(TransAmount),0.05) as WeekArtNoAverages from table.csv group by Week, ArtNo;` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Lecture répétée d'un enregistrement Dans cet exemple, soit un fichier d'entrée nommé Grades.csv contenant les notes des étudiants condensées dans un champ : `Student,Grades` `Mike,5234` `John,3345` `Pete,1234` `Paul,3352` Les notes, comprises sur une échelle de 1 à 5, représentent les matières Math, English, Science et History (maths, anglais, sciences et histoire). Nous pouvons séparer les notes en valeurs distinctes en lisant chaque enregistrement plusieurs fois à l'aide d'une clause while au moyen de la fonction de décompte IterNo( ). Lors de chaque lecture, la note est extraite au moyen de la fonction Mid et stockée dans Grade tandis que la matière est sélectionnée à l'aide de la fonction pick et conservée dans Subject. La clause while finale contient le test permettant de vérifier que toutes les notes ont été lues (quatre par étudiant dans ce cas), ce qui signifie que l'enregistrement d'étudiant suivant doit être lu. ` 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));` Le résultat est une table contenant les données suivantes : ![A table containing data for Students, Subjects, and Grades.](https://help.qlik.com/fr-FR/qlikview/September2026/Subsystems/Client/Content/Resources/Images/ex_gen_LoadRepeated.png) [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Chargement à partir de connexions analytiques Les échantillons de données suivants sont utilisés. ``` Values: Load Rand() as A, Rand() as B, Rand() as C AutoGenerate(50); ``` Chargement de données à l'aide d'une fonction Dans les exemples suivants, nous partons du principe que le plug-in de connexions analytiques intitulé P contient une fonction personnalisée Calculate(Parameter1, Parameter2). La fonction renvoie la table Results qui contient les champs Field1 et Field2. ``` Load * Extension P.Calculate( Values{A, C} ); ``` Chargez tous les champs renvoyés lors de l'envoi des champs A et C à la fonction. ``` Load Field1 Extension P.Calculate( Values{A, C} ); ``` Chargez uniquement le champ Field1 lors de l'envoi des champs A et C à la fonction. ``` Load * Extension P.Calculate( Values ); ``` Chargez tous les champs renvoyés lors de l'envoi des champs A et B à la fonction. Comme les champs ne sont pas spécifiés, A et B sont utilisés, car ce sont les premiers affichés dans l'ordre de la table. ``` Load * Extension P.Calculate( Values {C, C}); ``` Chargez tous les champs renvoyés lors de l'envoi du champ C aux deux paramètres de la fonction. Load \* Extension P.Calculate( Values {String(A), Mixed(B)}); Chargez tous les champs renvoyés lors de l'envoi à la fonction du champ A converti de force en chaîne et du champ B converti de force en valeur numérique. Chargement de données via l'évaluation d'un script Load A as A\_echo, B as B\_echo Extension R.ScriptEval( 'q;', Values{A, B} ); Chargez la table renvoyée par le script q lors de l'envoi des valeurs de A et B. Load \* Extension R.ScriptEval( '$(My\_R\_Script)', Values{A, B} ); Chargez la table renvoyée par le script stocké dans la variable My\_R\_Script lors de l'envoi des valeurs de A et B. Load \* Extension R.ScriptEval( '$(My\_R\_Script)', Values{B as D, \*} ); Chargez la table renvoyée par le script stocké dans la variable My\_R\_Script lors de l'envoi des valeurs de B renommées D, A et C. L'utilisation du caractère \* permet d'envoyer les champs non référencés restants. [Éléments de spécification du format](https://help.qlik.com/fr-FR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptSpecifiers/format-specification-items.htm)