引言
关于Mysql，大家都已经非常熟悉了。但是这种C/S的数据服务不适合于一些轻量级的应用，很多情况下，我们希望能使用一个进程级的存储引擎，供我们查询一些关系数据，而非使用一套臃肿的服务。当然这时我们可以选择SqlLite，Berkeley DB，Access等轻量级的存储件，但是都有学习成本，我们能否采用我们已经非常熟悉的Mysql接口来实现呢？答案是肯定的，很多人可能不知道：Mysql其实可以将服务以library的形式编译，供程序单独使用，这样我们的程序相当于内联了一套Mysql服务。
编译
我们以linux下的编译为例介绍编译Embedded Mysql的步骤。
Mysql 5.0版本的编译
在Mysql 5.0及之前版本，都是采用autobuild工具编译，config时的参数可以如下配置：
./configure --prefix=/home/work/mysql --with-embedded-server--with-mysqld-ldflags--with-mysqld-ldflags=-all-static--enable-thread-safe-client --enable-local-infile
--with-extra-charsets=complex--disable-shared
上面的参数中：
--prefix=/home/work/mysql 指定安装位置，可以根据自己的需要设置到其他目录。
--with-embedded-server是编译embedded mysql的关键，这个参数默认是不开启的，因此一般只会编译出libmysqlclient.a(.so)这个客户端API库，而开启此参数后，会多生成一个libmysqld.a(.so)的库，这个库同时集成了mysql服务与客户端API。
--with-mysqld-ldflags=-all-static与--disable-shared两个参数表示只编译静态库，如果需要使用动态库，也可以去掉这两个参数。
-enable-thread-safe-client表示客户端API应该保持线程安全(但貌似Mysql 5.0有bug，即使开启此参数，有时也非线程安全)。
--with-extra-charsets=complex 表示支持大字符集。
configure完成之后：
$ make
$ make install
即可以完成编译。
Mysql 5.5之后的版本编译
mysql 5.5之后的版本都迁移到采用cmake进行编译，因此机器需要先安装cmake，关于cmake的安装，在此不做介绍，可以参考：
安装cmake之后，可以用下面的命令编译
cmake . -DWITH_EMBEDDED_SERVER=1 -DCMAKE_INSTALL_PREFIX=/home/work/mysql -DCMAKE_BUILD_TYPE=Release
上面的参数中：
-DCMAKE_INSTALL_PREFIX指定安装位置，与5.0中的--prefix对应。
-DDWITH_EMBEDDED_SERVER表示将编译Embedded Mysql库，与5.0中的--with-embedded-server对应。
-DCMAKE_BUILD_TYPE表示生成库的方式，它有以下几种选项：
1. RelWithDebInfo 带调试信息，开启编译优化的库，编译参数为-O2 -g
2. Debug带调试信息，不做任何编译优化的库，编译参数-g
3. Release 不带调试信息，编译优化的库，编译参数-O2
4. MinSizeRel不带调试信息，最小size的库，编译参数-Os
Mysql5.5之后的版本编出的库都是线程安全的，所以不需要类似-enable-thread-safe-client的参数
是否带调试信息对生成出库的大小影响很大，例如Debug库编译出来有70多兆，而Release编译出来只有不到20MB，如果不需要调试，建议已Release编译。
Embedded Mysql使用方法
我们编写如下代码(test.cpp)进行测试：
#include
#include
#include
#include
int main()
{
MYSQL* sql;
MYSQL_STMT* stmt;
MYSQL_BIND bind;
unsigned* indice;
int ret;
int result;
unsigned long length;
char query1[] = "create database if not exists mydb";
char query2[] = "use mydb";
char query3[] = "create table if not exists mytable (id int not null, col int not
null)";
char query4[] = "insert into mytable (id, col) values (1,100)";
char query5[] = "select col from mytable where id = ?";
char *server_options[] = { "","--defaults-file=f","--basedir=./"};
int num_elements = sizeof(server_options)/ sizeof(char *);
if(mysql_server_init(num_elements, server_options, NULL))
{
puts("failed to initialize server");
return 1;
}
sql = mysql_init(NULL);
if(!mysql_real_connect(sql, NULL , NULL , NULL , NULL, 3306, NULL, 0))
printf("failed to connect\n");
if(mysql_query(sql, query1))
printf("failed to create database:%s\n", mysql_error(sql));
ret = mysql_query(sql, query2);
if(ret)
printf("failed to use database:%s\n", mysql_error(sql));
ret = mysql_query(sql, query3);
if(ret)
printf("failed to create table:%s\n", mysql_error(sql));
ret = mysql_query(sql, query4);
if(ret)
printf("failed to insert record:%s\n", mysql_error(sql));
stmt = mysql_stmt_init(sql);
if(!stmt)
printf("failed to init stmt:%s\n", mysql_error(sql));
ret = mysql_stmt_prepare(stmt, query5, strlen(query5));
if(ret)
printf("failed to prepare:%s\n", mysql_stmt_error(stmt));
result = 1;
memset(&bind, 0 , sizeof(bind));
bind.buffer_type = MYSQL_TYPE_LONG;
bind.is_unsigned = (my_bool)0;
bind.is_null = 0;
bind.buffer = (char*)&result;
bind.buffer_length = 4;
bind.length = &length;
ret = mysql_stmt_bind_param(stmt, &bind);
if(ret)
printf("failed to bind param:%s\n", mysql_stmt_error(stmt));
ret = mysql_stmt_execute(stmt);
if(ret)
printf("failed to execute stmt:%s\n", mysql_stmt_error(stmt));
memset(&bind, 0 , sizeof(bind));
bind.buffer_type = MYSQL_TYPE_LONG;
bind.is_unsigned = (my_bool)0;
bind.is_null = 0;
bind.buffer = (char*)&result;
bind.buffer_length = 4;
bind.length = &length;
ret = mysql_stmt_bind_result(stmt, &bind);
if(ret)
printf("failed to bind result:%s\n", mysql_stmt_error(stmt));
ret = mysql_stmt_store_result(stmt);
if(ret)
printf("failed to store result:%s\n", mysql_stmt_error(stmt));
ret = mysql_stmt_fetch(stmt);
if(ret)
printf("failed to fetch result:%s\n", mysql_stmt_error(stmt));
mysql_stmt_close(stmt);
mysql_close(sql);
mysql_server_end();
return 0;
}
从代码我们可以看出，使用embedded mysql的方法与使用一般的mysql API基本一致，但是需要在使用前后初始化库与清理环境，分别调用mysql_server_init()与mysql_server_end()这两个函数。其中，mysql_server_init中可以指定mysql服务的配置文件f以及数据生成的位置(也可以不在init中配置数据目录，在f文件中配置数据目录)。
相比正式的mysql服务，embedded mysql的f只支持[server]与[embedded]这两节配置，我们可以在当前目录下创建一个类似下面的f：
[server]
language=/home/work/mysql/share/english
datadir==./data
[embedded]
language==/home/work/mysql/share/english
注意：上面的配置文件中，datadir指定mysql数据保存的位置(注意：该目录必须在程序启动前已存在，如果不存在需要提前手工创建，否则会启动失败)。language这个选项相当重要，它指定的是服务端与客户端各种错误信息的资源文件。我们可以在mysql安装目录的share目录下找到多种语言的资源文件，一般采用share/english/errmsg.sys即可(既可以直接将language指向这个目录，也可以将这个文件拷贝至当前目录下，然后将language指向目录设为./)。
配置好f之后，我们如下编译：
$ g++ test.cpp -o a.out -I/home/work/mysql/include -L/home/work/mysql/lib -lmysqld
如果编译了动态链接库，生成的执行文件可能不能正常运行，需要在LD_LIBRARY_PATH中导出libmysqld.so的位置：
$ export LD_LIBRARY_PATH=/home/work/mysql/lib:$LD_LIBRARY_PATH
编译生成a.out，执行即可查询。
注意事项
embedded mysql目前只能使用inno-db引擎，它会在datadir指定的目录下生成数据库文件，每个database用一个目录保存，我们也可以将这些数据库目录拷贝到真正的mysql服务的数据目录中，使用mysql工具进行查询(注意：如果这么操作，mysql服务必须重启)。
关于Mysql 5.5的bug
本节是我在使用embedded mysql过程中发现的一些bug，这些bug至少在Mysql 5.5.15版本中存在，我已向Mysql社区反映，在官方修复之前，建议在编译之前修改下面一些文件：
bug1：会导致多线程下的内存泄漏
在libmysqld/源代码的256行:
stmt->fields= mysql->fields;
之后添加：
free_root(&stmt->mem_root, MYF(0));
bug2：会导致多线程下的内存泄漏
在libmysqld/的356行(stmt->result= *data;语句之前)加：
if(stmt->result.alloc.free != (*data).alloc.free ||
stmt->result.alloc.pre_alloc != (*data).alloc.pre_alloc)
{
free_root(&stmt->result.alloc, MYF(0));
}
bug3：会导致某些查询失败
在libmysqld/的346行:
if (res)
{
NET *net= &stmt->mysql->net;
set_stmt_errmsg(stmt, net);
DBUG_RETURN(1);
}
之后，添加下面两行代码：
else if (stmt->mysql->status==MYSQL_STATUS_GET_RESULT)
stmt->mysql->status= MYSQL_STATUS_STATEMENT_GET_RESULT;
结论
使用Embedded Mysql方案可以尽可能少的改动我们的代码，兼容Mysql服务，实现轻量级的关系数据库存储。
其他
