2.1. Sqlite의 특징

1. SQL92의 대부분을 지원한다. 다음은 지원하지 않는 몇 가지 기능들이다.

2. 단일 파일에 데이터베이스의 모든것을 포함한다.

3. ACID(Atomic, Consistent, Isolate, Durable) 보증

4. byte order에 관계없이 데이터 파일의 공유가 가능

5. 2테라바이트 (2^41)크기의 데이터 파일 생성지원

6. 효율적인 메모리 사용 : 25k라인정도의 C코드로 이루어졌다.

7. 많은 일반적인 명령을 실행하는데 PostgreSql과 Mysql보다 최소 2배이상 명령에 따라서 10-20배 이상 빠르다.

8. 하나의 구조체와 3개의 함수만 사용하는 정도로 sqlite를 사용하는 C/C++ 코드를 만들어 낼 수 있다.

9. TCL, Perl, PHP, .Net, Java, Python, SmallTalk, Ruby등의 다양한 언어지원

10. 다른 라이브러리등의 도움없이 작동된다. libsqlite.so와 sqlite 2개의 파일이면 작동 환경을 만들 수 있다.

11. Public Domain 라이센스를 가진다.

12. sqlite는 서버/클라이언트 모델을 지원하는 RDBMS가 아니다. 로컬에서만 사용가능하며 인터넷응용을 원한다면 별도의 서버 프로그램을 만들어야 한다.

2.2. 설치하기

SQLite 홈페이지에서 다운로드 받을 수 있다. 현재(2003/1/08) sqlite-2.8.9.tar.gz 버젼이 최신버젼이다. 다운로드 받아서 압축까지 풀고 보니 4M정도 되는 작은 크기였다. oracle은 말할 것도 없고 수십메가의 크기를 가지는 postgresql이나 mysql에 비해서도 매우 작은 크기이다.

rpm도 준비되어 있기는 한데, 서버 프로그램들은 무조건 컴파일해서 설치해야 하는 성격이라 tarball을 받아서 컴파일 후 설치하기로 했다. 다음은 필자가 사용중인 리눅스박스의 사양이다.

설치는 매우 간단하다.

# wget http://www.hwaci.com/sw/sqlite/sqlite-2.8.9.tar.gz
# mv sqlite-2.8.9.tar.gz /usr/src
# tar -xvzf sqlite-2.8.9.tar.gz
# cd sqlite
# ./configure
# make 
# make install
            

3.1. DB 생성및 간단한 내부명령어들

sqlite [dbname] 으로 간단하게 생성할 수 있다. 동일한 이름이 존재하면 열고 그렇지 않다면 새로 생성한다.

# sqlite test.db
SQLite version 2.8.9
Enter ".help" for instructions
sqlite> 
            

sqlite> create table test(name char(80), age int);
sqlite> insert into test values("yundream", 19);
sqlite> insert into test values("hello world", 29);
sqlite> select * from test;
yundream|19
hello world|29
            

1. .databases : 현재 작업중인 DB파일과 관련된 다른 파일들 목록 출력

2. .echo ON|OFF : 명령어를 반향 할건지 여부

3. .exit : 프로그램 종료

4. .help : 도움말

5. .schema ?TABLE? : 테이블 구조

6. .show : 현재 프로그램 설정값을 보여준다.

7. .read FILENAME : FILENAME으로 부터 SQL을 실행한다.

8. .output FILENAME : 출력을 FILENAME으로 보냄

9. .output stdout : 출려을 화면으로 보냄(기본 값)

10. .output stdout : 출려을 화면으로 보냄(기본 값)

4.1. 핵심 API

sqlite는 3개의 핵심 함수와 하나의 자료구조를 제공한다. 이외에도 몇가지 리턴값과 상수들을 가지고 있다.

typedef struct sqlite sqlite;
#define SQLITE_OK

sqlite *sqlite_open(const char *dbname, int mode, char **errmsg);

void sqlite_close(sqlite *db);

int sqlite_exec
(
  sqlite *db,
  char *sql,
  int (*xCallback)(void*,int,char**,char**),
  void *pArg,
  char **errmsg
);
            

4.2. DB 열기

            sqlite *sqlite_open(const char *dbname, int mode, char **errmsg);
            

4.3. DB닫기

sqlite_close()함수를 호출하면 된다. 인자로는 sqlite_open()으로 생성된 sqlite 구조체 포인터가 들어간다. sqlite_close()를 호출했을 때 트랜잭션(transaction)이 활성화 되어 있는 상태라면 이 트랜잭션은 rolled back 하게 된다.

4.4. SQL 실행

sqlite_exec()를 이용해서 SQL쿼리와 각종 명령을 수행할 수 있다. 이 함수는 5개의 인자를 가진다.

1. sqlite_open()에 의해서 만들어진 sqlite구조체 포인터다.

2. sql 쿼리와 sql 명령을 위한 문자열이 들어간다. 이 문자열은 null로 끝난다.

3. 콜백함수로써 쿼리의 결과를 처리하기 위해서 호출 된다. NULL 이라면 아무일도 하지 않게 된다.

4. 콜백함수로 넘겨줄 인자의 처음을 가르키는 포인터다.

5. 에러메시지를 가르키는 포인터다. 이 포인터는 malloc()등을 이용해서 할당된 공간에 씌여지며 함수가 종료되면 free() 된다. NULL이라면 어떤 에러메시지도 보고되지 않을 것이다.

콜백(callback)함수는 쿼리의 결과를 받기 위해서 사용된다. 콜백함수는 다음과 같이 선언되어 있다.

int Callback(void *pArg, int argc, char **argv, char **columnNames))
{
    return 0;
}
            

콜백함수는 정상적으로 수행되었을 경우 0을 리턴한다. 만약 에러가 발생한다면 0이 아닌 값을 리턴하고 쿼리는 취소된다. 이경우 sqlite_exe()는 SQLITE_ABORT를 리턴할 것이다.

4.5. 에러 코드

정상적으로 실행되었을 경우 sqlite_exec()함수는 SQLITE_OK를 리턴한다. 그렇지 않을경우 다음과 같은 에러 코드들을 리턴한다.

#define SQLITE_OK           0   /* Successful result */
#define SQLITE_ERROR        1   /* SQL error or missing database */
#define SQLITE_INTERNAL     2   /* An internal logic error in SQLite */
#define SQLITE_PERM         3   /* Access permission denied */
#define SQLITE_ABORT        4   /* Callback routine requested an abort */
#define SQLITE_BUSY         5   /* The database file is locked */
#define SQLITE_LOCKED       6   /* A table in the database is locked */
#define SQLITE_NOMEM        7   /* A malloc() failed */
#define SQLITE_READONLY     8   /* Attempt to write a readonly database */
#define SQLITE_INTERRUPT    9   /* Operation terminated by sqlite_interrupt() */
#define SQLITE_IOERR       10   /* Some kind of disk I/O error occurred */
#define SQLITE_CORRUPT     11   /* The database disk image is malformed */
#define SQLITE_NOTFOUND    12   /* (Internal Only) Table or record not found */
#define SQLITE_FULL        13   /* Insertion failed because database is full */
#define SQLITE_CANTOPEN    14   /* Unable to open the database file */
#define SQLITE_PROTOCOL    15   /* Database lock protocol error */
#define SQLITE_EMPTY       16   /* (Internal Only) Database table is empty */
#define SQLITE_SCHEMA      17   /* The database schema changed */
#define SQLITE_TOOBIG      18   /* Too much data for one row of a table */
#define SQLITE_CONSTRAINT  19   /* Abort due to contraint violation */
#define SQLITE_MISMATCH    20   /* Data type mismatch */
#define SQLITE_MISUSE      21   /* Library used incorrectly */
#define SQLITE_NOLFS       22   /* Uses OS features not supported on host */
#define SQLITE_AUTH        23   /* Authorization denied */
#define SQLITE_ROW         100  /* sqlite_step() has another row ready */
#define SQLITE_DONE        101  /* sqlite_step() has finished executing */
            

4.6. 예제 프로그램

지금까지의 내용들을 이용해서 sqlite 데이터 베이스에 연결해서 데이터를 가져오는 간단한 프로그램을 만들어 보도록 하겠다.

#include <stdio.h>
#include <sqlite.h>

static int callback(void *NU, int argc, char **argv, char **azColName)
{
    int i;
    for (i = 0; i < argc; i++)
    {
        printf ("%s = %s\n", azColName[i], argv[i] ? argv[i] : "NULL");
    }
    printf("\n");
    return 0;
}
int main(int argc, char **argv)
{
    sqlite *db;
    char *ErrMsg = 0;
    int rc;

    if (argc != 3)
    {
        fprintf(stderr, "Usge : ./testsql [dbname] [query]\n");
        exit(0);
    }
    db = sqlite_open(argv[1], 0, &ErrMsg);
    if (db == 0)
    {
        fprintf(stderr, "Cant open database ; %s\n", ErrMsg);
        exit(0);
    }
    rc = sqlite_exec(db, argv[2], callback, 0, &ErrMsg);
    if (rc != SQLITE_OK)
    {
        fprintf(stderr, "SQL error : %d\n", ErrMsg);
    }
    sqlite_close(db);
    return 0;
}
            

# gcc -o testsql testsql.c -L/usr/local/lib -lsqlite
            

# ./testsql test.db "select * from test"
name = yundream
age = 19

name = hello
age = 22
# ./testsql test.db "insert into test values(\"kknd\", 56);"
# ./testsql test.db "select * from test"
name = yundream
age = 19

name = hello
age = 22

name = kknd
age = 56