跳到主要內容

安裝 Qlik DataTransfer

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

備註: Qlik DataTransfer 支援加密通訊,但不符合 FIPS (聯邦資訊處理標準)。Qlik Sense Enterprise SaaS - Government (US) 使用者可以在實施暫停自己的風險檢閱時使用。

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

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

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

Qlik DataTransfer 安裝只能關聯至單一 SaaS editions of Qlik Sense 租用戶。

開始之前

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

  • 您可以存取 SaaS editions of Qlik Sense 租用戶。
  • 您是租用戶上受指派的開發人員角色。
  • 您可以存取作為從 Qlik DataTransfer 上傳資料之目的地的所有空間。如需詳細資訊,請參閱管理空間
  • 您對於可存取內部部署資料來源的 Windows 機器,具有管理員權限。
  • 您的 Windows 機器符合下列系統要求: Qlik DataTransfer 的系統要求 (僅提供英文版)
  • 已在 Management Console 中啟用 API 金鑰。如需關於啟用 API 金鑰的資訊,請參閱 管理 API 金鑰
  • 政策 SSL 設定 必須設定為在您安裝 Qlik DataTransfer 的機器上僅支援 IANA 格式的密碼。

    若您正在 Windows Server 2012 R2 安裝或升級至 Qlik DataTransfer May 2021 或更高版本,您必須更新 TLS Cipher Suite。隨附於 Windows Server 2021 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 WindowsQlikView Server 的伺服器上安裝 Qlik DataTransfer。若 Qlik DataTransfer 已安裝在 Qlik Sense Enterprise on Windows 伺服器或 QlikView ServerQlik DataTransfer 會使用本機系統使用者帳戶來執行。若您變更服務使用者帳戶,將會停止 Qlik DataTransferQlik Sense Service Dispatcher

提示: Qlik DataTransfer 安裝程式包括 Qlik associative engine 的執行個體、Simba ODBC 連接器和 Qlik DataTransfer 代理程式。啟動後,若您的伺服器與其他應用程式共用資源,則必須考量這會取用額外的記憶體和處理資源。對於生產環境,我們建議您在其伺服器安裝 Qlik DataTransfer

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

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

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

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

  3. 執行 Set-ExecutionPolicy RemoteSigned

  4. 選取 Y

下載並執行安裝程式

備註:

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

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

    1. Qlik 下載網站。

    2. 雲端中心。按一下右上角的設定檔圖示,然後按一下設定檔設定。此選項無法用於 Qlik Sense Enterprise SaaS - Government (US)

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

    備註:

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

    備註:

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

    Qlik dataTransfer installer screen

    安裝後,以下列順序重新啟動 Qlik 服務:

    1. Qlik Sense Service Dispatcher

    2. Qlik Logging Service

    3. Qlik Sense Repository Service

    4. Qlik Sense Proxy Service

    5. Qlik Sense Engine Service

    6. Qlik Sense Scheduler Service

    7. Qlik Sense Printing Service

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

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

連接埠

Qlik DataTransfer uses the following ports:

Service Port Direction

Secure web browser communication (HTTPS)

備註: You must open this port in your firewall.
443 Outbound
Data Upload service 5505 Internal
Engine service 5506 Internal
Connector Registry proxy 5507 Internal

若您與其中一個預設服務連接埠有連接埠衝突,可以在位於 %Program Files%\\DataTransferservices.conf 檔案中變更。

[globals] LogPath="${ALLUSERSPROFILE}\Qlik\DataTransfer\Log" StoragePath="${ALLUSERSPROFILE}\Qlik\DataTransfer" DataUploadServicePort=5505 EnginePort=5506 ConnectorRegistryPort=5507

記錄和資料檔案儲存

Qlik DataTransfer 記錄檔位於此處: %ProgramData%\Qlik\DataTransfer\Log

Qlik DataTransfer 資料連線位於此處: %ProgramData%\Qlik\DataTransfer\DataUpload

您可以在位於 %Program Files%\\DataTransferservices.conf 檔案中變更預設儲存路徑。

[globals] LogPath="${ALLUSERSPROFILE}\Qlik\DataTransfer\Log" StoragePath="${ALLUSERSPROFILE}\Qlik\DataTransfer" DataUploadServicePort=5505 EnginePort=5506 ConnectorRegistryPort=5507
備註: 建議您將儲存資料夾中的檔案備份至安全位置。

產生 API 金鑰

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

請執行下列動作:

  1. 登入 SaaS editions of Qlik Sense 租用戶。
  2. 從雲端中心按一下右上角的設定檔圖示,然後按一下設定檔設定
  3. 選取 API 金鑰
  4. 選取產生新的金鑰

    Cloud hub settings menu, generate API key
  5. 輸入 API 金鑰的名稱並選取到期於時間。
  6. 按一下產生

    Generate new API key screen

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

    備註: 務必儲存 API 金鑰。 您需要此金鑰來驗證 Qlik DataTransfer
    API key summary screen

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

驗證 Qlik DataTransfer

請執行下列動作:

  1. 開啟 Qlik DataTransfer

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

    Qlik dataTransfer API key connection screen
  2. 輸入連線的名稱。
  3. 將 URL  輸入到 SaaS editions of Qlik Sense 租用戶。
  4. 貼上您透過租用戶產生的 API 金鑰。

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

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

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

備註: 若您在透過租用戶設定 Qlik DataTransfer 後變更帳戶的服務記錄,必須重新設定租用戶以及對於 ODBC 資料來源的連線。

升級 Qlik DataTransfer

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

警告:

若您選擇不同的位置儲存設定檔案或選擇不同的連接埠以從設定檔案 Service.conf 執行 Qlik DataTransfer,升級將會對此覆寫。完成升級後,請先備份 Service.conf 檔案,再升級和複製到預設設定資料夾,以保留您的設定。

Qlik DataTransfer 正在使用本機系統帳戶,將不會提示您處理服務使用者認證並且會繼續使用本機系統。

Qlik DataTransfer upgrade banner

請執行下列動作:

  1. 從應用程式內橫幅或從 Qlik 下載網站下載新版 Qlik DataTransfer
  2. 關閉目前版本的 Qlik DataTransfer
  3. 執行 Qlik DataTransfer 安裝程式。

    備註:

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

  4. 按一下升級

    Upgrade QlikDataTransfer window

解除安裝 Qlik DataTransfer

備註: 解除安裝 Qlik DataTransfer 時,安裝程式會移除所有 Qlik DataTransfer 檔案和資料夾。您應將您要保留的任何檔案或資料夾儲存至新的位置。

請執行下列動作:

  1. 執行 Qlik DataTransfer 安裝程式。

    備註:

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

  2. 按一下解除安裝
  3. 解除安裝後,若適用,以下列順序重新啟動 Qlik 服務:

    1. Qlik Sense Service Dispatcher

    2. Qlik Logging Service

    3. Qlik Sense Repository Service

    4. Qlik Sense Proxy Service

    5. Qlik Sense Engine Service

    6. Qlik Sense Scheduler Service

    7. Qlik Sense Printing Service

限制

Qlik DataTransfer 具有下列限制:

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

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