安裝 Qlik DataTransfer

Qlik DataTransfer 是輕量 Windows 應用程式，可讓您將資料從內部部署資料來源上傳至 Qlik Cloud 租用戶，不需要防火牆通道。 服務帳戶擁有者 (SAO) 或租用戶管理員可從租用戶產生 API 金鑰，然後用來驗證 Qlik DataTransfer。驗證後，即可排程自動資料載入或手動上傳資料。

Qlik DataTransfer 處理下列種類的資料來源：

• 應用程式資料
• 連線資料
• 資料夾

如需關於可用於 Qlik DataTransfer 的資料類型的資訊，請參閱 使用 Qlik DataTransfer 上傳內部部署資料。

Qlik DataTransfer 安裝只能關聯至單一 Qlik Cloud 租用戶。

Qlik DataTransfer 系統要求

開始之前

下載並執行 Qlik DataTransfer 安裝程式之前，請確認您符合下列要求：

• 您可以存取 Qlik Cloud 租用戶。
• 您是租用戶上具有 專業或完整使用者權限 的使用者。
• 您在租用戶上受指派開發人員角色。
• 您可以存取作為從 Qlik DataTransfer 上傳資料之目的地的所有空間。如需詳細資訊，請參閱管理空間。
• 您對於可存取內部部署資料來源的 Windows 機器，具有管理員權限。
• 您的 Windows 機器符合下列系統要求： Qlik DataTransfer 的系統要求 （僅提供英文版）。
• 已在 管理主控台 中啟用 API 金鑰。如需關於啟用 API 金鑰的資訊，請參閱 管理 API 金鑰。

• 政策 SSL 設定 必須設定為在您安裝 的機器上僅支援 IANA 格式的密碼。Qlik DataTransfer

  若您正在 Windows Server 2012 R2 安裝或升級至 Qlik DataTransfer May 2021 或更高版本，您必須更新 TLS Cipher Suite。隨附於 Windows Server 2012 R2 預設安全性政策的預設加密不受 Qlik DataTransfer May 2021 或更高版本的支援。下列加密套件必須存在：

  • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

  • TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256

  • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

  • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

  如需在系統中更新 TLS 加密套件的說明或要在 Qlik DataTransfer 環境中停用弱密碼，請參閱下列社群文章： https://community.qlik.com/t5/Knowledge/Adding-Cipher-Suite-for-Qlik-Data-Transfer-on-Windows-2012-R2/ta-p/1819406。

• Qlik DataTransfer 需要 Windows 使用者帳戶。建議您使用具有管理員權限的專用使用者帳戶以執行 Qlik DataTransfer 服務。如需安裝，若專用使用者是管理員，您可以用該使用者的身分登入以安裝 Qlik DataTransfer。若您的專用使用者不是本機管理員，您必須使用管理員帳戶以安裝 Qlik DataTransfer。

  若您在已安裝 Qlik Sense Enterprise on Windows 的 Windows 伺服器安裝或更新 Qlik DataTransfer，必須透過服務使用者在 Qlik Sense 安裝使用的 Qlik Sense安裝 Qlik DataTransfer。

• 安裝 Qlik DataTransfer 的使用者帳戶必須有權限可透過 RemoteSigned 執行政策執行 PowerShell 指令碼

• 若您在透過租用戶設定 Qlik DataTransfer 後變更帳戶的服務記錄，必須重新設定租用戶以及連線。然後，在 %ProgramData%/Qlik/DataTransfer/DataUpload/storage 中，刪除 token.json。重新啟動 Qlik DataTransfer 服務。

• 對於 February 2021 SR1，建議在獨立於 Qlik Sense Enterprise on Windows 或 QlikView Server 的伺服器上安裝 Qlik DataTransfer。若 Qlik DataTransfer 已安裝在 Qlik Sense Enterprise on Windows 伺服器或 QlikView Server，Qlik DataTransfer 會使用本機系統使用者帳戶來執行。若您變更服務使用者帳戶，將會停止 Qlik DataTransfer 或 Qlik Sense 服務發送器。

確認安裝使用者帳戶執行政策

安裝 Qlik DataTransfer 的使用者帳戶必須有權限可透過 RemoteSigned 執行政策執行 PowerShell 指令碼。若您沒有指派使用者帳戶權限的權限，請聯絡管理員以向安裝使用者帳戶提供這些權限。

請執行下列動作：

1. 在管理員模式下開啟 PowerShell。

2. 執行 Get-ExecutionPolicy。這應為 RemoteSigned。若為 Restricted 或 Disabled，請繼續下一步。

3. 執行 Set-ExecutionPolicy RemoteSigned。

4. 選取 Y。

下載並執行安裝程式

請執行下列動作：

1. 從以下任一位置下載 Qlik DataTransfer.exe 檔案：

   • 產品下載
     如需詳細資訊，請參閱下載安裝檔案。

   • Qlik Cloud
     按一下右上角的設定檔圖示，然後按一下設定檔設定。在其他之下，按一下工具。

     Qlik Sense Enterprise SaaS Government 備註此選項無法用於 Qlik Cloud 政府。

2. 執行安裝程式並接受 Qlik 使用者授權合約。預設安裝路徑為 %Program Files%\Qlik\DataTransfer。輸入服務認證時，使用者名稱的形式必須為 domain\username。

   資訊備註

   若您輸入的使用者名稱長度超過 20 個字元，這必須是使用者主體名稱 (UPN) 格式，而且必須包括完整網域名稱。例如 longusername@full.domain.name。

   資訊備註

   若您有 Qlik Sense Desktop 或另一個 Qlik 平台安裝在相同的伺服器上，則必須先關閉並停止 Qlik 服務，才能安裝 Qlik DataTransfer。

   

   安裝後，以下列順序重新啟動 Qlik 服務：

   1. Qlik Sense 服務發送器

   2. Qlik 記錄服務

   3. Qlik Sense Repository Service

   4. Qlik Sense Proxy Service

   5. Qlik Sense Engine Service

   6. Qlik Sense 排程器服務

   7. Qlik Sense 列印服務

3. 在服務認證視窗，對您想要用來執行 Qlik DataTransfer 服務的帳戶輸入使用者名稱和密碼。

4. 請查看設定 Qlik DataTransfer 以在 services.config 檔案中自訂其他設定。

安裝程式會建立桌面捷徑以啟動 Qlik DataTransfer 應用程式。

產生 API 金鑰

API 金鑰到期。預設到期時間可能不適用於您的商務需求。在產生 API 金鑰之前，請考慮在 管理主控台 設定中變更最大權杖期限。如需資訊，請參閱 啟用租用戶中的 API 金鑰。

請執行下列動作：

1. 登入 Qlik Cloud 租用戶。
2. 從雲端中心按一下右上角的設定檔圖示，然後按一下設定檔設定。
3. 選取 API 金鑰。

4. 選取產生新的金鑰。

   
5. 輸入 API 金鑰的名稱並選取到期於時間。

6. 按一下產生。

   

7. 按一下複製並關閉以將 API 複製到剪貼簿。

   資訊備註務必儲存 API 金鑰。 您需要此金鑰來驗證 Qlik DataTransfer。
   

   現在您有了 API 金鑰，您可以在 Qlik DataTransfer 和 Qlik Cloud 租用戶之間建立安全連線。API 金鑰用來在將資料上傳至租用戶時驗證 Qlik DataTransfer。由於 API 有到期時間，您需要在此金鑰到期時建立新的 API 金鑰並重新驗證 Qlik DataTransfer。若 API 金鑰到期，您不需要重新建立資料連線。

驗證 Qlik DataTransfer

請執行下列動作：

1. 開啟 Qlik DataTransfer。

   首次開啟 Qlik DataTransfer 時，會顯示設定 Qlik DataTransfer 驗證畫面。

   
2. 輸入連線的名稱。
3. 將 URL 輸入到 Qlik Cloud 租用戶。

4. 貼上您透過租用戶產生的 API 金鑰。

5. 按一下套用以驗證租用戶。

6. API 金鑰到期後，或是要針對另一個租用戶驗證 Qlik DataTransfer 時，按一下 以輸入新的 API 金鑰，然後按一下確認。

   

驗證 Qlik DataTransfer 後，可以將內部部署資料上傳至 Qlik Cloud 租用戶。如需如何使用 Qlik DataTransfer 的資訊，請參閱 使用 Qlik DataTransfer 上傳內部部署資料。

升級 Qlik DataTransfer

Qlik DataTransfer 會在有新版本可用時顯示通知橫幅。Qlik DataTransfer 不會自動升級至較新版本。

請執行下列動作：

1. 從應用程式內橫幅或從 產品下載 下載新版 Qlik DataTransfer。
2. 關閉目前版本的 Qlik DataTransfer。

3. 執行 Qlik DataTransfer 安裝程式。

   資訊備註

   若您在已安裝 Qlik Sense Enterprise on Windows 的 Windows 伺服器安裝或更新 Qlik DataTransfer，必須透過服務使用者在 Qlik Sense 安裝使用的 Qlik Sense 安裝 Qlik DataTransfer。

4. 按一下升級。

   

解除安裝 Qlik DataTransfer

請執行下列動作：

1. 執行 Qlik DataTransfer 安裝程式。

   資訊備註

   若您有 Qlik 平台安裝在相同的伺服器上，則必須先停止其他 Qlik 服務，才能解除安裝 Qlik DataTransfer。

2. 按一下解除安裝。

3. 解除安裝後，若適用，以下列順序重新啟動 Qlik 服務：

   1. Qlik Sense 服務發送器

   2. Qlik 記錄服務

   3. Qlik Sense Repository Service

   4. Qlik Sense Proxy Service

   5. Qlik Sense Engine Service

   6. Qlik Sense 排程器服務

   7. Qlik Sense 列印服務

限制

Qlik DataTransfer 具有下列限制：

• 從 October 2020 或更高版本升級時，儲存設定檔案的位置以及用於執行 Qlik DataTransfer 的連接埠會在設定檔案 Service.conf 中變更為預設。若您之前不是使用預設位置來儲存設定檔案或沒有使用預設連接埠來執行 Qlik DataTransfer，將會失去這些設定。若要保留您的設定，請先備份 Service.conf 再升級，升級完成後，從備份的檔案重做 Service.conf 中的設定。

• 若您之前不是使用預設位置來儲存 Service.conf 中的設定檔案，將需要手動刪除所選資料夾中的檔案。

• 若您使用 Proxy，您必須使用 Qlik Cloud 租用戶 URL 將 Qlik DataTransfer 的旁通新增至防火牆。若沒有旁通，Qlik DataTransfer 將無法連線至 Qlik Cloud。

• Qlik DataTransfer 應安裝在專用 Window Server，如 Qlik DataTransfer 系統要求 中規定。請勿安裝在實際資料來源伺服器或已安裝 Qlik 資料閘道 - 直接存取 的伺服器上。