# 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 位元或 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/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)as 用來指派欄位的新名稱。 |
| [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)inline | 如果應該在指令碼中輸入資料，而不是從檔案載入資料，可使用 inline。<br><br>data ::= [ text ]<br><br>透過 inline 子句輸入的資料必須以雙引號或方括弧括住。這些之間的文字將以檔案內容的相同方式加以解譯。因此，在文字檔中要插入新行的位置，也應該在 inline 子句的文字中插入新行，也就是在輸入指令碼時按下 Enter 鍵。資料行數量以第一行定義。<br><br>format-spec ::= ( fspec-item {, fspec-item } )<br><br>格式規格包含括弧內數個格式規格項目的清單。如需詳細資訊，請參閱[格式規格項目](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptSpecifiers/format-specification-items.htm)。 |
| [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)resident | 如果應該從先前載入的表格載入資料，可使用 resident。<br><br>table label 是建立原始表格的 LOAD 陳述式之前的標籤。標籤結尾應該加上冒號。<br><br>[從先前載入的表格載入資料](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/load-data-from-previously-loaded-table.htm)<br><br>[表格標籤](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/table-labels.htm) |
| 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/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)where | where 是指明選項中是否應該包含記錄的子句。如果 criterion 為 True，將包含選項。<br><br>criterion 是邏輯運算式。 |
| [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)while | while 是指明是否應該重複讀取記錄所用的子句。只要 criterion 為 True，就會讀取相同的記錄。若要使用，while 子句一般必須包含 IterNo( ) 函數。<br><br>criterion 是邏輯運算式。 |
| [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)group by | group by 是定義應該對哪些欄位彙總 (分組) 資料所用的子句。 彙總欄位應該以某些方式包含在載入的運算式中。只有彙總欄位才能在載入的運算式中的彙總函數之外使用。<br><br>groupbyfieldlist ::= (fieldname { ,fieldname } ) |
| [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/cloud-services/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。不過，透過 as 子句 (aliasname) 建立的欄位若不在範圍內，無法在同一個 load 陳述式內使用。 |

## 瞭解更多資訊

* [Add](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/Prefixes/Add.htm)
* [Replace](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/Prefixes/Replace.htm)