# 湖登陸設定

您可為湖登陸資料任務進行設定。

* 開啟登陸任務並在工具列中按一下設定。

就會開啟 設定：<Task-Name> 對話方塊。可用設定如下所述。

## 一般

更新方法

登陸任務一律以完整載入開始。完整載入完成後，您可以使用下列方法之一，將登陸的資料保持為最新狀態：

資訊備註登陸資料任務準備操作完成後，就無法變更更新方法。
* 變更資料擷取 (CDC)

  登陸資料會使用 CDC (變更資料擷取) 技術保持最新狀態。CDC 可能不支援所有資料來源。CDC 不會擷取 DDL 作業，例如重新命名資料行或中繼資料的變更。

  若資料也包含不支援 CDC 的檢視或表格，將會建立兩個資料管道。一個管道具有支援 CDC 的所有表格，另一個管道具有使用載入作為更新方法的所有其他表格和檢視。

* 載入

  會從來源載入所有登陸的資料。若來源不支援 CDC，但可搭配任何支援的資料來源使用，則這很實用。

  您可以定期排程載入。

要使用的資料夾

選取將資料登陸到暫存區域時要使用的資料夾。
* 預設資料夾

  如此可建立預設名稱為 <專案名稱>/<資料任務名稱> 的資料夾。

* 根資料夾

  將資料存放在儲存區的根資料夾。

* 資料夾

  指定要使用的資料夾名稱。

## 資料上傳

* 最大檔案大小 (MB)

  檔案在關閉之前可達到的大小上限。較小的檔案可能上傳得更快 (取決於網路)，並且可在結合平行執行選項使用時改善效能。不過，以小檔案叢集資料庫通常被視為不良做法。

  資訊備註此設定與 Qlik Cloud 除外的所有資料平台有關。

* 使用壓縮

  選取後，將會先壓縮 CSV 檔案 (使用 gzip)，再上傳至 Google BigQuery。

  資訊備註

  * 此設定僅與 Google BigQuery 相關。
  * 需要 資料移動閘道 2023.5.16 或更高版本。

## 中繼資料

### LOB 欄

資訊備註此設定不適用於使用 SaaS 應用程式連接器 的任務，除非是[精簡版連接器](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/connecting-web-applications.htm#Lite)。

* 納入 LOB 欄並將欄大小限制為 (KB)：

  您可選擇在任務中納入 LOB 欄，以及設定最大 LOB 大小。將會截斷大於最大大小的 LOB。

  資訊備註以 Azure Synapse Analytics 作為目標時，最大 LOB 大小無法超過 7 MB。

### 控制表格

選取您要在目標平台建立下列哪些控制表格：

* 登陸狀態： 提供關於目前登陸任務的詳細資訊，包括任務狀態、任務取用的記憶體量、尚未套用至資料平台的變更數量，以及目前讀取 資料移動閘道 的來源端點中的位置。

* 暫停表格： 提供暫停表格清單，以及暫停的原因。

* 登陸歷史記錄： 提供關於任務歷史記錄的資訊，包括在登陸任務期間處理的記錄數目和記錄量、CDC 任務結束時的延遲等。

* [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/Lake-Landing-settings.htm)DDL 歷史記錄：包含發生於任務期間的所有受支援 DDL 變更的歷史記錄。

  僅下列目標平台支援 DDL 歷史記錄表格：

  * Databricks

  * Microsoft Fabric

  * Amazon Redshift

  * 如果您正在使用 資料移動閘道，則以下目標需要版本 2024.11.14 或更高版本：

    * Amazon S3
    * Google Cloud Storage
    * Snowflake

  * Kafka - 如果您正在使用 資料移動閘道，則需要版本 2025.5.42 或更高版本。

  * 如果您正在使用 資料移動閘道，則以下目標需要版本 2025.11.1 或更高版本：

    * Google BigQuery
    * 適用於 PostgreSQL 的 Google Cloud Alloy DB (透過 PostgreSQL 連接器)
    * 適用於 PostgreSQL 的 Google Cloud SQL (透過 PostgreSQL 連接器)
    * Microsoft Azure Database for PostgreSQL (透過 PostgreSQL 連接器)
    * PostgreSQL

如需每個控制表格的詳細描述，請參閱 [控制表格](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Replicating/control_tables.htm)

## 完整載入

資訊備註這些設定不適用於使用 SaaS 應用程式連接器的任務。

### 效能微調

* 要平行載入的表格數量上限：輸入一次載入到目標中的表格數量上限。預設值為 5。

* [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/Lake-Landing-settings.htm)交易一致性逾時 (秒)：輸入在開始完整載入操作之前，應等待開放的交易關閉的秒數。預設值為 600 (10 分鐘)。將會在達到逾時值之後開始完整載入，即使有仍然開放的交易也是如此。

  資訊備註若要複寫完整載入開始時開放但僅在達到逾時值之後認可的交易，您需要載入目標表格。

* [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/Lake-Landing-settings.htm)完整載入期間的認可率：可以一起傳輸的事件數量上限。預設值為 10000。

### 完整載入完成之後

建立主要金鑰或唯一：若您想要在完整載入完成之前，對資料平台延遲主要金鑰或唯一索引建立，請選取此選項。

### 用於初始載入

資訊備註若您使用 資料移動閘道 存取資料來源，這些設定需要版本 2022.11.74 或更高版本。

| 使用快取的資料 | 此選項可讓您使用透過所選的完整資料掃描產生中繼資料時讀取的快取資料。<br><br>這會對 API 使用和配額產生較少的負荷，因為已從來源讀取資料。可以透過變更資料擷取 (CDC) 選取自初始資料掃描以來的任何變更。 |
| --- | --- |
| 從來源載入資料 | 此選項從資料來源執行新的載入。如有以下情況，此選項很實用：<br><br><ul> <li> <p>最近沒有執行中繼資料掃描。</p> </li> <li> <p>來源資料集很小且頻繁變更，且您不想維持完整的變更歷史記錄。</p> </li> </ul> |

## 處理時發生錯誤

### 資料錯誤

資訊備註

僅變更資料擷取 (CDC) 更新方法支援資料錯誤處理。

對於資料截斷錯誤：選取當截斷發生於一個或多個特定記錄時，您想要發生的事項。您可以從清單中選取下列內容之一：

* 忽略：任務會繼續並忽略錯誤。
* 暫停表格：任務會繼續，但具有錯誤記錄之表格中的資料會移至錯誤狀態，並且不會複寫其資料
* 停止任務：任務會停止，需要手動干預。

對於其他資料錯誤：選取當錯誤發生於一個或多個特定記錄時，您想要發生的事項。您可以從清單中選取下列內容之一：

* 忽略：任務會繼續並忽略錯誤。
* 暫停表格：任務會繼續，但具有錯誤記錄之表格中的資料會移至錯誤狀態，並且不會複寫其資料
* 停止任務：任務會停止，需要手動干預。

在達到其他資料錯誤 (每個表格) 時呈報錯誤處理：選取此核取方塊，以在非截斷資料錯誤數量 (每個表格) 達到指定量時呈報錯誤處理。有效值為 1-10,000。

呈報動作：選擇呈報錯誤處理時應發生什麼事。請注意，可用動作取決於從上述對於其他資料錯誤下拉式清單中選取的動作。

* 暫停表格 (預設)：任務會繼續，但具有錯誤記錄之表格中的資料會移至錯誤狀態，並且不會landed其資料。

* 停止任務：任務會停止，需要手動干預。

### 表格錯誤

遇到表格錯誤時：從下拉式清單選取下列內容之一：

* 暫停表格 (預設)：任務會繼續，但具有錯誤記錄之表格中的資料會移至錯誤狀態，並且不會複寫其資料
* 停止任務：任務會停止，需要手動干預。

在表格錯誤達到時呈報錯誤處理 (每個表格)：選取此核取方塊，以在表格錯誤數量 (每個表格) 達到指定量時呈報錯誤處理。有效值為 1-10,000。

呈報動作：表格錯誤的呈報政策設定為停止任務且無法變更。

### 環境

* 重試計數上限：選取此選項，然後指定在可修復的環境錯誤發生時重試任務的嘗試次數上限。在重試任務達到指定次數之後，任務會停止，需要手動干預。

  若絕對不要重試任務，清除核取方塊或指定「0」。

  若要重試任務無限次數，指定「-1」

  * 重試嘗試之間的間隔 (秒)：使用計數器以選取或輸入系統在每次嘗試重試任務之間等待的秒數。

    有效值為 0-2,000。

* 對長時間中斷增加重試間隔：選取此核取方塊以對長時間中斷增加重試間隔。若啟用此選項， 會加倍每次重試嘗試之間的間隔，直到達到重試間隔上限為止 (並根據指定的間隔上限繼續重試)。

  * 重試間隔上限 (秒)：在啟用對長時間中斷增加重試間隔選項時，使用計數器以選取或輸入每次嘗試重試任務之間等待的秒數。有效值為 0-2,000。

## 變更處理微調

資訊備註只有在更新方法為變更資料擷取 (CDC) 時，此索引標籤才能使用。

#### 交易卸載微調

對磁碟的卸載交易進行中，條件是：

通常會將交易資料保留在記憶體中，直到對來源或目標完全認可為止。不過，大於配置記憶體或未在指定期限內認可的交易將會卸載到磁碟。

* 所有交易記憶體總大小超過 (MB)：在卸載到磁碟之前，所有交易可以在記憶體中占用的大小上限。預設值為 1024。
* 交易期間超過 (秒)：在卸載到磁碟之前，每筆交易可以在記憶體中停留的時間上限。持續時間是從 Qlik Talend Data Integration 開始擷取交易的時間計算。預設值為 60。

#### 批次微調

此索引標籤中的某些設定

與 Qlik Cloud 除外的所有目標有關的設定：

* 以間隔套用批次變更：

  * 大於：每次應用程式批次變更之間等待的時間長度下限。預設值為 1。

    增加大於值會減少變更套用至目標的頻率，同時增加批次大小。若將變更套用至為處理大型批次而最佳化的目標資料庫，這可以改善效能。

  * 小於：每次應用程式批次變更之間等待的時間長度上限 (宣告逾時之前)。換言之，即可接受的延遲上限。預設值為 30。此值決定套用變更之前、達到大於值之後要等待的時間長度上限。

* 在處理記憶體超過時強制套用批次 (MB)：用於預先處理的記憶體量上限。預設值為 500 MB。

  如需最大批次大小，請將此值設定為您可以配置到資料任務的最高記憶體量。若將變更套用至為處理大型批次而最佳化的目標資料庫，這可以改善效能。

* 將批次變更同時套用至多個表格：從多個來源表格套用變更時，選取此選項應可改善效能。

  * 表格數量上限： 要同時套用批次變更的表格數量上限。預設為五。

  資訊備註使用 Google BigQuery 作為資料平台時，不支援此選項。

* 根據變更處理陳述式將套用的變更數量限制為：選取此選項，以限制單一變更處理陳述式中套用的變更數量。預設值為 10,000。

  資訊備註只有在使用 Google BigQuery 作為資料平台時，才會支援此選項。

僅與 Qlik Cloud 有關的設定：

* 每個交易的變更數量下限：要在每個交易中納入的變更數量下限。預設值為 1000。

  資訊備註

  若變更數量等於或大於每個交易的變更數量下限值，或者若達到套用之前的批次交易時間上限 (秒) 值 (以先發生者為主)， 會將變更套用至目標。因為套用至目標的變更頻率由這兩個參數控制，對來源記錄的變更可能不會立即反映在目標記錄中。

* 套用之前的批次交易時間上限 (秒)：宣告逾時之前批次收集交易的時間上限。預設值為 1。

### 間隔

* 讀取變更間隔 (分鐘)

  設定從來源讀取變更之間的間隔，單位為分鐘。有效範圍為 1 至 1440。

  資訊備註

  此選項僅適用於使用以下方式的任務：

  * SaaS 應用程式 [精簡版連接器](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/connecting-web-applications.htm#Lite)。
  * 資料移動閘道
  * 變更資料擷取 (CDC) 更新方法

#### 雜項微調

* 陳述式快取大小 (陳述式數量)：要儲存在伺服器以供之後執行的所準備之陳述式數量上限 (將變更套用至目標時)。預設為 50。上限為 200。

* 在更新主要金鑰欄時刪除和插入：此選項需要在來源資料庫中開啟完全補充記錄。

## 自動結構描述演進

選取如何處理結構描述中以下類型的 DDL 變更。變更結構描述演進設定後，您必須重新準備任務。下表描述了哪些動作可用於支援的 DDL 變更。

資訊備註這些設定不適用於使用 SaaS 應用程式連接器[精簡版連接器](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/connecting-web-applications.htm#Lite)的任務。當使用一般 SaaS 應用程式連接器時，僅支援變更欄資料類型。

| DDL 變更 | 套用至目標 | 忽略 | 暫停表格 | 停止任務 |
| --- | --- | --- | --- | --- |
| 新增欄 | 是 | 是 | 是 | 是 |
| 重新命名欄 | 否 | 否 | 是 | 是 |
| 重新命名表格 | 否 | 否 | 是 | 是 |
| 變更欄資料類型 | 否 | 是 | 是 | 是 |
| 建立表格<br><br>如果您使用選取規則新增與模式相符的資料集，則會偵測到並新增符合該模式的新表格。 | 是 | 是 | 否 | 否 |

## 字元替代

您可以替代或刪除目標資料庫中的來源字元，以及/或您可以替代或刪除所選字元集合不支援的來源字元。

資訊備註

* 必須指定所有字元作為 Unicode 字碼指標。

* 也會在控制表格執行字元替代。

* 將會透過表格儲存格右上方的紅色三角形指示無效的值。將滑鼠游標暫留在三角形上方，將會顯示錯誤訊息。

* 將會在字元替代完成之後，執行為任務定義的任何表格層級或全域轉換。

* 會在替代或刪除所選字元集合不支援的來源字元表格中定義的替代動作之前，執行替代或刪除來源字元表格中定義的替代動作。

* 字元替代不支援 LOB 資料類型。

### 替代或刪除來源字元

使用替代或刪除來源字元表格，以定義更換特定來源字元。例如，若 Unicode 字元表示法在來源和目標平台不同，這可能會很實用。例如，在 Linux，`Shift_JIS` 字元集合中的減號字元以 `U+2212` 表示，但在 Windows 則以 `U+FF0D` 表示。

替代動作

| 至 | 進行此 |
| --- | --- |
| 定義替代動作。 | <ol><li><p>按一下表格上方的<span>新增字元</span>按鈕。</p></li><li><p>分別在<span>來源字元</span>和<span>替代字元</span>欄位中指定來源字元和目標字元。</p><p>例如，若要以字母「e」取代字母「a」，請分別指定 <code>0061</code> 和 <code>0065 </code>。</p><div><span>資訊備註</span><p>若要刪除指定的來源字元，在<span>替代字元</span>欄中輸入 <code>0</code>。</p></div></li><li>重複步驟 1-2 以取代或刪除其他字元。</li></ol> |
| 編輯指定的來源或目標字元 | 按一下列末尾的 the 編輯 icon，並選取。 |
| 從表格中刪除項目 | 按一下列末尾的 the 刪除 icon，並選取。 |

### 替代或刪除所選字元集合不支援的來源字元

使用字元集合不支援的來源字元表格，為所選字元集合不支援的所有字元定義單一替換字元。

不支援的字元替代動作

| 至 | 進行此 |
| --- | --- |
| 定義或編輯替代動作。 | <ol><li><p>從表格中的<span>字元集合</span>下拉式清單選取字元集合。</p><p>將會透過以下步驟 2，在目標以指定的字元取代所選字元集合不支援的任何字元。</p></li><li><p>在<span>替代字元</span>欄中，按一下欄中的任何地方並指定替換字元。例如，若要以字母「a」取代所有不支援的字元，請輸入 <code>0061</code>。</p><div><span>資訊備註</span><p>若要刪除所有不支援的字元，請輸入 <code>0</code>。</p></div></li></ol> |
| 停用替代動作。 | 從字元集合下拉式清單中選取空白項目。 |

## 更多選項

不會在 UI 中暴露這些選項，因為這僅與特定版本或環境相關。因此，請勿設定這些選項，除非 Qlik 支援或產品文件明確指示這麼做。

若要設定選項，只要在新增特徵名稱欄位中複製選項並按一下新增即可。然後根據您收到的說明設定值或啟用選項。

## 平行載入資料集區段

資訊備註此設定不適用於 SaaS 應用程式來源，僅適用於來源資料庫和目標資料庫的特定子集。

在完整載入期間，您可以將資料集分成多個平行載入的區段，以加速大型資料集的載入。表格可以按照資料範圍、所有分割、所有子分割或特定分割進行分割。

如需詳細資訊，請參閱[平行登陸資料集區段](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/Table-settings-landing.htm)。

## 排程任務

在某些情況下，您可能需要排程您的任務，以傳播從資料來源到目標平台的變更。

如需詳細資訊，請參閱[Scheduling tasks](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Deploying/Scheduling-tasks.htm)。