Merge 前置詞可新增至指令碼中的任何 LOAD 或 SELECT 陳述式，以指定載入的表格應合併至另一個表格中。這也能指定應在部分載入中執行此陳述式。
常見使用情況是當您載入變更記錄並想要用來將 inserts、updates 和 deletes 套用至現有表格時。
使用載入按鈕執行部分載入。如需詳細資訊，請參閱 按鈕。您也可以使用 Qlik Engine JSON API。
語法：
Merge [only] [(SequenceNoField [, SequenceNoVar])] On ListOfKeys [Concatenate [(TableName)]] (loadstatement | selectstatement)
引數：
| 引數 | 描述 |
|---|---|
| only | 選用的限定詞，表示只應在部分載入期間執行該陳述式。陳述式在一般 (非部分) 載入期間忽略。 |
| SequenceNoField | 包含時間戳記的欄位名稱或定義操作順序的序號。 |
| SequenceNoVar |
獲得指派合併表格的 SequenceNoField 最大值的變數名稱。 |
| ListOfKeys | 以逗號分隔、指定主要金鑰的欄位名稱清單。 |
| Operation | LOAD 陳述式的第一個欄位必須包含操作作為文字字串：'Insert'、'Update' 或 'Delete'。也接受 ‘i’、‘u’ 和 ‘d’。 |
一般功能
在一般 (非部分) 載入期間，Merge LOAD 建構會作為一般 Load 陳述式運作，但具有附加功能，可移除較舊過時記錄和標記要刪除的記錄。Load 陳述式的第一個欄位必須保留關於操作的資訊：Insert、Update 或 Delete。
對於每個載入的記錄，會比較記錄識別碼與先前載入的記錄，只會保留最新記錄 (根據序號)。若以 Delete 標記最新記錄，將不會保留任何內容。
目標表格
要修改哪個表格由欄位組決定。若具有相同欄位組 (第一個欄位除外；操作) 的表格已存在，這將會是要修改的相關表格。或者，Concatenate 前置詞可用來指定表格。若未決定目標表格，Merge LOAD 建構的結果會儲存在新的表格中。
若使用串連前置詞，產生的表格具有一組對應至現有表格聯集和要合併之輸入的欄位。因此，相較於作為要合併之輸入使用的變更記錄，目標表格可能會取得更多欄位。
部分載入會進行與完整載入相同的事項。差異是部分載入很少建立新的表格。除非您已使用 Only 子句，否則永遠存在具有相同欄位組 (來自先前指令碼執行) 的目標表格。
序號
若載入的變更記錄是累積記錄，亦即這包含已經載入的變更，則參數 SequenceNoVar 可用於 Where 子句，以限制輸入資料量。然後可以讓 Merge LOAD 僅載入記錄，其中欄位 SequenceNoField 大於 SequenceNoVar。完成後，Merge LOAD 會將新的值指派至 SequenceNoVar，並可在 SequenceNoField 欄位中看見最大值。
操作
Merge LOAD 可以有比目標表格更少的欄位。不同的操作以不同的方式處理遺失的欄位：
Insert: 在 Merge LOAD 中遺失但存在於目標表格的欄位，會在目標表格中取得 NULL。
Delete: 遺失的欄位不會影響結果。仍會刪除相關記錄。
Update: 列於 Merge LOAD 的欄位會在目標表格中更新。不會變更遺失的欄位。這表示下列兩個陳述式不相同：
- Merge on Key Concatenate Load 'U' as Operation, Key, F1, Null() as F2 From ...;
- Merge on Key Concatenate Load 'U' as Operation, Key, F1 From ...;
第一個陳述式更新列出的記錄並將 F2 變更為 NULL。第二個不會變更 F2，但會在目標表格中留下值。
範例 1：與指定的表格簡單合併
在此範例中，載入了名為 Persons 的內嵌表格，其中含有三列。然後 Merge 會變更表格，如下所示：
- 新增列 Mary, 4。
- 刪除列 Steven, 3。
- 將數字 5 指派至 Jake。
執行 Merge 後，LastChangeDate 變數會設定為 ChangeDate 欄中的最大值。
載入指令碼
將範例指令碼新增至您的應用程式並予以執行。若要查看結果，將結果資料行中列出的欄位新增至您應用程式中的工作表。
Set DateFormat='D/M/YYYY';
Persons:
load * inline [
Name, Number
Jake, 3
Jill, 2
Steven, 3
];
Merge (ChangeDate, LastChangeDate) on Name Concatenate(Persons)
LOAD * inline [
Operation, ChangeDate, Name, Number
Insert, 1/1/2021, Mary, 4
Delete, 1/1/2021, Steven,
Update, 2/1/2021, Jake, 5
];如需更多關於使用內嵌載入的資訊，請參閱 內嵌載入。
結果
在 Merge Load 之前，產生的表格顯示如下：
| Name | Number |
|---|---|
| Jake | 3 |
| Jill | 2 |
| Steven | 3 |
在 Merge Load 之後，表格顯示如下：
| ChangeDate | Name | Number |
|---|---|---|
| 2/1/2021 | Jake | 5 |
| - | Jill | 2 |
| 1/1/2021 | Mary | 4 |
載入資料時，資料載入進度 對話方塊會顯示執行的操作：
範例 2：含有遺失欄位的資料載入指令碼
在此範例中，會載入與上述相同的資料，但現在含有每個人的 ID。
Merge 變更表格如下：
- 新增列 Mary, 4。
- 刪除列 Steven, 3。
- 將數字 5 指派至 Jake。
- 將數字 6 指派至 Jill。
載入指令碼
在此我們使用兩個 Merge Load 陳述式，一個用於「插入」和「刪除」，第二個用於「更新」。
將範例指令碼新增至您的應用程式並予以執行。若要查看結果，將結果資料行中列出的欄位新增至您應用程式中的工作表。
Set DateFormat='D/M/YYYY';
Persons:
Load * Inline [
PersonID, Name, Number
1, Jake, 3
2, Jill, 2
3, Steven, 3
];
Merge (ChangeDate, LastChangeDate) on PersonID Concatenate(Persons)
Load * Inline [
Operation, ChangeDate, PersonID, Name, Number
Insert, 1/1/2021, 4, Mary, 4
Delete, 1/1/2021, 3, Steven,
];
Merge (ChangeDate, LastChangeDate) on PersonID Concatenate(Persons)
Load * Inline [
Operation, ChangeDate, PersonID, Number
Update, 2/1/2021, 1, 5
Update, 3/1/2021, 2, 6
];結果
在 Merge Load 陳述式之後，表格顯示如下：
| PersonID | ChangeDate | Name | Number |
|---|---|---|---|
| 1 | 2/1/2021 | Jake | 5 |
| 2 | 3/1/2021 | Jill | 6 |
| 4 | 1/1/2021 | Mary | 4 |
請注意，第二個 Merge 陳述式不包括欄位 Name，因此尚未變更名稱。
範例 3：資料載入指令碼 - 使用 Where 子句與 ChangeDate 的部分載入
在以下範例中，Only 引數指定只能在部分載入期間執行 Merge 命令。會根據先前擷取的 LastChangeDate 篩選更新。完成 Merge 之後，會向 LastChangeDate 變數指派合併期間處理的 ChangeDate 欄的最大值。
載入指令碼
Merge Only (ChangeDate, LastChangeDate) on Name Concatenate(Persons)
LOAD Operation, ChangeDate, Name, Number
from [lib://ChangeFilesFolder/BulkChangesInPersonsTable.csv] (txt)
where ChangeDate >= $(LastChangeDate);