Large Files and Limits

큰 파일과 기능 제한 — Nexa SQL이 크기에 따라 무엇을 끄는가

사용자용 설명입니다. 기술 원장(근거 코드 · 실측)은 저장소의 docs/72.

Nexa SQL은 SQL 스크립트가 커지면 탭마다 단계를 정하고, 그 단계에서 부담이 큰 부가 기능을 자동으로 끕니다. 편집·선택·찾기·실행은 어느 크기에서도 그대로 됩니다 — 꺼지는 것은 "보기 좋게 해 주는" 기능뿐입니다.

단계는 파일을 열 때와 저장할 때 다시 정합니다. 열 때 상태줄에 안내가 뜨고, 그 탭이 활성인 동안 상태줄 오른쪽에 L1/L2 표식이 늘 보입니다.
기준 바꾸기: 설정 창 ▸ Files ▸ "Large file L1/L2 (MB · lines)" 또는 CLI nsql config set file.large_l1_mb 10 · nsql config set file.large_l2_lines 500000
이 탭만 전부 켜고 싶으면: 명령 팔레트(Ctrl+Shift+P) ▸ Toggle Large File Optimizations (This Tab) — 상태줄의 L1/L2 표식이 사라지고 모든 기능이 켜집니다(다음에 열거나 저장할 때까지 유지).

기능	L1부터	L2부터	바꾸는 설정
미니맵	끔	끔	(단계 고정 · 보통 크기에서도 4,000줄까지만 그림)
같은 단어 상자(선택어 강조)	끔	끔	단계 고정
줄 변경 표시(거터 띠)	끔	끔	단계 고정
괄호 색·짝 표시(Rainbow Pairs 확장)	끔	끔	`file.large_ext_level` = `0`(제한 없음) / `l1` / `l2` · 확장 자체 상한 `rainbowpair.max_kb`(기본 0 = 단계 따름)
구문 강조	켬	끔(평문)	`file.large_syntax_level` = `0` / `l1` / `l2`
재시작 뒤 되돌리기(기록 파일)	저장 안 함	저장 안 함	단계 고정(`editor.undo_persist_mb` 4 MB 이하 파일만)
외부에서 바뀐 파일 자동 병합	고치지 않았으면 그대로 다시 읽음 · 고쳤으면 어떻게 할지 물음	같음	`file.external_merge_max_kb`(2 MB)

동작	상한	넘으면	설정
큰 선택 위에 타이핑·붙여넣기·삭제	한 번에 지우는 글자 32 MB	먼저 안내가 뜨고, 같은 동작을 한 번 더 하면 실행	`editor.undo_giant_mb`(0 = 안 물음)
다중 선택 구간 수(Ctrl+D · Alt+F3 · Ctrl+클릭 · Split into Lines · 열 선택)	10,000개	거기서 멈추고 상태줄에 안내	`editor.max_occurrences`
큰 선택 복사/잘라내기(Ctrl+C/X)	32 MB	첫 누름은 안내, 3초 안에 다시 누르면 실행	`editor.copy_confirm_mb`(0 = 안 물음)
되돌리기 메모리	64 MB · 1,000 단계	오래된 단계부터 버림	`editor.undo_budget_mb` · `editor.undo_max`
선택 되돌리기(Ctrl+U)	500 단계	오래된 단계부터 버림	—
파일 검색(Find in Files)	파일 하나 1 MB	그 파일은 건너뜀	`search.max_file_kb`
결과 자동 페치	200행씩	스크롤 끝에서 다음 200행 · Σ = 건수 · 전체 조회 버튼	`grid.max_rows`
결과 메모리	1 GB	페치를 멈추고 안내	`grid.memory_budget_mb`
결과 탭	8개	고정하지 않은 오래된 탭부터 닫힘	`grid.result_tabs_max`
실행 카드	30장(향상 모드 8)	끝난 카드부터 사라짐	`run.toast_max`
변수 값	1 MB	잘라 저장 + 안내	`vars.max_value_kb`
프로젝트 폴더 열거	폴더당 5,000	"… 더 있음"	`project.scan_max`
파일 열기 다중 선택	10개	초과분은 제외 표시	`file.open_max`

전체 선택(Ctrl+A) · 드래그·Shift 선택 · 다중 캐럿 · 열 선택 — 어떤 크기든 즉시. 선택은 "시작·끝" 두 위치일 뿐이고 화면에 보이는 줄만 그리기 때문입니다. 그 선택 위에 편집하면 위 32 MB 확인이 한 번 막아 줍니다.
찾기/바꾸기(찾기 막대) — 줄 단위로 검색해 65 MB 파일에서도 됩니다.
실행 — 편집기에 싣지 않고 파일에서 바로 실행(File ▸ Run SQL File…)도 있습니다. 다만 이 경로와 CLI nsql은 파일을 통째로 읽어 문장으로 나누므로(스트리밍 없음) 메모리는 파일 크기의 2~3배가 잠시 필요합니다.

선택	뜻
그대로 열기	L2로 엽니다(위 표대로 부가 기능 끔)
앞부분만 8 MB	읽기 전용으로 앞부분만(`file.large_head_mb`)
읽기 전용으로 열기	실수로 고치지 않게
열지 않고 실행	편집기에 싣지 않고 실행만

묻지 않게 하려면 nsql config set file.large_ask_mb 0.

설정 ▸ Performance boost(perf.boost)는 모든 탭에서 미니맵·강조·애니메이션 등을 끄는 전역 스위치이고, 위 단계는 그 파일 하나의 크기로 정해집니다. 둘 다 켜져 있으면 둘 다 꺼진 상태가 됩니다.

상태줄 오른쪽의 NN MB 가 이 앱의 메모리 총량(맥 = 활성 상태 보기의 "메모리" · Windows = Private Bytes)입니다. 클릭하면 메모리 창이 열립니다(View ▸ Memory Usage · 팔레트 "Memory Usage").

위 막대 = 총량을 100 %로 데이터 영역(색) 과 기타(회색 · 런타임·라이브러리) 의 비율.
Data = 결과 데이터 · 결과 텍스트 캐시 · 편집기 본문 · 되돌리기 기록 · 편집기 그리기 캐시 · 메타(탐색기·완성) · 완성 · 로그 · 창 표면 · 아이콘 캐시. 값은 어림입니다.
System = 풋프린트 · 상주 · 익명(힙·스택) · 파일 매핑(라이브러리·글꼴) · 압축 · 힙 사용 중 · 힙 여유(예약·가상).
창이 열려 있는 동안 1초마다(설정 mem.refresh_ms) 갱신되고, 닫으면 아무것도 돌지 않습니다. Top 스위치 = 다른 창 위에 고정(설정 mem.always_on_top). 상태줄 숫자를 끄려면 mem.statusbar.