Skip to main content

C++ of the Day #43 - SQLite3 C++ wrapper #1

The Definitive Guide to SQLite를 읽다가 공부 겸 해서 C++ wrapper를 만들어 보았습니다. 최대한 C++ 냄새(?)가 나도록 만들어 보았습니다. :-) ((SQLite는 복잡한 관리가 필요없이 사용가능한, 파일이나 메모리 기반의, 라이브러리로 제공되는, 약 250kb 용량의, 대부분의 SQL92문을 지원하는, open source RDB입니다.))
이 wrapper를 사용하기 위해서는 (당연하게도!) sqlite3와 (당연하게도?) boost 라이브러리가 필요합니다.
사용 예들을 살펴보는 것으로 설명을 대신합니다.
이번 글에서는 다음과 같은 contacts 테이블이 test.db에 존재한다고 가정합니다.
CREATE TABLE contacts
(
id INTEGER PRIMARY KEY,
name TEXT NOT NULL,
phone TEXT NOT NULL,
UNIQUE(name, phone)
);

Command

먼저 test.db 파일을 사용하기 위해 다음과 같이 파일 이름을 주어 connection 객체를 생성합니다. 생성과 동시에 test.db와 연결이 이루어집니다. ((생성자외에 open() 함수를 사용할 수도 있습니다.))
sqlite3pp::connection conn("test.db");
다음은 contacts 테이블에 정보를 추가하는 가장 간단한 방법입니다. connection 클래스에서 제공하는 execute 함수를 사용합니다. ((executef 함수를 사용하면 printf와 같은 문법을 사용하여 query문을 작성할 수 있습니다.))
conn.execute("INSERT INTO contacts (name, phone) VALUES ('user', '1234')");
위와 동일한 작업을 parameterized query를 사용하여 할 수도 있습니다. ((step()함수가 실제 query문을 수행하는 함수입니다. run()과 같은 이름을 사용할까 했으나 sqlite에서 사용하는 이름을 그대로 사용하기로 하였습니다.))
sqlite3pp::command cmd(conn, "INSERT INTO contacts (name, phone) VALUES (?, ?)");
cmd.bind(1, "user");
cmd.bind(2, "1234");
cmd.step();
// or
sqlite3pp::command cmd(conn, "INSERT INTO contacts (name, phone) VALUES (:name, :phone)");
cmd.bind(":name", "user");
cmd.bind(":phone", "1234");
cmd.step();
같은 query문(command 객체)을 재사용하려면 cmd.reset() 함수 호출후에 원하는 필드만 다른 값으로 binding하여 다시 step() 함수를 호출하면 됩니다.
위의 코드 중 두 줄로 된 binding 작업은 다음과 같이 left shift operator를 사용하여 한 줄로 작성이 가능합니다.
cmd.binder() << "user" << "1234";

Query

이제 select를 사용하여 데이터를 읽는 방법에 대해서 알아보도록 하겠습니다. 이 경우 command 클래스 대신 query 클래스를 사용합니다. ((query 클래스는 command 클래스를 상속받은 클래스로 record fetch 에 필요한 함수나 클래스, iterator등을 추가로 제공합니다.))
sqlite3pp::connection conn("test.db");

sqlite3pp::query qry(conn, "SELECT id, phone, name FROM contacts");
먼저 column name을 가지고 헤더를 출력하려면 다음과 같이 column_name() 함수를 사용합니다.
for (int i = 0; i < qry.column_count(); ++i) {
cout << qry.column_name(i) << "\t";
}
다음으로 한 record씩 읽어오기 위해 query 클래스가 제공하는 iterator를 사용합니다. 각 record에서 column의 값을 읽어오는 방법에는 몇 가지가 있는데 하나씩 살펴보죠. 먼저 각 column의 타입을 모른다면 다음과 같이 무조건 char const* 타입으로 받아 출력하는 방법을 사용할 수 있습니다. ((char const* 타입 대신 std::string 타입을 사용할 수도 있습니다. 하지만 std::string 타입을 사용할 경우 sqlite 내부 버퍼에 있는 text 데이터가 std::string 객체로 복사되는 비용이 추가로 발생합니다.))
for (sqlite3pp::query::iterator i = qry.begin(); i != qry.end(); ++i) {
for (int j = 0; j < qry.column_count(); ++j) {
cout << (*i).get(j) << "\t"; // type conversion is done by sqlite
}
cout << endl;
}
다음으로 각 column의 타입을 알고 있다면 right shift operator 문법을 사용할 수 있습니다.
int id;
std::string name, phone;

for (sqlite3pp::query::iterator i = qry.begin(); i != qry.end(); ++i) {
(*i).getter() >> id >> name >> phone;
cout << id << "\t" << name << "\t" << phone << endl;
}
마지막으로 boost::tuple을 사용하는 방법도 제공합니다.
for (sqlite3pp::query::iterator i = qry.begin(); i != qry.end(); ++i) {
boost::tie(id, name, phone) =
(*i).get_columns(0, 1, 2);
cout << id << "\t" << name << "\t" << phone << endl;
}
boost::tuple을 사용하면 원하는 column들을 쉽게 선택할 수 있다는 장점이 있습니다. 예를 들어 위의 코드에서 name과 phone 정보만 필요하다면 다음과 같이 할 수 있습니다.
boost::tie(name, phone) = (*i).get_columns(1, 2);
// now, int type and 0 index are dropped.
물론 right shift operator를 사용하는 방법에도 원하는 column만을 선택할 수 있는 방법이 있습니다. 원하지 않는 column의 자리에 sqlite3pp::ignore를 사용하면 됩니다.
(*i).getter() >> sqlite3pp::ignore >> name >> phone; // id value is not fetched at all.

Transaction

위에 있는 모든 query문들은 autocommit 모드로 동작을 합니다. 한 구문이 한번씩 commit을 사용하는 것이죠. 여러개의 구문을 하나의 transaction으로 묶기 위해서는 transaction 객체를 사용합니다.
{
sqlite3pp::transaction xct(conn); // begin transaction with default rollback option.

sqlite3pp::command cmd(conn, "INSERT INTO contacts (name, phone) VALUES (?, ?)");

cmd.binder() << "user" << "1234";
if (SQLITE_DONE != cmd.step())
return; // end transaction with rollback

cmd.reset(); // reuse cmd object.

cmd.binder() << "user" << "5678";
if (SQLITE_DONE != cmd.step())
return; // end transaction with rollback

xct.commit(); // end transaction with commit
}
transaction 객체는 RAII를 사용하여 destructor에서 commit 모드에 따라 commit이나 rollback을 하게 됩니다. 물론 명시적으로 commit이나 rollback이 호출된 경우에는 destructor에서 아무 동작도 하지 않습니다. 위의 코드는 기본 모드로 rollback을 사용하고 있으나 다음과 같이 commit을 기본 모드로 설정할 수 있습니다.
sqlite3pp::transaction xct(conn, true);

Download

현재까지 작성한 코드로 위에 나온 내용들은 모두 구현되어 있습니다. Sqlite3pp.zip 앞으로 sqlite3의 extension과 callback 인터페이스들에 대한 C++ wrapping을 추가할 계획입니다. :-)

Comments

  1. 정말 좋은 wrapper 라이브러리네요 ㅎㅇㅎ;

    잘 쓸께요 ㅎㅇㅎㅋ

    ReplyDelete
  2. 매우 깔끔하네요.
    이것저것 찾아다니가가 SQLite라는 걸 알게 됐는데...
    지금은 Sqlite3pp를 사용하진 않지만 나중에 꼭 공부해보고 싶네요.

    소스 공개 감사드려요^^~

    ReplyDelete
  3. Sometimes you need to change parameters in select clauses as well.

    Like so:

    "select * from blah where id between ? and ?"

    How would you do that in sqlite3pp?

    ReplyDelete

Post a Comment

Popular posts from this blog

1의 개수 세기

저도 간단한 알고리즘 문제 하나... :-)

어떤 수 n이 주어졌을때 1~n까지의 수를 쭈욱 썼을때 나오는 1의 개수를 구하는 문제입니다.

예를 들어 13이라는 수가 주어지면 1~13까지의 수 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13에서 1은 1, 10, 11, 12, 13에 나오며 그 개수는 6이 됩니다. 즉, f(13)=6.

원래 문제는 f(n)=n이 되는 1이 아닌 가장 작은 수를 구하는 문제인데 이 문제의 경우에는 처음부터 쭈욱 세어나가면 되기 때문에 간단히 다음과 같이 구현을 하면 됩니다. ((한가지 주의할 점은 이전에 찾았던 n-1값을 사용하지 않고 다시 처음부터 n까지 값을 계산하면 시간이 너무 많이 걸린다는 점입니다. 위의 코드에서는 static 변수를 사용하여 이전 값에 계속 더해나가는 방법을 사용했습니다.))


#include

int count1(int n)
{
static int cnt = 1; // not 0 because n starts from 2. see main.

while (n > 0) {
if ((n % 10) == 1) ++cnt;
n /= 10;
}

return cnt;
}

int main()
{
using namespace std;

int n = 2;

while (count1(n) != n) ++n;
cout << n << endl;
}


좀 재미가 없죠? 그래서 이번 문제는 어떤 수 n에 대해서 f(n)을 O(1)시간에 구하는 알고리즘을 만드는 것입니다. 관심있으신 분들은 한번 풀어보세요. 제가 만든 코드는 내일 올려보겠습니다.

C++ of the Day #9 - Boost.Python 사용하기 #1

Python은 가장 인기있는 interpret 언어중의 하나입니다. Python의 장점 중 하나는 C/C++ 모듈과 쉽게 연동할 수 있다는 점입니다. 물론 손으로 일일히 wrapper를 만드는 것은 손이 많이 가고 에러를 만들수 있는 작업이나 SWIG등과 같은 도구를 사용하면 쉽게 python 모듈을 만들 수 있습니다.

Boost.Python은 이런 SWIG와 같이 python 모듈을 쉽게 만들 수 있도록 도와주는 라이브러리로 순수 C++만을 사용한다는 점이 SWIG와 다른 점입니다. 그리고 개인적으로는 Boost 라이브러리에 포함되어 있는 것들이 왠지 좀 더 믿음직스러워서... :-)

이번 글에서는 Boost.Python 문서에 나와 있는 예제를 가지고 간단하게 python 모듈을 만드는 방법에 대해서 알아보겠습니다.

Requirements리눅스
이 글에서는 리눅스 환경에서의 사용 방법을 설명한다.Boost.Python 라이브러리 (1.33.1)
Boost 라이브러리를 다운로드받아 아래와 유사한 명령으로 라이브러리를 빌드한다.
bjam -sTOOLS=gcc -with-python install

bjam의 --prefix 옵션으로 라이브러리가 설치될 위치를 변경할 수 있다.Python 라이브러리 (2.4.3)
Python을 다운로드 받아 빌드하여 설치한다.
위의 경우와 유사하게 configure의 --prefix 옵션으로 설치될 위치를 변경할 수 있다.

Write C++ Code다음과 같이 코드를 작성한다.

// greet.cpp #include <stdexcept> char const* greet(unsigned x) { static char const* const msgs[] = { "hello", "Boost.Python", "world!" }; if (x > 2) throw std::range_error("greet: index out of range"…

Hello Wordpress, again.

한 두주일 정도 Textpattern을 사용해봤는데 다시 Wordpress로 돌아오기로 결정했습니다. 무엇보다 스킨 변경이 너무 복잡하고 사용자층이 Wordpress에 비해 너무 앏네요. 원하는 plugin도 찾기 어렵고... :-|

그동안 Textpattern에 썼던 글들은 모두 Wordpress로 옮겼습니다. 2개 있던 댓글도 옮겼는데 그중의 하난 제가 쓴... ;-)

애초에 wp-dokuwiki plugin이 무거워서 옮겼던 것이라 이 plugin은 설치를 안할 예정인데 몇가지 아쉬운 점이 있네요.

첫째는 code highlighting 기능인데 이 기능은 예전에 만들어 놨던 것을 조금 수정해서 쓰려고 준비중입니다. 두번째는 Footnote 기능인데 찾아보니 Footnotes 0.9 Plugin for WordPress 2.0.x라는게 있네요.

이정도면 비록 wiki syntax에 비할바는 아니지만 쓸만할 것 같습니다. :-)