n8n에서 SQLite를 이야기할 때 가장 먼저 짚어야 할 점이 있다. 지금 많은 사용자가 말하는 “n8n SQLite 노드”는 일반적인 업무 자동화용 데이터베이스 노드라기보다, n8n이 기본 저장소로 SQLite를 쓰는 구조와 혼동되는 경우가 꽤 많다는 점이다. 실제로 n8n 공식 문서에서 SQLite는 기본 내부 데이터베이스로 자주 등장하고, 별도의 파일 기반 접근은 운영 방식이나 우회 흐름을 통해 다루는 경우가 많다. 그래서 이 주제는 단순히 “노드 하나 연결하면 끝”처럼 보면 오히려 더 헷갈리기 쉽다.
저도 처음에는 SQLite를 정말 가볍고 편한 로컬 저장소쯤으로만 봤다. 작은 프로젝트나 내부 자동화에서는 이 정도면 충분하겠지 싶었다. 실제로 초반에는 맞는 말이다. 별도 DB 서버를 띄우지 않아도 되고, 파일 하나만 잘 관리하면 되니 진입장벽도 낮다. 그런데 막상 몇 번 운영해보면 체감이 달라진다. 경로 문제, 권한 문제, 동시 쓰기 충돌, 백업 타이밍 같은 게 생각보다 빨리 튀어나온다.
그래서 SQLite는 “가볍다 = 아무렇게나 써도 된다”가 아니라, “작고 단순한 만큼 쓰는 범위를 분명히 해야 한다”는 쪽에 더 가깝다. 개인 프로젝트, 테스트용 저장소, 간단한 상태 저장, 소규모 로그 기록처럼 범위가 명확한 작업에는 꽤 잘 맞는다. 반대로 여러 워크플로우가 동시에 쓰기를 하거나, 확장성과 동시성이 중요한 환경에서는 금방 한계가 드러난다. n8n 공식 문서도 기본 DB로 SQLite를 쓰긴 하지만, queue 모드처럼 확장성이 필요한 환경에서는 Postgres 사용을 권장한다.
실제로는 연결 성공보다, 같은 실수를 반복하지 않게 구조를 잡는 단계가 더 오래 남는다. SQLite는 빠르게 붙이기엔 좋지만, 파일 위치와 쓰기 충돌을 통제하지 못하면 작은 자동화에서도 예상보다 빨리 한계가 드러난다.
이 글에서는 바로 그 지점을 정리하려 한다. SQLite를 무조건 좋은 경량 DB처럼 미화하지 않고, n8n에서 어떤 상황에선 잘 맞고 어떤 상황에선 빨리 벗어나는 게 좋은지, 실제 운영 기준으로 풀어보려 한다. 특히 파일 경로, 파라미터 바인딩, 동시성, 백업, Docker 볼륨 같은 실수 포인트를 중심으로 보강했다.
직접 비슷한 구조를 여러 번 만져보니 가장 먼저 체감되는 차이는 쿼리 성능보다도 “파일을 어디에 두고 누가 동시에 건드리느냐”에서 더 크게 갈렸다.
n8n과 SQLite 조합의 진짜 장점은 ‘작게 시작하기 쉽다’는 점이다
SQLite의 가장 큰 장점은 별도 데이터베이스 서버가 없다는 점이다. 파일 하나만 있으면 된다. 이건 생각보다 크다. 테스트용 자동화, 개인 백업, 단순 로그 기록, 상태 저장 정도라면 MySQL이나 PostgreSQL을 올리는 것보다 훨씬 부담이 적다. 설치와 유지관리도 거의 없고, 오프라인 환경이나 내부망에서도 쓰기 쉽다.
반대로 말하면, 이 장점은 범위가 작을 때 가장 크게 빛난다. 많은 사용자가 여기서 착각한다. 파일 하나만 있으면 되니까 더 단순하고, 더 싸고, 더 편하니 그냥 계속 키워도 되겠지 싶다. 그런데 SQLite는 구조적으로 동시 쓰기와 대규모 확장에 강한 도구가 아니다. 그래서 처음엔 편한데, 나중에 갑자기 발목을 잡는 경우가 많다.
실제로는 클라우드 DB가 무조건 과한 것도 아니다. 워크플로우가 늘어나고, 여러 자동화가 같은 데이터를 읽고 쓰고, 나중에 백업과 복구까지 고민해야 하는 시점부터는 오히려 SQLite가 더 귀찮아질 수 있다. 그래서 SQLite는 “작아서 좋은 선택지”이지, “언제나 더 좋은 선택지”는 아니다.
1. 파일 경로가 사실상 절반이다
n8n에서 SQLite를 다룰 때 가장 자주 터지는 문제는 SQL 문법이 아니라 파일 경로다. 로컬에서는 잘 되던 경로가 Docker 안에서는 안 맞고, 서버에서는 권한이 다르고, 재배포 후에는 파일이 없어진 것처럼 보이는 일이 생각보다 흔하다. 특히 Docker 환경에서는 호스트 디렉터리를 컨테이너에 볼륨으로 연결하지 않으면, 재시작이나 재생성 시 파일이 사라지거나 초기화된 것처럼 느껴질 수 있다. n8n 공식 문서도 파일 시스템 접근이 self-hosted 환경에서만 가능하다고 안내한다.
이 부분은 정말 초반에 많이 틀린다. 상대 경로를 써놓고 왜 안 되는지 한참 찾거나, 컨테이너 내부 경로만 믿고 있다가 실제 파일이 휘발되는 경우도 있다. 그래서 SQLite를 쓸 땐 쿼리보다 먼저 “이 파일이 지금 어디에 실제로 존재하는가”부터 확실히 보는 편이 낫다.
2. 쿼리는 꼭 안전하게 작성해야 한다
원문처럼 표현식을 쿼리 안에 직접 꽂아 넣는 방식은 얼핏 편해 보이지만, 실제 운영에서는 추천하기 어렵다. SQL 인젝션 문제도 그렇고, 작은 따옴표나 특수문자 때문에 예상치 못한 에러가 생기기 쉽다. 그래서 값은 파라미터로 분리하고, 쿼리문은 구조만 유지하는 쪽이 훨씬 안전하다.
예를 들어 INSERT INTO logs (message, timestamp) VALUES (?, ?)처럼 쓰고, 실제 값은 별도로 바인딩하는 방식이 기본이다. 처음엔 한 줄 더 적는 게 귀찮아 보여도, 이 습관이 나중에 데이터 무결성과 디버깅 편의성을 크게 바꾼다. SQLite는 단순해서 오히려 이런 기본기를 더 잘 지켜야 한다.
| 설정 항목 | 권장 방식 |
|---|---|
| 데이터베이스 파일 경로 | 절대 경로 사용, Docker에서는 볼륨 마운트로 영속성 확보 |
| 쿼리 작성 | 파라미터 바인딩 우선, 직접 문자열 삽입 지양 |
| 백업 | 정기 복사 + 파일 잠금/쓰기 시점 고려 |
| 동시성 | 동시 쓰기 최소화, 필요 시 DB 자체 전환 고려 |
어디까지는 SQLite가 잘 맞고, 어디부터는 무리일까?
기술의 진가는 결국 쓰임새에서 드러난다. SQLite는 모든 걸 다 해결하는 만능 DB가 아니라, 작은 범위에서 굉장히 효율적인 저장소다. n8n에서는 “복잡한 인프라 없이도 상태를 남기고 비교할 수 있다”는 점이 가장 큰 강점이다. 이게 생각보다 실무에서 자주 쓴다.
예를 들어 웹훅으로 들어온 문의를 SQLite에 먼저 저장해두고, 매일 아침 그 결과를 요약해서 메일로 보내는 흐름은 꽤 실용적이다. 외부 DB를 따로 안 붙여도 되고, 데이터가 내 서버 안에 남으니 심리적으로도 편하다. 다만 이건 어디까지나 규모가 작고, 동시 접근이 많지 않을 때 잘 맞는다.
3. 로그 저장소로는 꽤 쓸 만하다
API 실패, 크롤링 오류, 외부 서비스 응답 이상 같은 이벤트를 SQLite에 차곡차곡 남겨두는 건 꽤 좋은 활용이다. 나중에 조건부 알림, 일일 요약, 오류 횟수 누적 확인 같은 흐름과도 잘 맞는다. 이 정도는 별도 DB 없이도 충분히 돌아간다.
실제로 저는 이런 류의 상태 저장이 SQLite와 가장 잘 맞는다고 느꼈다. 복잡한 분석이 아니라, “지금까지 몇 번 실패했는가”, “마지막으로 언제 성공했는가” 같은 얕은 상태 정보는 파일 기반 DB가 오히려 더 단순하고 관리하기 쉽다.
4. 개인용 Todo나 간단한 상태 저장에도 잘 맞는다
텔레그램이나 이메일로 받은 할일을 SQLite에 저장하고, 아침마다 미완료 항목을 다시 보내주는 식의 자동화도 만들기 좋다. Notion이나 Todoist를 붙이지 않고도, 꽤 쓸 만한 개인 워크플로우가 나온다. 이런 구조는 외부 서비스 정책 변화나 API 제한에 덜 흔들린다는 장점도 있다.
다만 이 단계에서도 “나 혼자 쓰는가”가 중요하다. 사용자가 늘어나거나, 여러 자동화가 동시에 같은 파일을 만지기 시작하면 안정성이 빠르게 떨어질 수 있다.
5. 일일 스냅샷 비교에는 꽤 강하다
주가, 환율, 날씨, 특정 페이지 상태처럼 외부 API에서 가져온 값을 매일 SQLite에 저장해두고, 이전 값과 비교해 변화를 감지하는 구조도 잘 맞는다. 이럴 때는 SQLite가 단순 저장소를 넘어서 “변화 감지용 기준 데이터” 역할을 하게 된다.
이런 시나리오는 호출 횟수 제한이 있는 무료 API와도 궁합이 괜찮다. 필요한 타이밍에만 저장하고 비교하면 되기 때문이다. 단, 데이터량이 계속 커질 때는 쿼리 속도보다 파일 관리와 백업 방식이 더 중요해진다.
📌 핵심 포인트 & 주의사항
SQLite는 본질적으로 동시 쓰기에 강한 구조가 아니다. n8n 워크플로우가 여러 개 동시에 같은 파일에 쓰기를 시도하거나, 외부 프로그램까지 같은 .db 파일을 함께 건드리기 시작하면 잠금 오류가 나기 쉽다. n8n 공식 문서도 queue 모드에서 SQLite 사용을 권장하지 않는다. 실제로는 “작은 자동화 하나의 상태 저장소” 정도로 볼 때 가장 안정적이고, 동시성이나 확장성이 중요한 순간부터는 Postgres 쪽으로 넘어가는 편이 더 낫다.
직접 확인해보면 좋은 테스트 예시
SQLite 관련 글은 “가볍고 편하다”로만 끝나면 얕아 보이기 쉽다. 그래서 실제로는 경로, 권한, 동시 쓰기, 백업 복원까지 직접 확인해보는 흐름이 중요하다. 아래처럼 일부러 다른 조건을 넣어보면 어디서 한계가 나오는지 금방 보인다.
1. 파일 경로와 권한 테스트
테스트 예시
DB 파일 위치: - 로컬 절대 경로 - Docker 볼륨 마운트 경로 확인 항목: - 읽기 가능 여부 - 쓰기 가능 여부 - 컨테이너 재시작 후 파일 유지 여부
기대 결과
워크플로우가 정상적으로 INSERT/SELECT를 수행하고, 재시작 뒤에도 데이터가 남아 있어야 한다.
실제 확인 포인트
파일이 실제 어느 경로에 생성되는지, 컨테이너 안에서만 생겼다 사라지는 건 아닌지, 권한 오류가 로그에 남는지 본다.
2. 파라미터 바인딩 테스트
테스트 예시
입력값: message = O'Reilly test 쿼리 A: 직접 문자열 삽입 쿼리 B: VALUES (?, ?) 바인딩 사용
기대 결과
쿼리 B가 특수문자나 따옴표를 포함해도 더 안정적으로 저장되어야 한다.
실제 확인 포인트
문자열 깨짐, 구문 오류, 예기치 않은 쿼리 실패가 있는지 비교해 본다.
3. 동시 쓰기 충돌 테스트
테스트 예시
동일 .db 파일에 대해 - 2개 이상의 워크플로우가 동시에 INSERT - 외부 프로그램이 같은 파일 접근
기대 결과
잠금 오류가 발생하거나, 실행 지연이 눈에 띄게 늘어날 수 있다.
실제 확인 포인트
database is locked 형태의 오류가 발생하는지, 특정 시간대에만 실패가 몰리는지 확인한다.
4. 백업 복원 테스트
테스트 예시
주기적으로 .db 파일 복사 복사본으로 복원 테스트 진행
기대 결과
손상 없이 복사본에서 데이터가 정상 조회되어야 한다.
실제 확인 포인트
백업 타이밍이 쓰기 중간과 겹치지 않는지, 복원 파일이 실제로 열리는지 확인한다.
실제 검증 실행 결과
실제 검증 기준으로 보면 가장 먼저 차이가 난 건 쿼리보다도 파일 위치와 동시 접근 조건이었다. 절대 경로와 Docker 볼륨을 명확히 잡아둔 경우에는 데이터 유지가 안정적이었지만, 컨테이너 내부 경로만 믿고 진행한 경우에는 재시작 뒤 파일이 사라진 것처럼 보이는 상황이 바로 나타났다. 또 단일 워크플로우가 천천히 쓰는 구조에서는 큰 문제가 없었지만, 두 개 이상의 흐름이 같은 파일에 동시에 쓰기를 시도하자 잠금 오류가 바로 드러났다. 결국 SQLite는 “작고 단순한 자동화”에서는 정말 편하지만, 구조가 조금만 커져도 파일 위치와 동시성 관리가 제일 먼저 발목을 잡는다는 점이 가장 크게 체감됐다.
FAQ: 자주 묻는 질문
Q. n8n SQLite는 클라우드 환경에서도 쓸 수 있나요?
A. self-hosted 환경이라면 가능하지만, 관리형 서비스에서는 로컬 파일 시스템 접근이 제한될 수 있다. n8n Cloud에서는 Read/Write Files from Disk 노드 자체가 제공되지 않으므로, SQLite 파일을 직접 다루는 흐름은 self-hosted에서 더 현실적이다.
Q. SQLite와 PostgreSQL/MySQL 중 무엇을 골라야 하나요?
A. 단일 사용자, 소규모 자동화, 상태 저장, 간단한 로그 기록 정도라면 SQLite가 훨씬 단순하다. 반대로 여러 워크플로우가 동시에 돌고, 동시성이나 확장성이 중요해지면 PostgreSQL이나 MySQL 쪽이 더 안정적이다. 특히 queue 모드를 염두에 둔다면 Postgres가 더 적합하다.
Q. SQLite 파일이 손상되면 어떻게 해야 하나요?
A. SQLite는 ACID 특성 덕분에 아주 가벼운 테스트용 저장소치고는 꽤 안정적이지만, 백업은 여전히 필수다. 주기적으로 파일 복사본을 남기고, 복사본이 실제로 열리는지까지 확인하는 편이 더 안전하다. n8n 워크플로우 안에서 파일 복사 자동화를 넣는 것도 충분히 실용적이다.
Q. SQLite는 무조건 가볍고 빠른가요?
A. 작은 범위에서는 맞지만, 동시 쓰기나 대량 처리까지 가면 꼭 그렇지는 않다. 가볍다는 장점이 곧 확장성까지 보장하는 건 아니기 때문에, 쓰는 범위를 분명히 나눠서 보는 편이 낫다.
n8n과 SQLite 조합은 얼핏 보면 단순하다. 하지만 잘 쓰면 외부 인프라 없이도 꽤 강력한 자동화를 만들 수 있다. 관건은 기술이 아니라 범위 설정이다. 작은 문제를 작게 해결할 때 SQLite는 아주 좋은 도구가 된다.
독자가 바로 체감할 수 있는 이득도 분명하다. 서버형 데이터베이스를 따로 운영하지 않아도 되고, 상태 저장이나 간단한 로그 추적 정도는 훨씬 가볍게 시작할 수 있다. 반대로 이 장점을 과신해서 범위를 너무 넓히면, 나중에는 파일 관리와 잠금 오류가 먼저 스트레스를 주게 된다.
그래서 가장 현실적인 접근은 이렇다. 처음엔 SQLite로 작게 시작하고, 동시성이나 규모가 커지기 시작하면 바로 상위 DB로 옮길 준비를 해두는 것이다. n8n은 기본적으로 SQLite를 내부 저장소로 쓰지만, CLI로 다른 DB 타입으로 엔터티를 내보내고 가져오는 흐름도 지원한다. 너무 늦게까지 버티는 것보다, 한계가 보일 때 미리 옮길 수 있게 준비해두는 편이 더 낫다.
직접 여러 번 비슷한 구성을 굴려보면, 결국 가장 덜 후회하는 방법은 “작게 쓸 건 정말 작게만 쓰기”였다. SQLite가 좋은 건 맞지만, 좋은 도구와 모든 상황에 맞는 도구는 다르다는 걸 나중에 더 크게 체감하게 된다.
실제로 적용할 때 체크할 부분
이 글을 읽고 바로 적용해보려면 먼저 지금 만들려는 자동화가 정말 SQLite 범위에 맞는지부터 정리하는 게 좋다. 단순 로그 저장인지, 상태 비교인지, 개인용 Todo 관리인지 정도만 명확해도 설계가 훨씬 쉬워진다.
운영 흐름까지 같이 보고 싶다면 설치 구조와 파일 경로를 먼저 정리하고, 그다음 볼륨/백업, 마지막으로 보안과 업데이트 흐름까지 이어서 점검하는 편이 무난하다. 관련해서는 [관련 글: n8n 설치 방식 로컬부터 클라우드까지 총정리 더 알아보기], [관련 글: n8n Credential과 웹훅 완벽 방어 전략 더 알아보기], [관련 글: n8n 업데이트 방법, 백업과 롤백까지 완벽 정리 더 알아보기]를 같이 보면 전체 운영 감각을 잡는 데 도움이 된다.
참고 자료: n8n 공식 문서 – 지원 데이터베이스와 설정 | n8n 공식 문서 – Queue Mode | n8n 공식 문서 – Read/Write Files from Disk | n8n 공식 문서 – CLI commands
SQLite는 빠르게 붙이기엔 좋지만, 파일 위치와 쓰기 충돌을 통제하지 못하면 작은 자동화에서도 예상보다 빨리 한계가 드러난다. 그래서 이 글도 단순 기능 소개보다, 실제로 다시 손댈 때 바로 체크할 수 있는 기준이 남도록 흐름을 정리하는 쪽이 더 유용하다.
