SQLite 뷰어
SQLite .db / .sqlite 파일을 브라우저에서 열어 테이블 구조, 인덱스, 데이터를 확인하고 SQL 실행 후 CSV로 내보내세요. 도구가 데이터베이스를 업로드하지 않습니다.
- 브라우저에서 처리
- 도구 입력을 ZeroTool 서버에 업로드하지 않습니다
- 무료 · 회원가입 불필요
WeChat으로 스캔하여 공유
예시·자세한 설명·자주 묻는 질문 실제 출력이 있는 예시, 다른 도구와의 차이, 자주 묻는 질문.
브라우저에서 SQLite를 여는 게 맞는 경우
- 에이전트나 스크립트가 쓴 내용 확인. 코딩 에이전트가 마이그레이션을 돌리거나 테스트 데이터를 넣었다면, 믿기 전에 파일을 열어 행을 직접 확인하세요.
- 앱 로컬 데이터 읽기. 브라우저, 모바일 앱, Electron 앱, 많은 CLI가 상태를 SQLite에 저장합니다. 파일만 꺼내면 데스크톱 클라이언트 없이 내용을 볼 수 있습니다.
- 데이터 전달. 쿼리를 실행해 CSV로 내보내고 그 CSV만 보냅니다. 데이터베이스 자체는 내 손에 남습니다.
값 표시 방식
| 값 | 화면 표시 | CSV |
|---|---|---|
| NULL | 흐린 NULL 표시. 빈 문자열과 구분됩니다 | 빈 필드 |
| BLOB | 바이트 수와 앞 16바이트의 16진수 | 전체 내용을 대문자 16진수로 |
| 긴 텍스트 | 셀 안에서 잘림. 마우스를 올리면 더 보기 | 전체 값, RFC 4180에 따라 따옴표 처리 |
| 숫자 | 오른쪽 정렬 | 저장된 값 그대로 |
쿼리 결과는 페이지 반응성을 위해 처음 1,000행만 그립니다. CSV 내보내기에는 항상 모든 행이 들어갑니다.
예시
한 열에 두 가지 타입이 들어 있는 경우. SQLite는 타입을 열이 아니라 값마다 저장하므로, DATETIME 열의 한 행에는 ISO 문자열이, 다른 행에는 Unix 타임스탬프가 들어갈 수 있습니다(Datatypes In SQLite). SQLite에 직접 물어보세요.
SELECT typeof(created_at) AS storage_class, COUNT(*)
FROM orders GROUP BY 1;
행이 '2026-09-01T10:00:00Z', 1759312800, '2026-09-02' 세 개라면 결과는 integer | 1과 text | 2입니다. 두 곳의 코드가 서로 다른 형식으로 이 열에 쓰고 있다는 뜻입니다. CREATE 문이 STRICT로 끝나는 테이블(SQLite 3.37.0 이상)은 이런 쓰기를 cannot store TEXT value in INT column으로 거부합니다.
실제로 실행하기 전에 정리 쿼리를 시험하기. 문장은 메모리 사본에서 실행되므로 삭제 후 몇 행이 남는지 먼저 볼 수 있습니다.
DELETE FROM sessions WHERE expires_at < unixepoch();
SELECT COUNT(*) AS remaining FROM sessions;
결과 표에는 열을 반환하는 마지막 문장의 결과가 나옵니다. 새 연결에서는 외래 키 검사가 꺼져 있으므로(PRAGMA foreign_keys가 0을 반환), ON DELETE CASCADE가 동작하게 하려면 먼저 PRAGMA foreign_keys = ON;을 실행하세요.
오류는 SQLite가 그대로 돌려줍니다. 키워드를 잘못 치면 SQL 오류: near "SELEC": syntax error가 표시됩니다. 전문 검색 테이블은 no such module: fts5가 나오는데, 이 도구가 쓰는 sql.js 1.14.2(SQLite 3.49.1)에 FTS5와 R-Tree 모듈이 포함되어 있지 않기 때문입니다. 이런 테이블의 행 수는 —로 표시되고 나머지 테이블은 그대로 볼 수 있습니다. FTS5 본문은 notes_fts_content 같은 일반 섀도 테이블에 있으니 그 테이블은 읽을 수 있습니다.
CSV는 올바른 텍스트로 유지됩니다. PNG 시그니처를 담은 BLOB은 표에 BLOB · 8 B · 89504E470D0A1A0A로 보이고 CSV에는 89504E470D0A1A0A로 저장됩니다. NULL과 빈 문자열은 둘 다 빈 필드가 되므로, 구분이 필요하면 쿼리에서 COALESCE(col, '<null>')를 선택한 뒤 내보내세요.
파일 내용이 예상과 다를 때
- 최근 행이 보이지 않음. WAL 모드에서는 커밋된 변경이 체크포인트 전까지
app.db-wal에 남아 있습니다. WAL 데이터베이스는 헤더의 18·19번째 바이트가 모두2입니다(파일 형식). 이 파일에 쓰는 앱을 닫고sqlite3 app.db "PRAGMA wal_checkpoint(TRUNCATE);"를 실행하세요. - 「SQLite 3 데이터베이스가 아님」 오류. 처음 16바이트는
SQLite format 3과 널 바이트여야 합니다.head -c 16 app.db | xxd로 확인할 수 있습니다. SQLCipher는 이 자리에 무작위 솔트를 두므로 암호화된 파일은 이 검사에서 걸립니다. - 파일이 100 MB를 넘음. 먼저 작은 추출본을 만드세요:
sqlite3 big.db "ATTACH 'small.db' AS s; CREATE TABLE s.orders AS SELECT * FROM orders WHERE created_at >= '2026-09-01';"그다음small.db를 여세요. - 사용 중인 데이터베이스 복사.
cp는 쓰다 만 파일을 복사할 수 있습니다.sqlite3 app.db "VACUUM INTO 'snapshot.db'"(SQLite 3.27.0 이상, VACUUM)는 커밋된 WAL 내용까지 포함한 일관된 단일 파일 사본을 씁니다.
동작 원리
페이지는 먼저 파일의 처음 100바이트만 읽어 SQLite 헤더를 확인합니다. SQLite 엔진(sql.js, 압축 시 약 340 KB)은 이 확인을 통과한 뒤에야 내려받으므로, 페이지를 여는 것만으로는 추가 로딩이 없고 잘못된 파일로 다운로드가 일어나지도 않습니다. 그다음 파일 전체를 인메모리 데이터베이스로 SQLite에 넘깁니다. 테이블 구조는 pragma_table_info와 pragma_index_list에서 가져오며, 모든 테이블·컬럼 이름에 따옴표를 붙이므로 공백, 따옴표, 한글이 들어간 이름도 문제없습니다.
지원 범위
이 도구는 100 MB 이하의 SQLite 3 파일 하나를 열어 읽습니다. 변경 내용을 파일에 되돌려 쓰지 않고, -wal / -journal 부속 파일을 읽지 않으며, 암호화된 데이터베이스를 열지 않습니다. SpatiaLite 지오메트리 테이블, FTS5 전문 검색 인덱스, R-Tree 인덱스처럼 확장에 의존하는 가상 테이블은 행 대신 SQLite 오류를 표시합니다. 이런 경우에는 내 컴퓨터의 sqlite3 명령줄이나 DB Browser for SQLite를 사용하세요.
FAQ
데이터베이스 파일이 업로드되나요?
아니요. 파일은 브라우저 File API로 읽고, WebAssembly로 컴파일된 SQLite(sql.js)가 페이지 안에서 엽니다. 업로드하지 않으며 파일과 쿼리를 저장하지도 않고, 이 페이지용으로 저장된 값도 페이지를 열 때마다 지웁니다. 데이터베이스에는 보통 사용자 기록, 토큰, 운영 데이터가 들어 있어 AI 채팅에 붙여넣거나 남의 서버로 보내면 안 되므로, 이 페이지는 분석·광고 스크립트를 불러오지 않습니다.
UPDATE나 DELETE를 실행하면 원본 파일이 바뀌나요?
바뀌지 않습니다. 브라우저는 선택한 파일에 쓰기 권한이 없습니다. SQL은 메모리 복사본에서 실행되므로 INSERT, UPDATE, DELETE, CREATE가 동작하고 테이블 목록도 갱신되지만, 새로고침하거나 다른 파일을 열면 변경 내용이 사라집니다. 수정된 복사본을 다운로드하는 기능은 없습니다. 디스크의 파일을 수정하려면 sqlite3 명령줄이나 DB Browser for SQLite를 사용하세요.
얼마나 큰 데이터베이스까지 열 수 있나요?
100 MB까지입니다. 파일을 여는 동안 전체 내용이 메모리에 두 번(파일 버퍼와 SQLite 엔진 내부) 올라가므로, 그보다 크면 브라우저 탭이 불안정해집니다. 더 큰 데이터베이스는 로컬에서 sqlite3 app.db를 실행하세요.
'SQLite 데이터베이스가 아닙니다'라고 나오는 이유는?
모든 SQLite 3 파일은 16바이트 헤더 SQLite format 3으로 시작합니다. 이 헤더가 없으면 다른 형식의 파일이거나 암호화된 파일입니다. SQLCipher와 SQLite Encryption Extension은 헤더까지 암호화하므로 암호화된 DB는 여기서 열 수 없습니다. sqlcipher로 복호화하거나 SQLCipher를 지원하는 DB Browser for SQLite로 여세요.
최근에 쓴 행이 보이지 않는 이유는?
데이터베이스가 WAL 모드이고 최신 쓰기가 옆에 있는 app.db-wal 파일에 남아 있을 가능성이 큽니다. 이 도구는 메인 파일만 읽습니다. 해당 DB에 쓰는 프로그램을 종료하거나 sqlite3 app.db "PRAGMA wal_checkpoint(TRUNCATE);"를 실행한 뒤 다시 여세요.