匯出和匯入資料管道
您可以將資料管道專案匯出至包含重建資料專案所需一切內容的檔案。匯出檔案可以匯入至同一個租用戶,或另一個租用戶。例如,您可以使用此功能將專案從一個租用戶移動到另一個租用戶,或建立專案的備份複本。您也可以從匯出檔案更新專案。
匯出檔案格式已從單一 JSON 檔案變更為包含多個 JSON 檔案的 ZIP 檔案。舊版 JSON 格式從 2026 年 2 月 2 日起不再支援匯入。
匯出您現有的專案以使用新格式。
匯出資料專案
您在專案所在的空間中需要至少具備下列其中一個角色才能匯出專案:
-
可編輯
-
可檢視
-
可操作
若要匯出專案,請執行下列其中一項操作:
-
在 Data Integration > 管道專案中,按一下要匯出的專案上的
,然後選取 匯出。
-
開啟專案,按一下右上角的
,然後選取 匯出。
專案會匯出為 ZIP 檔案,其檔案名稱由專案名稱、資料平台和時間戳記組成。
匯入專案
本區段涵蓋匯入專案。您可以匯入雲端資料倉庫專案或 Qlik Cloud (透過 Amazon S3) 專案。
您可以變更要使用的資料平台,但有下列限制:
-
無法將資料平台從雲端資料倉庫變更為 Qlik Cloud,反之亦然。
-
無法將使用登陸至雲端檔案儲存的 Snowflake 專案變更為另一個資料平台,反之亦然。
匯入專案之前
在開始匯入專案之前,請考慮:
-
如果您要匯入至新的租用戶或空間,請建立您將需要的所有新連線。
-
如果專案使用尚不存在的 SaaS 應用程式連線,您必須在開始匯入之前建立連線並產生中繼資料。
-
如果您要匯入跨專案管道,則必須先匯入上游專案。
匯入雲端資料倉庫專案
您可以將匯出的雲端資料倉庫專案匯入至匯出該專案的同一個租用戶,或另一個租用戶。當專案匯入至原始資料專案的租用戶以外的租用戶時,您需要為專案、預備區域和所有資料來源定義新連線。
如果專案使用來自其他專案的工作,您必須對應專案和工作,除非空間和專案的名稱完全相同。
-
在 Data Integration > 管道專案中,按一下 建立新項目,然後選取 匯入專案。
-
新增匯出檔案。您可以將其拖放至對話方塊上,或瀏覽以選取檔案。
按一下 下一步。
-
設定新專案的 專案屬性。
您必須在 空間中選取要將專案新增至哪個空間。
在 資料平台中,您可以變更專案的資料平台,以及與資料平台的連線。
如果您從另一個租用戶匯入專案,或者如果您在上一個步驟中變更了資料平台,則必須變更 連線。
您可以變更與預備區域的連線。如果您從另一個租用戶匯入專案,或者在某些情況下如果您在上一個步驟中變更了資料平台,則必須執行此操作。
按一下 下一步。
-
設定新專案的 預設專案設定。
您可以在 所有結構描述的字首中,為專案中建立的資料結構描述新增字首。當匯入的專案與匯出的專案位於同一個雲端資料倉庫時,這非常有用。
您也可以在 資料庫名稱中設定預設名稱。對於 Snowflake 專案,您可以設定預設的 資料倉庫名稱,對於 Databricks 專案,您可以設定預設的 目錄名稱。您可以將專案預設名稱用於所有工作類型,或為每種工作類型將名稱設定為預設或自訂名稱。
按一下 下一步。
-
設定 連線和工作設定。
您可以取代匯入的來源連線或跨專案來源,並使用採用相同連接器的連線。例如,如果匯入的來源連線是 MySQL,則取代連線也必須是 MySQL。如果您從另一個租用戶匯入專案,則必須執行此操作。
在 工作設定 (選用) 中,您也可以變更想要在原始專案中覆寫的工作設定。
-
準備就緒後,按一下 匯入。
專案會新增至 資料整合 首頁。
匯入以 Qlik Cloud 作為資料平台的專案
您可以將匯出的 Qlik Cloud (透過 Amazon S3) 專案匯入至匯出該專案的同一個租用戶,或另一個租用戶。當專案匯入至原始資料專案的租用戶以外的租用戶時,您需要為專案、預備區域和所有資料來源定義新連線。
無法將資料平台從 Qlik Cloud 變更為雲端資料倉庫,例如 Snowflake。
-
在 Data Integration > 管道專案中,按一下 建立新項目,然後選取 匯入專案。
-
新增匯出檔案。您可以將其拖放至對話方塊上,或瀏覽以選取檔案。
按一下 下一步。
-
名稱
變更專案的名稱。預設名稱是原始專案名稱加上字首 Imported_。
-
空間
選取要將專案新增至哪個空間。 -
描述
新增或編輯專案的描述。 -
將 QVD 檔案儲存在:
選取產生 QVD 檔案的位置。
-
Qlik 受管儲存空間
-
客戶受管儲存空間
由您管理的 Amazon S3 儲存空間。
-
-
資料連線
如果您選取了 客戶受管儲存空間,您可以變更與 Amazon S3 儲存區域的連線。
如果您從另一個租用戶匯入專案,則必須執行此操作。
-
與預備區域的連線
您可以變更與 Amazon S3 預備區域的連線。
如果您從另一個租用戶匯入專案,或者在某些情況下如果您在上一個步驟中變更了資料平台,則必須執行此操作。
-
按一下 下一步。
-
為原始版本中新增的工作設定連線
您可以取代匯入的來源連線,並使用採用相同連接器的連線。例如,如果匯入的來源連線是 MySQL,則取代連線也必須是 MySQL。如果您從另一個租用戶匯入專案,則必須執行此操作。
-
在 工作設定 (選用) 中,您可以變更想要在原始專案中覆寫的工作設定。
-
準備就緒後,按一下 匯入。
專案會新增至 資料整合 首頁。
更新專案
您可以從匯出檔案更新專案。這將取代資料管道中的所有工作,但不會取代連線和設定。未包含在匯入專案中的資料工作將被移除。
例如,您可以將從開發資料空間匯出的專案匯入至生產資料空間中的專案,以更新生產專案。
在開始更新專案之前:
-
如果您想要在更新之前備份專案,請按一下
,然後按一下 匯出 來將其匯出。
-
在更新專案之前,您必須停止將從資料管道中移除的所有工作。
-
如果專案使用尚不存在的 SaaS 應用程式連線,您必須在開始匯入之前建立連線並產生中繼資料。
-
請確定匯入的專案使用相同的雲端資料平台,例如 Snowflake。
若要更新專案:
-
開啟您想要更新的專案。
-
按一下
,然後按一下 匯入。
-
選取或拖放您想要匯入的檔案。
-
針對專案和匯入專案之間不同的對應連線,進行任何必要的變更。
例如,匯入的專案可能使用名為 SQL1 的來源連線,而此專案使用名為 SQL2 的類似連線。在這種情況下,請在 為原始版本中新增的工作設定連線 中,將匯入的連線對應至 SQL2。
資訊備註選取要對應的連線時,您可以建立新的資料庫連線,但不能建立 SaaS 應用程式連線。準備就緒後,按一下 匯入。
專案現在已根據匯入的檔案進行更新。您可能需要驗證並同步透過匯入更新的資料工作。
最佳實務
以下是匯入和匯出專案時的一些一般最佳實務。
-
避免將相同的資料集新增至兩個專案,並將一個專案匯入至另一個專案。這可能會產生難以解決的衝突,並可能導致重新建立資料集:
資訊備註將資料集新增至工作時,它會取得一個內部識別碼。內部識別碼用於允許在管道中進行無縫重新命名和其他中繼資料操作。在個別專案或分支中建立相同的資料集時,內部識別碼將會不同,從而在將一個專案匯入至另一個專案時導致衝突。這可能會導致準備程序捨棄並重新建立資料集,即使它具有相同的名稱。
限制
-
匯出管道時不包含通知。您需要在匯入的管道中設定新通知。
-
匯出專案時不包含已儲存的 SQL 工作台指令碼。
如果您將專案匯入為新專案,已儲存的 SQL 工作台指令碼將為空。
如果您匯入以更新現有專案,現有已儲存的 SQL 工作台指令碼不會變更。
-
用於匯入的 zip 檔案必須直接包含專案檔案,而不是在巢狀子資料夾中。
在 mac OS 中建立 zip 檔案時,如果您按一下資料夾並選擇將其壓縮,zip 檔案將包含一個包含檔案的巢狀子資料夾,這表示無法匯入該 zip 檔案。
-
下列情境可能會產生難以解決的衝突:
-
在兩個專案中對相同的資料集進行變更。
-
匯出專案 1。
-
將專案 1 匯入至專案 2。
-
-
請勿設計會在專案之間建立迴圈或相互相依性的管道。不支援匯出和匯入此類專案。
-
匯入具有已註冊資料和儲存工作的較舊專案 (在引入 JSON 支援之前) 時,來源上的 JSON 欄位會對應至 BLOB。原生類型仍保留在已註冊資料上,例如 Snowflake 上的 Variant。在新增 JSON 支援後匯入時,邏輯類型可能會變更為 JSON。