# First

Le préfixe `First` associé à une instruction `LOAD` ou `SELECT` (SQL) sert à charger un nombre d'enregistrements maximal défini à partir d'une table de source de données. Un cas d'usage type pour l'utilisation du préfixe `First` peut se produire lorsque vous souhaitez récupérer un petit sous-ensemble d'enregistrements à partir d'une étape de chargement de données importante et/ou lente. Dès que le nombre défini d'enregistrements "`n`" a été chargé, l'étape de chargement se termine prématurément et le reste de l'exécution du script se poursuit normalement.

Syntaxe :

First n ( loadstatement | selectstatement )

Arguments

| Argument | Description |
| --- | --- |
| ` n  ` | Expression arbitraire qui aboutit à un entier indiquant le nombre maximal d'enregistrements à lire. `n` peut également figurer entre parenthèses : `(n)`. |
| ` loadstatement \| selectstatement  ` | L'instruction `load statement/select statement` qui suit l'argument n définira la table spécifiée à charger avec le nombre maximal d'enregistrements défini. |

## Paramètres régionaux

Sauf indication contraire, les exemples de cette rubrique utilisent le format de date suivant : MM/DD/YYYY. Le format de date est indiqué dans l'instruction `SET DateFormat` de votre script de chargement de données. Le format de date par défaut peut être différent dans votre système en raison de vos paramètres régionaux et d'autres facteurs. Vous pouvez modifier les formats utilisés dans les exemples ci-dessous en fonction de vos besoins. Ou vous pouvez modifier les formats utilisés dans votre script de chargement pour qu'ils correspondent à ceux de ces exemples. Pour plus d'informations, consultez [Modification des paramètres régionaux des applications et des scripts](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/regional-settings-in-apps.htm).

Les paramètres régionaux par défaut des applications sont basés sur le profil utilisateur. Ces paramètres de format régionaux ne sont pas liés à la langue affichée dans l'interface utilisateur Qlik Cloud. Qlik Cloud sera affiché dans la même langue que celle du navigateur que vous utilisez.

Si vous êtes un créateur d'applications, vous pouvez définir la région par défaut des applications que vous créez. Pour plus d'informations, consultez [Sélection des paramètres régionaux de votre choix pour la création d'applications et de scripts dans Qlik Cloud Analytics](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/UserInterface/Languages.htm#Setting).

Exemples de fonction

| Exemple | Résultat |
| --- | --- |
| ` FIRST 10 LOAD * from abc.csv;  ` | Cet exemple récupérera les dix premières lignes d'un fichier Excel. |
| ` FIRST (1) SQL SELECT * from Orders;  ` | Cet exemple récupérera la première ligne sélectionnée du jeu de données`Orders`. |

## Exemple – Chargement des cinq premières lignes

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptPrefixes/First.htm)

#### Script de chargement et résultats

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section.

Le script de chargement contient :

* Jeu de données de dates des deux premières semaines de 2020.

* Variable `First` qui demande à l'application de ne charger que les cinq premiers enregistrements.

Script de chargement

```
Sales: 
FIRST 5 
LOAD 
* 
Inline [ 
date,sales 
01/01/2020,6000 
01/02/2020,3000 
01/03/2020,6000 
01/04/2020,8000 
01/05/2020,5000 
01/06/2020,7000 
01/07/2020,3000 
01/08/2020,5000 
01/09/2020,9000 
01/10/2020,5000 
01/11/2020,7000 
01/12/2020,7000 
01/13/2020,7000 
01/14/2020,7000 
]; 
```

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez `Date` comme champ et `sum(sales)` comme mesure :

Tableau de résultats

| Date | sum(sales) |
| --- | --- |
| 01/01/2020 | 6000 |
| 01/02/2020 | 3000 |
| 01/03/2020 | 6000 |
| 01/04/2020 | 8000 |
| 01/05/2020 | 5000 |

Le script charge uniquement les cinq premiers enregistrements de la table `Sales`.

## En savoir plus

* [Load](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)
* [Select](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Select.htm)