병렬 실행
마지막 업데이트: 2026. 10. 14.QV2QS는 구성 가능한 프로세스 풀을 사용하여 여러 프로젝트를 동시에 변환합니다.
워커 구성
기본적으로 QV2QS는 머신의 논리 CPU 코어 수를 기반으로 최적의 워커 수를 자동으로 감지합니다.기본 설정(--batchWorkers 0)은 코어 수보다 1개 적은 워커를 사용하여 오케스트레이터 프로세스와 운영 체제를 위해 코어 1개를 비워 둡니다.
명시적 개수로 재정의하려면 --batchWorkers N을(를) 전달하세요:
QV2QS.exe --batchDir "C:\Projects" --outputDir C:\Output --batchWorkers 4 --unbuildOnly
지정된 워커 수가 사용 가능한 CPU 코어 수를 초과하면 QV2QS에서 경고를 출력합니다.코어 수를 초과하여 워커를 추가할 때마다 실제 실행 시간 개선은 미미한 반면 약 80MB의 메모리 오버헤드가 추가됩니다.
로컬 변환 단계에서는 프로세스 풀을 사용합니다.각 워커는 별도의 프로세스에서 실행되므로, 변환을 구성하는 XML 파싱, 객체 그래프 순회 및 JSON 생성 과정에서 진정한 CPU 병렬 처리가 가능합니다.한 프로젝트가 실패하더라도 나머지 프로젝트는 계속 진행됩니다.각 워커 프로세스는 프로젝트 logs/ 하위 폴더에 별도의 로그 파일을 기록합니다.
클라우드 배포는 워커 수가 동일한 스레드 풀을 사용합니다.모든 로컬 변환이 완료되면 QV2QS는 변환된 앱을 Qlik Cloud에 병렬로 배포합니다.병렬 클라우드 배포 중에는 콘솔 출력이 간소화됩니다. — 출력이 깨지는 현상을 방지하기 위해 애니메이션 스피너가 정적 진행률 줄로 대체됩니다.
오류 처리
배치 모드는 실패가 발생해도 계속 진행됩니다.변환 중 한 프로젝트가 실패할 경우, QV2QS는 오류를 기록하고 나머지 프로젝트를 계속 진행합니다.실패한 프로젝트는 오류 설명과 함께 배치 요약에 표시됩니다.배치 종료 코드는 모든 프로젝트가 성공할 경우 0이고, 프로젝트가 하나라도 실패할 경우 1입니다.
오류 격리는 보고서 생성에도 적용됩니다.프로젝트가 성공적으로 변환되었지만 Excel 보고서 생성에 실패한 경우에도 해당 프로젝트는 여전히 성공한 것으로 간주됩니다.보고서 오류는 별도로 기록됩니다.
클라우드 배포 실패는 동일한 방식으로 격리됩니다.한 프로젝트의 배포에 실패하더라도 나머지 프로젝트는 계속 배포됩니다.