# 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 em que 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 interface do usuário do Qlik Sense. O 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

| Date | 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/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Load.htm)
* [Select](https://help.qlik.com/pt-BR/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Select.htm)