# 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` 语句中指定。由于区域设置和其他因素，系统中的默认日期格式可能有所不同。您可以更改以下示例中的格式以满足您的要求。或者，您可以更改加载脚本中的格式以匹配这些示例。

应用程序中的默认区域设置基于安装 Qlik Sense 的计算机或服务器的区域系统设置。如果您访问的 Qlik Sense 服务器设置为瑞典，则数据加载编辑器将使用瑞典地区设置的日期、时间和货币。这些区域格式设置与 Qlik Sense 用户界面中显示的语言无关。Qlik Sense 将以与您使用的浏览器相同的语言显示。

函数示例

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

## 示例 – 加载前五行

[](https://help.qlik.com/en-US/sense/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) |
| --- | --- |
| 01/01/2020 | 6000 |
| 01/02/2020 | 3000 |
| 01/03/2020 | 6000 |
| 01/04/2020 | 8000 |
| 01/05/2020 | 5000 |

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

## 了解详情

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