NodeJS 에서 sqlite 3 로 파일 형태 데이터베이스 사용 방법

Sqlite3 는 파일 형태로 관리할 수 있는 초소형 데이터 베이스 서비스로 Public Domain 으로 배포된다.

Public Domain 은 누구나 사용할 수 있고 제약이 없는 라이선스로, https://sqlite.org/copyright.html 를 참고하면 된다. 다만 인사/재산권 팀에서 라이선스 등을 요구하는 기업등을 위해서 증서 형태의 SQLite 라이선스를 판매하고 있다고 한다.

아무튼 NodeJS 에서 sqlite3 를 설치하기 위해서 다음 명령어면 충분하다.

npm install sqlite3

이렇게 sqlite3를 설치했으면 본격적으로 사용할 준비가 완료되었다.

우선 필자는 Module 형태로 임포트를 할 것이기 때문에 NodeJS 의 프로젝트를 module 형태로 지정한다.

NodeJS 내 package.json 파일의 type 을 변경해주면 된다.

기본 파일 정의 방법

import sqlite3 from "sqlite3"; const Database = sqlite3.Database; const database = new Database("./test.db", (error)=>{ if(error) console.log("[Err] " + error); } );

위 코드로 기본적인 데이터 베이스 파일을 생성할 수 있다. 해당 경로에 파일 생성에 실패하면 오류 메시지를 같이 띄운다.

기본적으로 위 테스트 데이터 베이스가 생성된 것을 확인할 수 있다.

사용법은 어렵지 않다. 위 처럼 생성된 database 변수를 통해 prepare 및 statement 질의를 수행할 수 있다.

위 statement 에 테이블을 생성하는 명령 질의문을 넣고, statement를 생성한다. 그리고 해당 statement 를 run 하여 질의를 수행하면 된다.

외부 도구 사용

특히 이렇게 생성된 데이터 베이스 파일은 외부 도구를 사용해서 열 수 있는데 여기서는 HeidiSQL 라는 소프트웨어를 사용해서 열어본다.

세션 관리자를 열고, 네트워크 유형을 SQLite 로 선택후, 데이터 베이스 파일명에 파일 경로를 입력하면 된다.

그렇게 연결을 하면 서버에 연결된 것 처럼 데이터 베이스 파일이 열리는 것을 확인할 수 있다. 기본 질의로 생성한 테이블이 존재하는 것을 확인할 수 있다.

데이터 삽입

const statement2 = database.prepare(` INSERT INTO test(test) values( ?); `); statement2.run("test",(error)=>{ if(error) console.log(error); });

prepare에 INSERT 구문을 넣어 데이터를 삽입할 수 있다. 다만 어떤 파라메터 형식으로 데이터를 삽입하거나 관리해야 하는 경우에는 ? 로 인자를 대신하여 run 시 같이 넘길 수 있다.

제대로 삽입된 것을 확인할 수 있다. Delete 도 마찬가지로 prepare 문으로 사용하면 된다.

SELECT 방법

const statement2 = database.prepare(` SELECT * from test `); statement2.all((error, rows)=>{ if(!error){ console.log(rows); } });

all 구문을 사용하면 된다. all 구문은 실행 결과를 콜백으로 rows도 같이 넘겨준다.

즉 오류가 없을 땐 rows를 출력하면 아래와 같이 출력된다.

즉 한 행씩 가져오려면 forEach를 사용하면 된다.

rows.forEach((row)=>{console.log(row)});