SQL 성능을 이해하려면 쿼리 문장 자체보다 SQLite가 선택한 실행 방식을 살펴봐야 한다. SQLite Query Explainer는 브라우저에서 SQLite 데이터베이스에 SQL을 실행하고, 실행 계획과 저수준 명령의 각 줄에 영어 설명을 덧붙이는 도구다.1 복잡한 EXPLAIN 출력을 처음 접하는 사람도 계획의 의미를 단계적으로 파악할 수 있다.
실행 계획과 바이트코드를 함께 읽기
SQLite가 제공하는 두 가지 설명은 서로 다른 수준의 정보를 보여준다.
EXPLAIN QUERY PLAN은 테이블 접근 순서와 인덱스 사용 여부를 요약한다. 대표적으로 다음 항목을 확인할 수 있다.
SCAN: 테이블이나 인덱스의 전체 범위를 훑는다.SEARCH: 인덱스 등을 이용해 조건에 맞는 행을 찾는다.USE TEMP B-TREE: 정렬이나 그룹화를 위해 임시 B-트리를 사용한다.2
반면 EXPLAIN은 SQLite 가상 머신이 쿼리를 수행할 때 실행하는 명령을 바이트코드 수준으로 보여준다. Query Explainer는 두 출력의 각 줄을 설명해, SQLite가 어떤 계획을 선택했는지뿐 아니라 그 계획을 어떻게 실행하는지까지 연결해서 살펴보게 해준다.1
브라우저에서 재현 가능한 실험 만들기
이 도구에서는 WebAssembly 기반 Pyodide의 Python을 통해 SQLite가 실행된다.1 별도의 SQLite 환경을 설치하지 않고도 데이터와 쿼리를 준비한 뒤, 인덱스 추가나 SQL 변경 전후의 실행 계획을 비교할 수 있다.
2025년 2월 7일 공개된 APSW 기반 SQLite Query Explainer는 분석 범위를 더 넓힌다. 실행 계획 외에도 확장된 SQL과 쿼리 정보를 제공하며, 기본 쿼리 전에 테이블 생성이나 데이터 초기화를 위한 설정 SQL을 실행할 수 있다. 매개변수화된 쿼리도 라벨이 붙은 입력 필드로 지원한다.3 같은 조건을 반복해서 검증해야 할 때 유용한 기능들이다.
공식 SQLite3 Fiddle 역시 SQLite CLI 셸의 WebAssembly 빌드를 감싼 브라우저 애플리케이션이다. 로드가 끝난 뒤에는 원격 서버와 통신하지 않으며 HTTP 쿠키도 사용하지 않는다. 다만 별도의 영구 저장 옵션을 사용하지 않으면 데이터베이스는 일시적인 인메모리 상태로 유지된다. 가져올 데이터베이스 크기에 명시적인 제한은 없지만, 큰 파일은 메모리 부족 오류를 일으킬 수 있다.4
설명을 성능 개선으로 연결하는 법
Query Explainer의 설명은 정답이라기보다 점검을 시작할 단서다. 우선 큰 테이블의 SCAN, 예상과 달리 사용되지 않는 인덱스, USE TEMP B-TREE가 나타나는 정렬 작업을 확인한다. 그런 다음 인덱스나 SQL을 한 번에 하나씩 바꾸고, 실행 계획과 실제 실행 시간이 어떻게 달라지는지 비교한다.
SQLite는 EXPLAIN QUERY PLAN 출력을 대화형 분석용으로 규정하며, 버전에 따라 출력 형식이 달라질 수 있다고 경고한다.2 따라서 설명 문구를 고정된 자동화 규칙으로 사용하기보다는, 실행 계획을 이해하고 성능 가설을 검증하는 보조 수단으로 활용하는 편이 안전하다.
결국 SQLite Query Explainer의 가치는 난해한 출력을 읽기 쉬운 언어로 바꾸는 데 있다. 이를 바탕으로 계획을 관찰하고, 변경 전후를 비교하며, SQLite 문서로 판단을 확인하는 습관을 들이면 쿼리 최적화를 훨씬 체계적으로 배울 수 있다.
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.