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 位元或 64 位元浮點)。讀取的位置編號必須是 4 或 8。
  • 如果 @startpos:endpos 後面緊接著 B 字元,會按照 COMP-3 標準將讀取的位元組解譯為 BCD (Binary Coded Decimal) 編號。可指定任何數目的位元組。

expression 可以是以同一個表格中的其他一或數個欄位為基礎的數值函數或字串函數。如需進一步資訊,請參閱運算式的語法。

as 用來指派欄位的新名稱。

from

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,即可使用。

在舊式指令碼模式下,還支援下列路徑格式:

  • 絕對路徑

    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 子句的文字中插入新行,也就是在輸入指令碼時按下 Enter 鍵。資料行數量以第一行定義。

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

格式規格包含括弧內數個格式規格項目的清單。

resident 如果應該從先前載入的表格載入資料,可使用 resident

table label 是建立原始表格的 LOADSELECT 陳述式之前的標籤。標籤結尾應該加上冒號。

從先前載入的表格載入資料

表格標籤

autogenerate 如果 Qlik Sense 應該自動產生資料,可使用 autogenerate

size ::= number

Number 是表示要產生記錄筆數的整數。

此欄位清單不得包含需要外部資料來源或先前已載入的表格中所含資料的運算式,除非您參考的是先前已透過 Peek 函數載入的表格中的單一欄位值。

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 byload 陳述式處理常駐表格記錄前將這些記錄排序所用的子句。常駐表格可按照一或多個欄位以遞增或遞減順序排序。排序主要以數值進行,其次以國家排序順序進行。只有在資料來源是常駐表格時,才能使用此子句。

排序欄位可指定常駐表格按照哪些欄位排序。可以按照常駐表格的名稱或編號 (第一個欄位的編號是 1) 指定欄位。

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

sortorderasc 表示遞增,以 desc 表示遞減。如果未指定 sortorder,將會採用 asc

fieldnamepathfilenamealiasname 是指出個別名稱代表什麼意義的文字字串。來源表格的任何欄位均可做為 fieldname。不過,透過 as 子句 (aliasname) 建立的欄位若不在範圍內,無法在同一個 load 陳述式內使用。

注意!如果並未透過 frominlineresidentfrom_field、延伸autogenerate 子句指定資料的來源,將從後面的 SELECTLOAD 陳述式結果載入資料。後面的陳述式不應該有前置詞。

從先前載入的表格載入資料

Examples: