데이터 파이프라인 내보내기 및 가져오기
데이터 파이프라인 프로젝트를 데이터 프로젝트를 재구성하는 데 필요한 모든 것이 포함된 파일로 내보낼 수 있습니다. 내보내기 파일은 동일한 테넌트 또는 다른 테넌트로 가져올 수 있습니다. 예를 들어 이를 사용하여 한 테넌트에서 다른 테넌트로 프로젝트를 이동하거나 프로젝트의 백업 복사본을 만들 수 있습니다. 내보내기 파일에서 프로젝트를 업데이트할 수도 있습니다.
내보내기 파일 형식이 단일 JSON 파일에서 여러 JSON 파일을 포함하는 ZIP 파일로 변경되었습니다. 2026년 2월 2일부터 기존 JSON 형식은 가져오기에 지원되지 않습니다.
기존 프로젝트를 내보내 새로운 형식을 이용합니다.
데이터 프로젝트 내보내기
프로젝트를 내보내려면 프로젝트가 있는 공간에서 다음 역할 중 하나 이상이 필요합니다.
-
편집 가능
-
보기 가능
-
운영 가능
프로젝트를 내보내려면 다음 중 하나를 수행합니다.
-
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으로 변경될 수 있습니다.