인수 참조

마지막 업데이트: 2026. 10. 14.

아래 표에는 사용 가능한 모든 인수들이 범주별로 그룹화되어 나열되어 있습니다.

입력 및 출력

일괄 모드

Qlik Cloud

인증

레이아웃 및 스타일링

고정 캔버스 및 동적 그리드 모드에 대한 자세한 내용은 변환 레이아웃 설정을(를) 참조하십시오.

전환 보고서

콘솔 보고서와 Excel 보고서는 CLI 모드 및 사용자 인터페이스에서 모두 기본적으로 활성화됩니다.

콘솔 및 로깅

QV2QS는 네 가지 콘솔 출력 모드를 지원합니다.

• 예쁜 — 색상, 애니메이션 스피너, 진행률 표시줄 및 테마가 적용된 패널을 포함한 서식이 풍부한 출력.Pretty 모드는 대화형 터미널 사용을 위한 기본값입니다.색상 지원 터미널이 필요합니다 (Windows 10 이상, PowerShell 5 이상 또는 Unix 계열 셸).
• 일반 — ANSI 이스케이프 코드가 없는 타임스탬프 텍스트 출력.각 줄은 경과 시간 스탬프와 단계 태그가 [MM:SS] [phase] message 형식으로 접두사로 붙습니다.헤더와 테이블은 ASCII 문자를 사용합니다.CI/CD 파이프라인, 로그 파일, 그리고 ANSI 형식을 지원하지 않는 터미널에 적합합니다.
• 무음 — 모든 표준 출력을 억제합니다.오류만 표시됩니다.콘솔 출력이 필요 없는 자동화된 배치 처리 및 스크립트 기반 워크플로에 적합합니다.
• UI — 타임스탬프나 ANSI 코드 없는 줄 단위 출력.사용자 인터페이스는 변환 하위 프로세스를 시작할 때 이 모드를 자동으로 설정합니다.형식은 내장된 로그 뷰어에 최적화되어 있습니다.터미널에서 --console ui을(를) 실행하면 읽을 수 있지만 서식이 지정되지 않은 출력이 생성됩니다. 직접 터미널에서 사용하려면 대신 --plain 또는 --console pretty을(를) 사용하세요.

--dark 및 --light 플래그는 색상 테마를 선택합니다.어두운 테마(기본값)는 짙은 남색의 Qlik에서 영감을 받은 팔레트를 사용합니다.밝은 테마는 밝은 회색 팔레트를 사용합니다.--surface 플래그는 각 출력 라인 뒤에 미묘한 배경 채우기를 활성화합니다.표면 채우기는 예쁜 모드에서 기본적으로 활성화됩니다.배경 채우기를 비활성화하려면 --noSurface을(를) 사용하세요.

단일 프로젝트 모드에서는 로그 파일이 기본적으로 %LOCALAPPDATA%\QV2QS\logs\에 기록됩니다.배치 모드에서 로그 파일은 출력 디렉터리의 logs/ 하위 폴더에 기록됩니다.위치를 --logDir으로 덮어씁니다.변환 문제 해결을 위한 자세한 진단 출력을 캡처하도록 --logLevel DEBUG을(를) 설정합니다.각 실행 전에 30일 이상 된 로그 파일을 삭제하려면 --cleanLogs을(를) 사용하세요.로그 파일 위치, 순환 및 형식에 대한 자세한 내용은 로깅 및 진단을(를) 참조하십시오.

스크립트 로드

기본적으로 QV2QS는 Qlik Cloud 호환성을 위해 Windows 백슬래시 경로를 슬래시 경로로 정규화하는 8가지 기본 제공 규칙을 적용합니다.다음 표에는 각 기본 제공 규칙이 나열되어 있습니다.

각 규칙은 2단계 매칭 프로세스를 사용합니다.pattern 필드는 로드 스크립트의 영역을 선택하는 정규식입니다.search 필드는 각 일치하는 영역 내에서만 적용됩니다.이 접근 방식은 의도하지 않은 교체가 대상 컨텍스트 외부에서 발생하는 것을 방지합니다.

--scriptReplacements 인수는 모든 교체 규칙에 대한 단일 정보원이 되는 JSON 파일을 허용합니다.파일이 제공되면 내장된 기본값은 자동으로 로드되지 않습니다.기본 제공 규칙을 사용자 지정 규칙과 함께 포함하려면, 마법사에서 전체 규칙 집합을 내보내기하고 내보낸 파일을 수정하십시오.규칙은 execution_order 순서로 실행됩니다.

세 가지 CLI 동작을 사용할 수 있습니다:

• 플래그 없음 — 여덟 가지 내장 규칙이 실행됩니다.
• --scriptReplacements <file> — 파일에 있는 규칙만 실행됩니다.내장 기본값은 자동으로 로드되지 않습니다.
• --noScriptReplacements — 규칙이 실행되지 않습니다.

--scriptReplacements 파일은 규칙 객체의 JSON 배열입니다.

[
  {
    "description": "Replace server path with lib connection",
    "pattern": "FROM\\s+'[^']*'",
    "search": "\\\\\\\\server\\\\share\\\\",
    "replace": "lib://DataFiles/",
    "is_regex": true,
    "case_sensitive": false,
    "enabled": true,
    "execution_order": 1
  }
]

각 규칙에는 다음 필드가 있습니다:

기타

날짜 필드 정렬 보호

기본적으로 Qlik Sense는 선택된 값을 목록 상자의 맨 위로 정렬합니다.분기, 월, 연도와 같은 날짜 형식 필드의 경우, 이 재정렬은 예상되는 시간 순서를 깨뜨립니다.QV2QS는 날짜와 유사한 필드 이름을 감지하고 해당 필드에 대한 상태 기반 정렬을 억제하기 위해 휴리스틱을 적용하여, 선택 상태에 관계없이 값을 자연 순서로 유지합니다.

휴리스틱은 영숫자가 아닌 문자와 카멜케이스 경계를 기준으로 각 필드 이름을 토큰화합니다(예를 들어, OrderDate는 order 및 date로 나뉩니다).모든 토큰은 소문자로 변환됩니다.어떤 토큰이든 다음 중 하나와 같으면 필드가 일치합니다: date, dates, month, months, year, years, quarter, quarters, qtr, qtrs, week, weeks, day, days, fiscal, fy, period, calendar.필드도 date, month 또는 year으로 끝나는 토큰이 있으면 일치합니다 (예를 들어, OrderDate, FiscalMonth).토큰 update, candidate, 그리고 validate은 오탐을 피하기 위해 제외됩니다.일치는 대소문자를 구분하지 않으며 영어 토큰만 사용합니다.영어가 아닌 필드 이름(예: Monat 또는 Fecha)은 감지되지 않습니다.

휴리스틱과 일치하는 필드는 상태 기반 정렬이 제거되고 자동 정렬이 비활성화됩니다.

--disableDateStateStickySort를 사용하여 이 휴리스틱을 끄십시오.비활성화되면, 모든 목록 상자 필드는 상태 기반 재정렬을 포함한 기본 Qlik Sense 정렬 동작을 사용합니다.

셋 분석 따옴표 처리 수정 사항

QlikView와 Qlik Sense는 세트 분석 한정자에서 인용 부호를 다르게 해석합니다.QV2QS는 변환 중에 두 가지 독립적인 수정 사항을 적용합니다.작은따옴표 검색 수정은 기본적으로 활성화되어 있습니다.인용되지 않은 설정 값 수정은 실험적이며 기본적으로 비활성화되어 있습니다.

작은따옴표로 묶인 검색 값 수정 (--fixSingleQuotedSearch)

검색 구문이 포함된 작은따옴표 값은 큰따옴표로 변환됩니다.감지된 검색 패턴에는 와일드카드(*, ?, ^), 비교 연산자(>, >=, <, <=), 퍼지 검색(~), 표현식 검색(=), 검색 수정자(+, -) 및 복합 검색((…|…), (…&…))이 포함됩니다:

• {<Year={'2*'}>}이(가) {<Year={"2*"}>}가 됩니다.
• {<Amount={'>100'}>}이(가) {<Amount={">100"}>}가 됩니다.
• {<Customer={'~company'}>}이(가) {<Customer={"~company"}>}가 됩니다.

작은따옴표로 묶인 일반 텍스트 리터럴(예를 들어, 'USA') 및 숫자 필드의 작은따옴표로 묶인 값은 영향을 받지 않습니다.--noFixSingleQuotedSearch을(를) 사용하여 이 수정을 비활성화합니다.

인용되지 않은 설정 값 수정 (--fixUnquotedSetValues) — 실험적

인용되지 않은 일반 문자열 값은 작은따옴표로 묶입니다:

• {<Country={USA}>}이(가) {<Country={'USA'}>}가 됩니다.

숫자 값(2024), 달러 기호 변수($(vYear)), 그리고 큰따옴표로 묶인 문자열은 변경되지 않습니다.이 수정 사항은 기본적으로 비활성화되어 있습니다.활성화하려면 --fixUnquotedSetValues를 전달하세요.--noFixUnquotedSetValues를 사용하여 명시적으로 비활성화합니다.

두 가지 수정 사항 모두 차원 및 측정값 표현식에만 적용됩니다.지원되지 않는 함수 발견 항목은 수정되지 않습니다.수정 사항이 비활성화되면, 플래그가 지정된 패턴은 표현식_발견_항목 워크시트에서 수동 검토를 위해 남아 있습니다.

자세히 알아보기

• 일반적인 워크플로
• 로깅 및 진단
• 레이아웃 모드