데이터 파이프라인 내보내기 및 가져오기
데이터 파이프라인 프로젝트를 재구성하는 데 필요한 모든 것을 포함하는 파일로 내보낼 수 있습니다.내보낸 파일은 동일한 테넌트나 다른 테넌트로 가져올 수 있습니다.예를 들어, 이를 사용하여 한 테넌트에서 다른 테넌트로 프로젝트를 이동하거나 프로젝트의 백업 복사본을 만들 수 있습니다.내보낸 파일에서 프로젝트를 업데이트할 수도 있습니다.
내보내기 파일 형식이 여러 JSON 파일이 포함된 ZIP 파일에서 여러 YAML 파일이 포함된 ZIP 파일로 변경되었습니다.
JSON Zip 보관 파일은 <날짜, 2027>까지 레거시로 전환 기간 동안 지원됩니다.
새로운 형식을 이용하려면 최소 또는 전체 옵션을 사용하여 기존 프로젝트를 내보내십시오.
데이터 프로젝트 내보내기
프로젝트를 내보내려면 프로젝트가 있는 공간에 다음 역할 중 하나 이상이 필요합니다.
-
편집할 수 있음
-
볼 수 있음
-
작동할 수 있음
프로젝트를 내보내려면:
-
데이터 통합 > 파이프라인 프로젝트에서 프로젝트에서
을 클릭하고 내보내기를 선택합니다.
프로젝트를 열고 오른쪽 위에서
을 클릭한 다음 내보내기를 선택할 수도 있습니다.
-
내보내기 형식을 선택하세요:
-
최소화됨 (기본값) — 필수 및 수정된 설정만 내보냅니다.버전 관리 및 코드 우선 워크플로에 권장됩니다.
-
전체 — 기본값을 포함한 모든 설정을 내보냅니다.전체 구성을 확인하거나 문제 해결 시 사용합니다.
-
레거시 — 이전 JSON 형식으로 내보냅니다.이것은 YAML을 사용할 수 없는 시스템과의 통합에만 사용하십시오.
-
프로젝트는 프로젝트 이름, 데이터 플랫폼, 타임스탬프로 구성된 파일 이름을 가진 ZIP 파일로 내보내집니다.
프로젝트 가져오기
이 섹션에서는 프로젝트 가져오기에 대해 다룹니다.클라우드 데이터 웨어하우스 프로젝트 또는 Qlik Cloud(Amazon S3 사용) 프로젝트를 가져올 수 있습니다.
다음 제한 사항에 따라 사용할 데이터 플랫폼을 변경할 수 있습니다.
-
클라우드 데이터 웨어하우스에서 Qlik Cloud로 데이터 플랫폼을 변경하거나 그 반대로 변경하는 것은 불가능합니다.
-
클라우드 파일 저장소에 랜딩을 사용하여 Snowflake 프로젝트를 다른 데이터 플랫폼으로 변경하거나 그 반대로 변경하는 것은 불가능합니다.
프로젝트를 가져오기 전에
프로젝트를 가져오기 전에 다음 사항을 고려합니다.
-
새 테넌트 또는 공간으로 가져오는 경우 필요한 모든 새 연결을 만듭니다.
-
프로젝트가 아직 존재하지 않는 SaaS 응용 프로그램 연결을 사용하는 경우 가져오기를 시작하기 전에 연결을 만들고 메타데이터를 만들어야 합니다.
-
프로젝트 간 파이프라인을 가져오는 경우 먼저 업스트림 프로젝트를 가져와야 합니다.
클라우드 데이터 웨어하우스 프로젝트 가져오기
내보낸 클라우드 데이터 웨어하우스 프로젝트를 내보낸 것과 동일한 테넌트 또는 다른 테넌트로 가져올 수 있습니다.프로젝트가 원래 데이터 프로젝트의 테넌트가 아닌 다른 테넌트로 가져오는 경우 프로젝트, 스테이징 영역 및 모든 데이터 소스에 대한 새 연결을 정의해야 합니다.
프로젝트가 다른 프로젝트의 작업을 사용하는 경우 공간과 프로젝트의 이름이 동일하지 않으면 프로젝트와 작업을 매핑해야 합니다.
-
데이터 통합 > 파이프라인 프로젝트에서 새로 만들기를 클릭하고 프로젝트 가져오기를 선택합니다.
-
내보내기 파일을 추가합니다.대화 상자에 드롭하거나 찾아서 파일을 선택할 수 있습니다.
다음을 클릭합니다.
-
새 프로젝트에 대해 프로젝트 속성을 설정합니다.
공간에서 프로젝트를 추가할 공간을 선택해야 합니다.
데이터 플랫폼에서는 프로젝트의 데이터 플랫폼과 데이터 플랫폼에 대한 연결을 변경할 수 있습니다.
다른 테넌트에서 프로젝트를 가져온 경우 또는 이전 단계에서 데이터 플랫폼을 변경한 경우 연결을 변경해야 합니다.
스테이징 영역에 대한 연결을 변경할 수 있습니다.이는 다른 테넌트에서 프로젝트를 가져온 경우 또는 경우에 따라 이전 단계에서 데이터 플랫폼을 변경한 경우에 필요합니다.
다음을 클릭합니다.
-
새 프로젝트에 대해 기본 프로젝트 설정을 설정합니다.
모든 스키마에 대한 접두사에서 프로젝트에 만들어진 데이터 스키마에 접두사를 추가할 수 있습니다.이는 가져온 프로젝트가 내보낸 프로젝트와 동일한 클라우드 데이터 웨어하우스에 있는 경우 유용합니다.
데이터베이스 이름에 기본 이름을 설정할 수도 있습니다.Snowflake 프로젝트의 경우 기본 데이터웨어하우스 이름을 설정할 수 있으며, Databricks 프로젝트의 경우 기본 카탈로그 이름을 설정할 수 있습니다.모든 작업 유형에 프로젝트 기본 이름을 사용하거나, 각 작업 유형에 대해 이름을 기본값이나 사용자 지정 이름으로 설정할 수 있습니다.
다음을 클릭합니다.
-
연결 및 작업 설정을 설정합니다.
가져온 소스 연결 또는 프로젝트 간 소스를 동일한 커넥터를 사용하는 연결로 바꿀 수 있습니다. 예를 들어, 가져온 소스 연결이 MySQL인 경우 교체 연결도 MySQL이어야 합니다이는 다른 테넌트에서 프로젝트를 가져온 경우에 필요합니다.
작업 설정(선택 사항)에서 원래 프로젝트에서 재정의하려는 작업 설정을 변경할 수도 있습니다.
-
준비가 되면 가져오기를 클릭합니다.
프로젝트가 데이터 통합 홈에 추가되었습니다.
Qlik Cloud를 데이터 플랫폼으로 사용하여 프로젝트 가져오기
내보낸 Qlik Cloud(Amazon S3을 통해) 프로젝트를 내보낸 것과 동일한 테넌트 또는 다른 테넌트로 가져올 수 있습니다.프로젝트가 원래 데이터 프로젝트의 테넌트가 아닌 다른 테넌트로 가져오는 경우 프로젝트, 스테이징 영역 및 모든 데이터 소스에 대한 새 연결을 정의해야 합니다.
데이터 플랫폼을 Qlik Cloud에서 Snowflake와 같은 클라우드 데이터 웨어하우스로 변경하는 것은 불가능합니다.
-
데이터 통합 > 파이프라인 프로젝트에서 새로 만들기를 클릭하고 프로젝트 가져오기를 선택합니다.
-
내보내기 파일을 추가합니다.대화 상자에 드롭하거나 찾아서 파일을 선택할 수 있습니다.
다음을 클릭합니다.
-
이름
프로젝트 이름을 변경합니다.기본 이름은 Imported_라는 접두사가 붙은 원래 프로젝트 이름입니다.
-
공간
프로젝트를 추가할 공간을 선택합니다. -
설명
프로젝트 설명을 추가하거나 편집합니다. -
QVD 파일의 저장 위치:
QVD 파일을 생성할 위치를 선택합니다.
-
Qlik에서 관리하는 저장소
-
고객이 관리하는 저장소
사용자가 관리하는 Amazon S3 저장소.
-
-
데이터 연결
고객 관리 저장소를 선택한 경우 Amazon S3 저장소 영역에 대한 연결을 변경할 수 있습니다.
이는 다른 테넌트에서 프로젝트를 가져온 경우에 필요합니다.
-
스테이징 영역에 연결
Amazon S3 스테이징 영역에 대한 연결을 변경할 수 있습니다.
이는 다른 테넌트에서 프로젝트를 가져온 경우 또는 경우에 따라 이전 단계에서 데이터 플랫폼을 변경한 경우에 필요합니다.
-
다음을 클릭합니다.
-
원래 버전에 추가된 작업에 대한 연결 설정
가져온 소스 연결을 동일한 커넥터를 사용하는 연결로 교체할 수 있습니다. 예를 들어, 가져온 소스 연결이 MySQL인 경우 교체 연결도 MySQL이어야 합니다이는 다른 테넌트에서 프로젝트를 가져온 경우에 필요합니다.
-
작업 설정(선택 사항)에서 원래 프로젝트에서 재정의하려는 작업 설정을 변경할 수 있습니다.
-
준비가 되면 가져오기를 클릭합니다.
프로젝트가 데이터 통합 홈에 추가되었습니다.
프로젝트 업데이트
내보낸 파일에서 프로젝트를 업데이트할 수 있습니다.이렇게 하면 데이터 파이프라인의 모든 작업이 바뀌지만 연결 및 설정은 바뀌지 않습니다.가져온 프로젝트에 포함되지 않은 데이터 작업은 제거됩니다.
예를 들어, 개발 데이터 공간에서 내보낸 프로젝트를 프로덕션 데이터 공간의 프로젝트로 가져와 프로덕션 프로젝트를 업데이트할 수 있습니다.
프로젝트 업데이트를 시작하기 전에:
-
업데이트하기 전에 프로젝트를 백업하려면
를 클릭한 다음 내보내기를 클릭하여 내보냅니다.
-
프로젝트를 업데이트하기 전에 데이터 파이프라인에서 제거될 모든 작업을 중지해야 합니다.
-
프로젝트가 아직 존재하지 않는 SaaS 응용 프로그램 연결을 사용하는 경우 가져오기를 시작하기 전에 연결을 만들고 메타데이터를 만들어야 합니다.
-
가져온 프로젝트가 Snowflake와 같은 동일한 클라우드 데이터 플랫폼을 사용하는지 확인합니다.
프로젝트를 업데이트하려면:
-
업데이트하려는 프로젝트를 엽니다.
-
을 클릭한 다음 가져오기를 클릭합니다.
-
가져오려는 파일을 선택하거나 놓습니다.
-
프로젝트와 가져온 프로젝트 간에 서로 다른 매핑 연결에 대해 필요한 변경을 수행합니다.
예를 들어, 가져온 프로젝트는 SQL1이라는 소스 연결을 사용하는 반면 이 프로젝트는 SQL2라는 유사한 연결을 사용할 수 있습니다.이 경우, 가져온 연결을 원래 버전에 추가된 작업에 대한 연결 설정의 SQL2에 매핑합니다.
정보 메모매핑할 연결을 선택할 때 새 데이터베이스 연결을 만들 수 있지만 SaaS 응용 프로그램 연결은 만들 수 없습니다.준비가 되면 가져오기를 클릭합니다.
이제 프로젝트가 가져온 파일에 따라 업데이트되었습니다.가져오기를 통해 업데이트된 데이터 작업의 유효성을 검사하고 동기화해야 할 수 있습니다.
모범 사례
프로젝트를 가져오고 내보낼 때 몇 가지 일반적인 모범 사례가 있습니다.
-
동일한 데이터 세트를 두 프로젝트에 추가하고 한 프로젝트를 다른 프로젝트로 가져오는 것을 피하십시오.이렇게 하면 해결하기 어려운 충돌이 발생하고 데이터 세트가 다시 생성될 수 있습니다.
정보 메모데이터 세트가 작업에 추가되면 내부 식별자를 얻습니다.내부 식별자는 파이프라인에서 원활한 이름 변경 및 기타 메타데이터 작업을 허용하는 데 사용됩니다.별도의 프로젝트 또는 브랜치에서 동일한 데이터셋을 생성할 때, 내부 식별자가 달라져 한 프로젝트를 다른 프로젝트로 가져올 때 충돌이 발생합니다.이로 인해 준비 프로세스가 이름이 같더라도 데이터 집합을 삭제하고 다시 생성할 수 있습니다.
제한 사항
-
파이프라인을 내보낼 때 알림은 포함되지 않습니다.가져온 파이프라인에 새로운 알림을 설정해야 합니다.
-
저장된 SQL 워크벤치 스크립트는 프로젝트를 내보낼 때 포함되지 않습니다.
프로젝트를 새 프로젝트로 가져오면 저장된 SQL 워크벤치 스크립트가 비어 있습니다.
기존 프로젝트를 업데이트하기 위해 가져오는 경우, 기존에 저장된 SQL 워크벤치 스크립트는 변경되지 않습니다.
-
가져오기용 zip 파일에는 프로젝트 파일이 중첩된 하위 폴더가 아닌 직접 포함되어 있어야 합니다.
macOS에서 zip 파일을 생성할 때 폴더를 클릭하고 압축을 선택하면 zip 파일에 파일을 포함하는 중첩된 하위 폴더가 포함되어 zip 파일을 가져올 수 없습니다.
-
다음 시나리오는 해결하기 어려운 충돌을 생성할 수 있습니다:
-
두 프로젝트에서 동일한 데이터세트를 변경합니다.
-
프로젝트 1을 내보냅니다.
-
프로젝트 1을 프로젝트 2로 가져옵니다.
-
-
프로젝트 간에 루프나 상호 종속성을 만드는 파이프라인을 설계하지 마십시오.이러한 프로젝트의 내보내기 및 가져오기는 지원되지 않습니다.
-
등록된 데이터 및 스토리지 태스크가 있는 이전 프로젝트(JSON 지원이 도입되기 전)를 가져올 때, 소스의 JSON 필드는 BLOB에 맵되었습니다.등록된 데이터에는 예를 들어 Snowflake의 Variant와 같이 기본 유형이 여전히 유지되었습니다.JSON 지원이 추가된 후 가져올 때, 논리적 유형이 JSON으로 변경될 수 있습니다.