Load

LOAD 语句可以加载以下来源的字段:文件、脚本中定义的数据、预先载入的输入表格、网页、后续 SELECT 语句产生的结果或自动生成的数据。还可从分析连接加载数据。

Syntax:  

LOAD [ distinct ] fieldlist

[( from file [ format-spec ] |

from_field fieldassource [format-spec]|

inline data [ format-spec ] |

resident table-label |

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

[ where criterion | while criterion ]

[ group by groupbyfieldlist ]

[order by orderbyfieldlist ]

Arguments:  

参数 说明
distinct distinct 是一个只应加载第一条重复记录使用的谓语。
fieldlist fieldlist ::= ( * | field {, * | field } )

要加载的字段列表。使用 * 作为字段列表,表示表格中全部字段。

field ::= ( fieldref | expression ) [as aliasname ]

字段定义必须总是包含精确的对现存字段或表达式的引用。

fieldref ::= ( fieldname |@fieldnumber |@startpos:endpos [ I | U | R | B | T] )

fieldname 是指与表格中的字段名完全相同的文本。注意,如果包含空格,则字段名必须使用双引号或方括号括起来。有时字段名不会显示可用。这时使用另外的符号:

@fieldnumber 表示字段数字在带分隔符的表格文件中。它必须是前面带“@”的正整数。编号通常从 1 开始至字段数字。

@startpos:endpos 代表在拥有固定长度记录的文件中字段的开始和结束位置。这两个位置必须都是正整数。这两个数字前都必须加上“@”并用冒号隔开。编号通常从 1 开始至位置数字。在最后一个字段中,将 n 用作结束位置。

  • 如果 @startpos:endpos 后紧随字符 IU,字节读取将分别解释为二进制带符号 (I) 或不带符号 (U) 整数(Intel 字节序)。数字读取位置必须是 1,2 或 4。
  • 如果 @startpos:endpos 后紧随字符 R,字节读取将解释成二进制实数(IEEE 32-bit 或 64 位浮点)。数字读取位置必须是4 或 8。
  • 如果 @startpos:endpos 后紧随字符 B,字节读取将根据 COMP-3 标准解释成 BCD (Binary Coded Decimal) 数字。任何字节数可以是指定的。

expression 可以是数学函数或基于同一表格中一个或多个其他字段的字符串函数。有关详细信息,请参阅表达式的语法。

as 用于为字段设定新名称。

from

如果使用文件夹或 Web 文件数据连接从文件加载数据,可使用 from

file ::= [ path ] filename

Example: 'lib://Table Files/'

如果路径被省略,Qlik Sense 则在由 Directory 语句指定的目录中搜索文件。如果没有 Directory 语句,则 Qlik Sense 将在工作目录 C:\Users\{user}\Documents\Qlik\Sense\Apps 中搜索。

Directory

备注: Qlik Sense 服务器安装中,工作目录是在 Qlik Sense Repository Service 中指定,默认情况下是 C:\ProgramData\Qlik\Sense\Apps有关详细信息,请参阅 Qlik Management Console 帮助。

filename 可能包含标准 DOS 通配符字符(*?)。这将导致指定目录中的所有匹配文件被加载。

format-spec ::= ( fspec-item { , fspec-item } )

格式规格包含数个格式规格项目的列表(在括号中)。

格式规格项目

提示: 您可使用 URL is 格式来覆盖 Web 文件数据连接的 URL,例如如果您需要根据加载的其他数据创建动态 URL 时可这样操作。

在传统脚本模式下,同时支持以下路径格式:

  • absolute

    Example: c:\data\

  • 相对 Qlik Sense 应用程序工作目录的相对路径。

    Example: data\

  • URL 地址(HTTPFTP),指向一个互联网或内联网的位置。

    Example: http://www.qlik.com

from_field 如果需要从之前加载的字段加载数据,则使用 from_field 语句。

fieldassource::=(tablename, fieldname)

该字段是之前加载过的 tablenamefieldname 的名称。

format-spec ::= ( fspec-item {, fspec-item } )

格式规格包含数个格式规格项目的列表(在括号中)。

inline inline 当数据需要输入脚本而不是从文件中加载时使用该符号。

data ::= [ text ]

通过 inline 子句的输入的数据由双引号或方括号括起来。括号之间的文本以同一方式被解释为文件的内容。因此,当您需要在文本文件中插入新的一行时,您应该在 inline 子句文本中重复该操作,即,键入脚本时按压输入键。列数通过第一行来定义。

format-spec ::= ( fspec-item {, fspec-item } )

格式规格包含数个格式规格项目的列表(在括号中)。

resident 如果需要从之前加载的表格加载数据,则使用 resident 语句。

table label 是加在创建于原始表格的 LOADSELECT 语句之前的标签。该标签需要在末尾加上冒号。

从之前加载的表格中加载数据

表格标签

autogenerate autogenerate 是数据需要 Qlik Sense 自动生成时使用。

size ::= number

Number 是用来指示生成记录数字的整数。

字段列表不得包含需要外部数据源或之前加载表格中数据的表达式,除非您引用之前使用 Peek 函数加载的表格中的单个字段值。

extension

您可从分析连接加载数据。您需要使用 extension 子句来调用在服务器端扩展 (SSE) 插件中定义的函数或计算脚本。

您可将单个表格发送至 SSE 插件,并返回单个数据表。如果插件没有指定返回的字段的名称,字段将被命名为 Field1, Field2,并且以此类推。

Extension pluginname.functionname( tabledescription );

  • 使用 SSE 插件中的函数加载数据

    tabledescription ::= (table { ,tablefield} )

    如果您没有声明表格字段,将按加载顺序使用这些字段。

  • 通过在 SSE 插件中运算脚本来加载数据

    tabledescription ::= ( script, table { ,tablefield} )

将在分析连接中自动检测数据类型。如果数据没有数值以及至少一个非 NULL 文本字符串,则字段被视为文本。在其他任何情况下中,其将被视为数字。

您可通过用 String()Mixed() 围住字段名称来强制规定数据类型。

  • String() 将强制规定字段为文本。如果字段是数字,则会提取双重值的文本部分,不会执行转换。
  • Mixed() 强制规定字段为双重值。

String()Mixed() 不能在扩展表格字段定义之外使用,并且您无法在表格字段定义中使用其他 Qlik Sense 函数。

您需要先配置分析连接方可使用它们。

Qlik Sense Enterprise:创建分析连接

Qlik Sense Desktop: 配置 Qlik Sense Desktop 中的分析连接

您可在 GitHub 储存库中了解有关分析连接的更多信息。qlik-oss/server-side-extension

where where 是一个子句,用于陈述一个记录是否应该包括在选择项内。如果 criterionTrue,则将其包括在选择项内。

criterion 是一个逻辑表达式。

while

while 是用于显示记录是否应该反复读取的子句。只要 criterionTrue,则同一记录被读取。为了能发挥作用,while 子句通常应包含 IterNo( ) 函数。

criterion 是一个逻辑表达式。

group by

group by 是用于定义应聚合(组合)的字段的子句。 聚合字段应该以某种方式包含在加载表达式中。除了聚合字段没有其他字段可被用于加载表达式中的聚合函数之外。

groupbyfieldlist ::= (fieldname { ,fieldname } )

order by order by 是用于被加于 load 语句之前的驻留表记录排序的子句。驻留表可以被一个或多个字段以升序或降序的顺序排序。排序主要由数值决定,其次由国家校对顺序决定。此子句仅在数据源为驻留表时可用。

排序字段用于指定驻留表按哪些字段排序。驻留表中的字段可以由其名称或其数字指定(第一个字段为 1)。

orderbyfieldlist ::= fieldname [ sortorder ] { , fieldname [ sortorder ] }

sortorder 要么是 asc(对于升序),要么是 desc(对于降序)。如果未指定任何 sortorder,将假设 asc

fieldnamepathfilenamealiasname 都是表示他们各自名称的字符串。源表格中的任何字段都可用作 fieldname。但是,通过子句 (aliasname) 创建的字段不在此范围之内,且不能用于相同的 load 语句内。

如果 frominlineresidentfrom_field、extensionautogenerate 子句都无法给出数据源,则数据将从 SELECTLOAD 语句随后得出的结果中加载。接下来的语句不应包含前缀。

从之前加载的表格中加载数据

Examples: