# Load

在图表修改上下文中，LOAD 语句从脚本中定义的数据或以前加载的表中向超立方体加载其他数据。还可从分析连接加载数据。

信息注释LOAD 语句必须具有 Replace 或 Add 前缀，否则将被拒绝。

语法：

Add | Replace LOAD fieldlist

(

inline data [ format-spec ] |

resident table-label

) | extension pluginname.functionname([script] tabledescription)]

[ where criterion | while criterion ]

[ group by groupbyfieldlist ]

[order by orderbyfieldlist ]

参数：

参数

| 参数 | 描述 |
| --- | --- |
| fieldlist | fieldlist ::= ( \* \| field{, \* \| field } )<br><br>要加载的字段列表。使用 \* 作为字段列表，表示表格中全部字段。<br><br>field ::= ( fieldref \| expression ) [as aliasname ]<br><br>字段定义必须总是包含精确的对现存字段或表达式的引用。<br><br>fieldref ::= ( fieldname \|@fieldnumber \|@startpos:endpos [ I \| U \| R \| B \| T] )<br><br>fieldname 是指与表格中的字段名完全相同的文本。注意，如果包含空格，则字段名必须使用双引号或方括号括起来。有时字段名不会显示可用。这时使用另外的符号：<br><br>@fieldnumber 表示字段数字在带分隔符的表格文件中。它必须是前面带“@”的正整数。编号通常从 1 开始至字段数字。<br><br>@startpos:endpos 代表在拥有固定长度记录的文件中字段的开始和结束位置。这两个位置必须都是正整数。这两个数字前都必须加上“@”并用冒号隔开。编号通常从 1 开始至位置数字。在最后一个字段中，将 n 用作结束位置。<br><br><ul><li>如果 <span>@<span>startpos</span>:<span>endpos</span></span> 后紧随字符 <span>I</span> 或<span>U</span>，字节读取将分别解释为二进制带符号 (<span>I</span>) 或不带符号 (<span>U</span>) 整数（Intel 字节序）。数字读取位置必须是 1，2 或 4。 </li><li>如果 <span>@<span>startpos</span>:<span>endpos</span></span> 后紧随字符 <span>R</span>，字节读取将解释成二进制实数（IEEE 32-bit 或 64 位浮点）。数字读取位置必须是4 或 8。 </li><li>如果 <span>@<span>startpos</span>:<span>endpos</span></span> 后紧随字符 <span>B</span>，字节读取将根据 COMP-3 标准解释成 <span>BCD (Binary Coded Decimal)</span> 数字。任何字节数可以是指定的。 </li></ul><br><br>expression 可以是数学函数或基于同一表格中一个或多个其他字段的字符串函数。有关详细信息，请参阅表达式的语法。<br><br>[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)as 用于为字段设定新名称。 |
| [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)inline | inline 当数据需要输入脚本而不是从文件中加载时使用该符号。<br><br>data ::= [ text ]<br><br>通过 inline 子句的输入的数据由双引号或方括号括起来。括号之间的文本以同一方式被解释为文件的内容。因此，当您需要在文本文件中插入新的一行时，您应该在 inline 子句文本中重复该操作，即，键入脚本时按压输入键。列数通过第一行来定义。<br><br>format-spec ::= ( fspec-item {, fspec-item } )<br><br>格式规格包含数个格式规格项目的列表（在括号中）。有关更多信息，请参阅[格式规格项目](https://help.qlik.com/zh-CN/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptSpecifiers/format-specification-items.htm)。 |
| [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)resident | 如果需要从之前加载的表格加载数据，则使用 resident 语句。<br><br>table label 是加在创建原始表格的 LOAD 语句之前的标签。该标签需要在末尾加上冒号。<br><br>[从之前加载的表格中加载数据](https://help.qlik.com/zh-CN/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Scripting/load-data-from-previously-loaded-table.htm)<br><br>[表格标签](https://help.qlik.com/zh-CN/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Scripting/table-labels.htm) |
| extension | 您可从分析连接加载数据。您需要使用 extension 子句来调用在服务器端扩展 (SSE) 插件中定义的函数或计算脚本。<br><br>您可将单个表格发送至 SSE 插件，并返回单个数据表。如果插件没有指定返回的字段的名称，字段将被命名为 Field1, Field2，并且以此类推。<br><br>Extension pluginname.functionname( tabledescription );<br><br><ul><li><p>使用 SSE 插件中的函数加载数据 </p><p><span>tabledescription ::= (table { ,tablefield} )</span></p><p>如果您没有声明表格字段，将按加载顺序使用这些字段。</p></li><li><p>通过在 SSE 插件中运算脚本来加载数据</p><p><span>tabledescription ::= ( script, table { ,tablefield} )</span></p></li></ul><br><br>表格字段定义中的数据类型处理<br><br>将在分析连接中自动检测数据类型。如果数据没有数值以及至少一个非 NULL 文本字符串，则字段被视为文本。在其他任何情况下中，其将被视为数字。<br><br>您可通过用 String() 或 Mixed() 围住字段名称来强制规定数据类型。<br><br><ul><li><span>String()</span> 将强制规定字段为文本。如果字段是数字，则会提取双重值的文本部分，不会执行转换。</li><li><span>Mixed()</span> 强制规定字段为双重值。</li></ul><br><br>String() 或 Mixed() 不能在扩展表格字段定义之外使用，并且您无法在表格字段定义中使用其他 Qlik Sense 函数。<br><br>您可在 GitHub 储存库中了解有关分析连接的更多信息。[qlik-oss/server-side-extension](https://github.com/qlik-oss/server-side-extension) |
| [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)where | where 是一个子句，用于陈述一个记录是否应该包括在选择项内。如果 criterion 为 True，则将其包括在选择项内。<br><br>criterion 是一个逻辑表达式。 |
| [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)while | while 是用于显示记录是否应该反复读取的子句。只要 criterion 为 True，则同一记录被读取。为了能发挥作用，while 子句通常应包含 IterNo( ) 函数。<br><br>criterion 是一个逻辑表达式。 |
| [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)group by | group by 是用于定义应聚合（组合）的字段的子句。 聚合字段应该以某种方式包含在加载表达式中。除了聚合字段没有其他字段可被用于加载表达式中的聚合函数之外。<br><br>groupbyfieldlist ::= (fieldname { ,fieldname } ) |
| [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)order by | order by 是用于被加于 load 语句之前的驻留表记录排序的子句。驻留表可以被一个或多个字段以升序或降序的顺序排序。排序主要由数值决定，其次由国家校对顺序决定。此子句仅在数据源为驻留表时可用。<br><br>排序字段用于指定驻留表按哪些字段排序。驻留表中的字段可以由其名称或其数字指定（第一个字段为 1）。<br><br>orderbyfieldlist ::= fieldname [ sortorder ] { , fieldname [ sortorder ] }<br><br>sortorder 要么是 asc（对于升序），要么是 desc（对于降序）。如果未指定任何 sortorder，将假设 asc。<br><br>fieldname、path、filename 和 aliasname 都是表示他们各自名称的字符串。源表格中的任何字段都可用作 fieldname。但是，通过子句 (aliasname) 创建的字段不在此范围之内，且不能用于相同的 load 语句内。 |

## 了解详情

* [Add](https://help.qlik.com/zh-CN/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/Prefixes/Add.htm)
* [Replace](https://help.qlik.com/zh-CN/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/Prefixes/Replace.htm)