# 데이터 로드 스크립트 디버그

데이터 로드 편집기에서 디버깅 유틸리티를 사용하면 중단점을 통해 스크립트의 실행을 단계별로 진행할 수 있으며, 이를 통해 스크립트 실행의 변수 값과 출력을 조사할 수 있습니다.

출력, 변수 및 중단점 중 일부 또는 모두 볼 것인지 선택할 수 있습니다.

디버그 패널을 보려면 다음을 수행합니다.

* 데이터 로드 편집기 도구 모음에서 the 디버그 icon 를 클릭합니다.

  디버그 패널은 데이터 로드 편집기 하단에 열립니다.

정보 메모디버그 모드에서 실행하는 동안에는 연결 만들기, 연결 편집, 데이터 선택, 스크립트 저장 또는 데이터 로드를 수행할 수 없습니다. 디버그 모드는 디버그 실행과 함께 시작되며 스크립트가 실행되거나 실행이 종료될 때까지 지속됩니다.

## 디버그 도구 모음

데이터 로드 편집기 디버그 패널에는 디버그 실행을 제어하는 다음과 같은 옵션이 포함된 도구 모음이 있습니다.

디버그 도구 모음 옵션

| UI 항목 | 설명 |
| --- | --- |
| the 재생 icon | 다음 중단점에 도달할 때까지 디버그 모드에서 실행을 시작하거나 계속합니다. |
| the 한 단계씩 코드 실행 icon | 다음 코드 행으로 넘어갑니다. |
| the 중지 icon | 여기서 실행이 종료됩니다. 모든 코드가 실행되기 전에 종료하면 결과 데이터 모델에 실행이 종료된 코드 행까지의 데이터만 포함됩니다. |
| the 중지 icon | 다음 설정에 액세스하려면 이 아이콘을 클릭합니다.<br><br><ul> <li> <p><span>제한된 로드</span>: 이 옵션을 사용하면 각 데이터 소스에서 로드할 데이터 행의 수를 제한할 수 있습니다. 데이터 소스가 큰 경우 실행 시간을 줄이는 데 유용합니다.</p> <p>로드할 행의 수를 입력하십시오.</p> <div><span>정보 메모</span>이 옵션은 실제 데이터 소스에만 적용됩니다. 자동으로 생성되며 인라인 로드 등은 제한되지 않습니다.</div> </li> <li> <p> <span>STORE</span><span>&nbsp;명령</span> <span>사용</span> : 로드 스크립트에서 <span>STORE</span> 문을 건너뛰지 않고 실행합니다. 이 설정을 켜면 일반 데이터 로드와 마찬가지로 <span>STORE</span> 문에 의해 파일이 생성됩니다.</p> </li> </ul> |

## 출력

출력에는 디버그 실행 중에 생성된 모든 메시지가 표시됩니다. 새 메시지가 표시되는 경우 the 잠금 icon을 클릭하여 출력이 스크롤되지 않도록 차단할 수 있습니다.

또한 출력 메뉴 the 메뉴 icon에는 다음과 같은 옵션이 포함됩니다.

출력 메뉴 옵션

| UI 항목 | 설명 |
| --- | --- |
| 지우기 | 모든 출력 메시지를 삭제하려면 이 옵션을 클릭합니다. |
| 모든 텍스트 선택 | 모든 출력 메시지를 선택하려면 이 옵션을 클릭합니다. |
| 맨 아래로 스크롤 | 마지막 출력 메시지로 스크롤하려면 이 옵션을 클릭합니다. |

## 변수

변수에는 모든 예약된 변수, 시스템 변수 및 스크립트에 정의된 변수가 나열되며 스크립트 실행 중에는 현재 값이 표시됩니다.

### 변수를 즐겨찾기로 설정

실행 중에 특정 변수를 조사하려는 경우, 해당 변수를 즐겨찾기로 설정할 수 있습니다. 즐겨찾는 변수는 변수 목록 맨 위에 표시되며 노란색 별표가 표시됩니다. 변수를 즐겨찾기로 설정하려면 다음을 수행합니다.

* 변수 옆의 the 즐겨찾기 icon을 클릭합니다.

  이제 the 즐겨찾기 icon은 노란색으로 표시되고 해당 변수는 변수 목록 맨 위로 이동되었습니다.

### 변수 필터링

필터를 적용하면 변수 메뉴 the 메뉴 icon에서 다음 옵션을 사용하여 선택된 유형의 변수만 표시할 수 있습니다.

변수 메뉴 옵션

| UI 항목 | 설명 |
| --- | --- |
| 모든 변수 표시 | 모든 유형의 변수를 표시하려면 이 옵션을 클릭합니다. |
| 시스템 변수 표시 | 시스템 변수를 표시하려면 이 옵션을 클릭합니다.<br><br>시스템 변수는 Qlik Sense에서 정의하지만 스크립트에서 해당 변수 값을 변경할 수 있습니다. |
| 예약된 변수 표시 | 예약된 변수를 표시하려면 이 옵션을 클릭합니다.<br><br>예약된 변수는 Qlik Sense에서 정의하며 값은 변경할 수 없습니다. |
| 사용자 정의 변수 표시 | 사용자 정의 변수를 표시하려면 이 옵션을 클릭합니다.<br><br>사용자 정의 변수는 스크립트에서 사용자가 정의한 변수입니다. |

변수에 대해 더 자세히 알아보려면 [데이터 로드 편집기에서 변수를 사용하여 작업](https://help.qlik.com/ko-KR/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Scripting/work-with-variables-in-data-load-editor.htm)을 참조하십시오.

## 중단점

특정 코드 행에서 디버그 실행을 중단할 수 있도록 스크립트에 중단점을 추가하고 이 지점에서 변수 값과 출력 메시지를 조사할 수 있습니다. 중단점에 도달하면 실행을 중지하거나, 다음 중단점에 도달할 때까지 계속하거나, 다음 코드 행으로 건너뛰도록 선택할 수 있습니다. 스크립트의 모든 중단점이 섹션 및 행 번호에 대한 참조와 함께 나열됩니다.

### 중단점 추가

코드 행에 중단점을 추가하려면 다음 중 하나를 수행합니다.

* 스크립트에서 중단점을 추가할 행 번호 바로 오른쪽 영역을 클릭합니다.

  행 번호 옆의 the 제거 icon은 해당 행에 중단점이 있음을 나타냅니다.

팁 메모디버그 패널이 닫혔을 때도 중단점을 추가할 수 있습니다.

### 중단점 삭제

다음 중 하나를 수행하여 중단점을 삭제할 수 있습니다.

* 스크립트에서 행 번호 옆의 the 제거 icon을 클릭합니다.

* 중단점 목록에서 중단점 옆의 the 취소 icon을 클릭합니다.

또한 the 메뉴 icon을 클릭하고 모두 삭제를 선택하여 스크립트의 모든 중단점을 삭제할 수도 있습니다.

### 중단점 사용/사용 안 함

중단점을 만들면 기본적으로 사용할 수 있게 설정되며 중단점 목록에서 해당 중단점 옆에 the 확인 표시 icon이 표시됩니다. 중단점 목록에서 중단점을 선택 및 선택 취소하면 개별 중단점을 사용하거나 사용하지 않을 수 있습니다.

또한 중단점 메뉴 the 메뉴 icon에서 다음 옵션도 사용할 수 있습니다.

* 모두 사용
* 모두 사용 안 함

관련 학습 자료:

* [데이터 로드 편집기 소개](https://help.qlik.com/lnk/Intro_Data_Load_Editor_QS)

## 자세한 정보

* [데이터 로드 편집기 소개](https://help.qlik.com/lnk/Intro_Data_Load_Editor_QS)