# First

O prefixo `First` em uma instrução `LOAD` ou `SELECT` (SQL) é usado para carregar um número máximo definido de registros de uma tabela de fonte de dados. Um caso de uso típico para usar o prefixo `First` é quando você deseja recuperar um pequeno subconjunto de registros de uma etapa de carregamento de dados grande e/ou lenta. Assim que o número definido de registros "`n`" for carregado, a etapa de carregamento será encerrada prematuramente, e o restante da execução do script continuará normalmente.

Sintaxe:

First n ( loadstatement | selectstatement )

Argumentos

| Argumento | Descrição |
| --- | --- |
| ` n  ` | Uma expressão arbitrária que é avaliada como um inteiro indicando o número máximo de registros a serem lidos. `n` também pode ser colocado entre parênteses: `(n)`. |
| ` loadstatement \| selectstatement  ` | O `load statement/select statement` que segue o argumento n definirá a tabela especificada que deve ser carregada com o número máximo definido de registros. |

## Configurações regionais

A menos que especificado de outra forma, os exemplos neste tópico usam o seguinte formato de data: MM/DD/AAAA. O formato de data é especificado na instrução `SET DateFormat` no seu script de carregamento de dados. A formatação de data padrão pode ser diferente no seu sistema devido às suas configurações regionais e outros fatores. Você pode alterar os formatos nos exemplos abaixo para atender às suas necessidades. Ou pode alterar os formatos no seu script de carregamento para corresponder a esses exemplos.

As configurações regionais padrão nos aplicativos são baseadas nas configurações regionais do sistema do computador ou servidor onde o Qlik Sense está instalado. Se o servidor Qlik Sense que você está acessando estiver definido como Suécia, o Editor de carregamento de dados usará as configurações regionais suecas para datas, horas e moedas. Essas configurações de formato regional não estão relacionadas ao idioma exibido na Qlik Sense interface do usuário. Qlik Sense será exibido no mesmo idioma do navegador que você está usando.

Exemplos de funções

| Exemplo | Resultado |
| --- | --- |
| ` FIRST 10 LOAD * from abc.csv;  ` | Este exemplo recuperará as primeiras dez linhas de um arquivo do Excel. |
| ` FIRST (1) SQL SELECT * from Orders;  ` | Este exemplo recuperará a primeira linha selecionada do `conjunto de dados` Orders. |

## Exemplo: Carregar as primeiras cinco linhas

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

#### Script de carregamento e resultados

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

* Um conjunto de dados de datas das duas primeiras semanas de 2020.

* A `variável` First, que instrui o aplicativo a carregar somente os cinco primeiros registros.

Script de carregamento

```
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 
]; 
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione `Date` como um campo e `sum(sales)` como uma medida:

Tabela de resultados

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

O script carrega apenas os cinco primeiros registros da tabela `Sales`.

## Saiba mais

* [Load](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)
* [Select](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Select.htm)