데이터 및 다시 로드
마지막 업데이트: 2026. 10. 14.QV2QS는 QlikView UI를 변환하며, Auto-binary 옵션을 사용하여 변환된 앱에 데이터를 자동으로 로드할 수 있습니다.마법사 또는 명령줄에서 Reload 및 Auto-binary를 활성화하면 QV2QS가 데이터 전송을 자동으로 처리합니다.Auto-binary를 사용하지 않는 경우, 데이터를 채우기 위해 변환된 앱을 별도로 다시 로드해야 합니다.
QV2QS는 QlikView UI 메타데이터(PRJ XML)를 Qlik Sense JSON으로 변환하고 Qlik Cloud 테넌트에 직접 앱을 빌드합니다.변환 프로세스는 시트 레이아웃, 시각화 개체, 표현식 및 스타일링을 처리합니다.다시 로드하지 않으면 빌드 단계가 완료된 후 결과로 생성된 Qlik Sense 앱에 데이터가 포함되지 않습니다.
변환된 앱에 데이터를 채우려면 앱을 다시 로드해야 합니다.여기에는 세 가지 접근 방법이 있습니다:
- 자동 이진 로드 — QV2QS는 원본 QVW 파일을 Qlik Cloud에 업로드하고 빌드 중에
Binary문을 사용하여 데이터를 로드합니다.이 접근 방식은 변환 직후 데이터가 포함된 작동하는 앱을 확인하는 가장 빠른 방법입니다.자세한 내용은 아래의 자동 이진 로드를 참조하십시오. - 수동 다시 로드 — Qlik Cloud에 데이터 연결이 이미 생성되어 있고 QVD 파일 또는 데이터 소스에 액세스할 수 있는 경우 로드 스크립트를 조정한 후 앱을 다시 로드할 수 있습니다.QV2QS는 기본적인 로드 스크립트 경로 정규화를 적용하지만, 연결 이름과 데이터 소스 경로는 수동 업데이트가 필요할 수 있습니다.
- 트리거된 다시 로드 — 배포의 일부로 다시 로드를 트리거하려면
--reload플래그를 사용합니다.다시 로드는 로드 스크립트를 있는 그대로 실행합니다.로드 스크립트에서 참조된 데이터 연결 및 데이터 소스가 Qlik Cloud 환경에서 이미 사용 가능한 경우에만 다시 로드가 성공합니다.
두 개의 플래그가 서로 다른 단계에서 데이터를 제어합니다.--noData 플래그는 빌드 단계에서 데이터를 건너뛰므로 다시 로드되기를 기다리지 않고 앱 구조를 테스트할 수 있습니다.--exportQvfNoData 플래그는 빌드가 완료된 후 데이터 없이 QVF를 내보내 공유하기에 더 작은 파일을 생성합니다.플래그는 독립적으로 또는 함께 사용할 수 있습니다.
자동 이진 로드
자동 이진 로드는 원본 QVW 파일을 Qlik Cloud에 업로드하고, Binary 문을 사용하여 변환된 앱에 데이터를 로드한 다음 업로드된 파일을 제거합니다.변환된 앱은 수동 데이터 연결 구성 없이 QlikView 원본과 동일한 데이터를 수신합니다.
자동 이진 로드를 사용하도록 설정하려면 명령줄에서 --autoBinary을(를) 사용하거나 사용자 인터페이스에서 Auto-binary를 사용하도록 설정하십시오.
자동 이진 로드가 활성화된 경우 QV2QS는 다음 단계를 수행합니다:
- QVW 파일을 Qlik Cloud에 임시 앱으로 업로드합니다.
- 변환된 앱 로드 스크립트 앞에
Binary [<appId>];문과Exit Script;문을 추가합니다. - 업로드된 QVW에서 데이터를 로드하는 앱을 빌드합니다(
--reload이(가) 지정된 경우 다시 로드). - Qlik Cloud에서 임시 업로드된 앱 삭제.
- Qlik Cloud 앱에서 원래 로드 스크립트를 복원하고 Binary 및 Exit Script 문을 제거합니다.
정리 후 Qlik Cloud 앱에는 로드된 데이터가 포함되지만 로드 스크립트는 더 이상 임시 앱을 참조하지 않습니다.
업로드 단계에는 Qlik Cloud 파일 크기 제한이 적용됩니다.대용량 QVW 파일은 테넌트 구독 계층의 업로드 제한을 초과할 수 있습니다.업로드가 실패하면 대용량 앱 지원이 활성화된 공간에 앱을 배포하거나, --binaryAppId 인수를 사용하여 이미 Qlik Cloud에 있는 기존 앱을 참조하십시오.테넌트 리소스 제한에 대한 자세한 내용은 Qlik Cloud 리소스 제한을 참조하십시오.
실패 시 정리
QVW 파일이 업로드된 후 빌드 또는 다시 로드 단계가 실패하면 QV2QS는 종료하기 전에 자동으로 정리를 시도합니다.정리 작업에는 Qlik Cloud에서 임시로 업로드된 앱을 삭제하고 로컬 및 Cloud 앱 모두에서 원본 로드 스크립트를 복원하는 작업이 포함됩니다.
정리 자체가 실패하는 경우(예: 네트워크 중단으로 인해) 임시 앱이 Qlik Cloud 테넌트에 남아 있을 수 있습니다.고아 임시 앱의 이름은 QV2QS_Binary_YYYYMMDD_HHMMSS(예: QV2QS_Binary_20260219_143025)입니다.대상 공간에서 이 패턴과 일치하는 앱을 확인하고 수동으로 삭제하십시오.빌드 디렉터리의 로컬 script.qvs 파일에는 임시 Binary 문이 포함되어 있을 수도 있습니다.이를 다시 생성하려면 변환을 다시 실행하십시오.
자동 이진 로드에는 --reload 플래그와 --qvw 경로가 필요합니다.두 요구 사항 중 하나라도 누락된 경우 QV2QS는 명령을 거부하고 종료 코드 1로 종료합니다.
로컬 컴퓨터의 원본 QVW 파일은 절대 수정되거나 삭제되지 않습니다.데이터 로드가 완료된 후 Qlik Cloud의 임시 복사본만 제거됩니다.
Section Access를 사용하는 앱에서는 자동 이진 로드가 지원되지 않습니다.Qlik Cloud 다시 로드 엔진이 소스 QVW 파일의 Section Access 테이블에 대해 인증할 수 없습니다.QV2QS가 소스 앱에서 Section Access를 감지하면 바이너리 업로드 및 다시 로드 단계를 건너뛰고 경고가 기록됩니다.앱은 데이터 없이 배포됩니다.데이터를 로드하려면 Qlik Cloud 데이터 연결을 생성하고 로드 스크립트를 수동으로 업데이트하거나, 원본 QVW 복사본에서 Section Access를 제거하고 --autoBinary(으)로 다시 실행하십시오.
--preserveTargetAppScript이(가) --reload와(과) 결합된 경우, 다시 로드는 변환된 스크립트가 아닌 대상 앱의 기존 로드 스크립트를 실행합니다.이는 대상 앱에 이미 작동하는 Qlik Cloud 데이터 연결이 있고 UI 레이어만 업데이트해야 할 때 유용합니다.자세한 내용은 기존 앱 재사용을 참조하세요.