# First

`First` 前缀（属于 `LOAD` 或 `SELECT` (SQL) 语句）前缀用于从数据源表格加载记录的一组最大数。使用 `First` 前缀的一个典型用例是，当您希望从大型和/或慢速数据加载步骤中检索一小部分记录时。一旦加载了定义的“`n`”数量的记录，加载步骤就会过早终止，其余脚本执行将正常继续。

语法：

First n ( loadstatement | selectstatement )

参数

| 参数 | 描述 |
| --- | --- |
| ` n  ` | 求值为整数的任意表达式，表示需要读取的最大记录数。`n` 也可以用括号括起来：`(n)`。 |
| ` loadstatement \| selectstatement  ` | n 参数后面的 `load statement/select statement` 将定义必须加载设置的最大数目记录的指定表。 |

## 区域设置

除非另有规定，本主题中的示例使用以下日期格式：MM/DD/YYYY。日期格式已经在数据加载脚本中的 `SET DateFormat` 语句中指定。由于区域设置和其他因素，系统中的默认日期格式可能有所不同。您可以更改以下示例中的格式以满足您的要求。或者，您可以更改加载脚本中的格式以匹配这些示例。有关更多信息，请参阅[修改应用程序和脚本的区域设置](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/regional-settings-in-apps.htm)。

应用程序中的默认区域设置基于用户配置文件。这些区域格式设置与 Qlik Cloud 用户界面中显示的语言无关。Qlik Cloud 将以与您使用的浏览器相同的语言显示。

如果你是应用程序创建者，你可以为自己创建的应用程序设置默认区域。有关更多信息，请参阅[设置 Qlik Cloud 分析 中创建应用程序和脚本所用的首选区域设置](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/UserInterface/Languages.htm#Setting)。

函数示例

| 示例 | 结果 |
| --- | --- |
| ` FIRST 10 LOAD * from abc.csv;  ` | 本示例将从 excel 文件中检索前十行。 |
| ` FIRST (1) SQL SELECT * from Orders;  ` | 此示例将从 `Orders` 数据集中检索第一个选定行。 |

## 示例 – 加载前五行

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

#### 加载脚本和结果

概述

打开数据加载编辑器，并将下面的加载脚本添加到新部分。

加载脚本包含：

* 2020 年前两周的数据集。

* 指示应用程序仅加载前五条记录的 `First` 变量。

加载脚本

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

结果

加载数据并打开工作表。创建新表并添加 `Date` 为字段并添加 `sum(sales)` 为度量。

结果表

| 日期 | sum(sales) |
| --- | --- |
| 2020 年 1 月 1 日 | 6000 |
| 2020 年 1 月 2 日 | 3000 |
| 2020 年 1 月 3 日 | 6000 |
| 2020 年 1 月 4 日 | 8000 |
| 2020 年 1 月 5 日 | 5000 |

脚本只加载 `Sales` 表的前五条记录。

## 了解详情

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