Berkeley DB的c语言接口

像MySQL这类基于C/S结构的关系型数据库系统虽然代表着目前数据库应用的主流，但却并不能满足所有应用场合的需要。有时我们需要的可能只是一个简单的基于磁盘文件的数据库系统。这样不仅可以避免安装庞大的数据库服务器，而且还可以简化数据库应用程序的设计。Berkeley DB正是基于这样的思想提出来的。


　　Berkeley DB简介


　　Berkeley DB是一个开放源代码的内嵌式数据库管理系统，能够为应用程序提供高性能的数据管理服务。应用它程序员只需要调用一些简单的API就可以完成对数据的访问和管理。与常用的数据库管理系统（如MySQL和Oracle等）有所不同，在Berkeley DB中并没有数据库服务器的概念。应用程序不需要事先同数据库服务建立起网络连接，而是通过内嵌在程序中的Berkeley DB函数库来完成对数据的保存、查询、修改和删除等操作。


　　Berkeley DB为许多编程语言提供了实用的API接口，包括C、C++、Java、Perl、Tcl、Python和PHP等。所有同数据库相关的操作都由Berkeley DB函数库负责统一完成。这样无论是系统中的多个进程，或者是相同进程中的多个线程，都可以在同一时间调用访问数据库的函数。而底层的数据加锁、事务日志和存储管理等都在Berkeley DB函数库中实现。它们对应用程序来讲是完全透明的。俗话说：“麻雀虽小五脏俱全。”Berkeley DB函数库本身虽然只有300KB左右，但却能够用来管理多达256TB的数据，并且在许多方面的性能还能够同商业级的数据库系统相抗衡。就拿对数据的并发操作来说，Berkeley DB能够很轻松地应付几千个用户同时访问同一个数据库的情况。此外，如果想在资源受限的嵌入式系统上进行数据库管理，Berkeley DB可能就是惟一正确的选择了。


　　Berkeley DB作为一种嵌入式数据库系统在许多方面有着独特的优势。首先，由于其应用程序和数据库管理系统运行在相同的进程空间当中，进行数据操作时可以避免繁琐的进程间通信，因此耗费在通信上的开销自然也就降低到了极低程度。其次，Berkeley DB使用简单的函数调用接口来完成所有的数据库操作，而不是在数据库系统中经常用到的SQL语言。这样就避免了对结构化查询语言进行解析和处理所需的开销。


　　基本概念


　　Berkeley DB简化了数据库的操作模式，同时引入了一些新的基本概念，从而使得访问和管理数据库变得相对简单起来。在使用Berkeley DB提供的函数库编写数据库应用程序之前，有必要先了解以下这些基本概念。


　　关键字和数据


　　关键字（Key）和数据（Data）是Berkeley DB用来进行数据库管理的基础，由这两者构成的Key/Data对（见表1）组成了数据库中的一个基本结构单元，而整个数据库实际上就是由许多这样的结构单元所构成的。通过使用这种方式，开发人员在使用Berkeley DB提供的API来访问数据库时，只需提供关键字就能够访问到相应的数据。


　　|　Key　 |　Data　　|
　　|　sport　|　football |
　　|　Fruit　|　orange　 |
　　|　Drink　|　beer　　 |


　　表1 Key/Data对


　　如果想将第一行中的“sport”和“football”保存到Berkeley DB数据库中，可以调用Berkeley DB函数库提供的数据保存接口。此时“sport”和“football”将分别当成关键字和数据来看待。之后如果需要从数据库中检索出该数据，可以用“sport”作为关键字进行查询。此时Berkeley DB提供的接口函数会返回与之对应的数据“football”。


　　关键字和数据在Berkeley DB中都是用一个名为DBT的简单结构来表示的。实际上两者都可以是任意长度的二进制数据，而DBT的作用主要是保存相应的内存地址及其长度，其结构如下所示：


typedef struct
{
　　void *data;
　　u_int32_t size;
　　u_int32_t ulen;
　　u_int32_t dlen;
　　u_int32_t doff;
　　u_int32_t flags;
} DBT;




　　在使用Berkeley DB进行数据管理时，缺省情况下是一个关键字对应于一个数据，但事实上也可以将数据库配置成一个关键字对应于多个数据。


　　对象句柄


　　在Berkeley DB函数库定义的大多数函数都遵循同样的调用原则：首先创建某个结构，然后再调用该结构中的某些方法。从程序设计的角度来讲，这一点同面向对象的设计原则是非常类似的，即先创建某个对象的一个实例，然后再调用该实例的某些方法。正因如此，Berkeley DB引入了对象句柄的概念来表示实例化后的结构，并且将结构中的成员函数称为该句柄的方法。


　　对象句柄的引入使得程序员能够完全凭借面向对象的思想，来完成对Berkeley DB数据库的访问和操作，即使当前使用的是像C这样的结构化语言。例如，对于打开数据库的操作来说，可以调用DB的对象句柄所提供的open函数，其原型如下所示：


int DB->open(DB *db, DB_TXN *txnid, const char *file, const char *database, DBTYPE type, u_int32_t flags, int mode);




　　错误处理


　　对于任何一个函数库来说，如何对错误进行统一的处理都是需要考虑的问题。Berkeley DB提供的所有函数都遵循同样的错误处理原则，即函数成功执行后返回零，否则的话则返回非零值。


　　对于系统错误（如磁盘空间不足和访问权限不够等），返回的是一个标准的值；而对于非系统错误，返回的则是一个特定的错误编码。例如，如果在数据库中没有与某个特定关键字所对应的数据，那么在通过该关键字检索数据时就会出现错误。此时函数的返回值将是DB_NOTFOUND，表示所请求的关键字并没有在数据库中出现。所有标准的errno值都是大于零的，而由Berkeley DB定义的特殊错误编码则都是小于零的。


　　要求程序员记住所有的错误代号既不现实也没有什么实际意义，因为Berkeley DB提供了相应的函数来获得错误代号所对应的错误描述。一旦有错误发生，只需首先调用db_strerror()函数来获得错误描述信息，然后再调用DB->err()或DB->errx()就可以很轻松地输出格式化后的错误信息。


　　应用统一的编程接口


　　使用Berkeley DB提供的函数来进行数据库的访问和管理并不复杂，在大多数场合下只需按照统一的接口标准进行调用就可以完成最基本的操作。


　　打开数据库


　　打开数据库通常要分两步进行：首先调用db_create()函数来创建DB结构的一个实例，然后再调用DB->open()函数来完成真正的打开操作。Berkeley DB将所有对数据库的操作都封装在名为DB的结构中。db_create()函数的作用就是创建一个该结构，其原型如下所示：


typedef struct__db DB;
int db_create(DB **dbp, DB_ENV *dbenv, u_int32_t flags);




　　将磁盘上保存的文件作为数据库打开是由DB->open()函数来完成的，其原型如下所示：


int DB->open(DB *db, DB_TXN *txnid, const char *file, const char *database, DBTYPE type, u_int32_t flags, int mode);




　　下面这段代码示范了如何创建DB对象句柄及如何打开数据库文件：


＃i nclude <stdio.h>
＃i nclude <sys/types.h>
＃i nclude <stdlib.h>
＃i nclude <string.h>
＃i nclude <db.h>
#define DATABASE "demo.db"


/* 以下程序代码的程序头同此＊/
int main()
{
　　DB *dbp;
　　int ret;
　　if ((ret = db_create(&dbp, NULL, 0)) != 0)
　　{
　　　　fprintf(stderr, "db_create: %s\n", db_strerror(ret));
　　　　exit (1);
　　}
　　if ((ret = dbp->open(dbp, NULL, DATABASE, NULL, DB_BTREE, DB_CREATE, 0664)) != 0)
　　{
　　　　dbp->err(dbp, ret, "%s", DATABASE);
　　　　exit (1);
　　}
}




　　代码首先调用db_create()函数来创建一个DB对象句柄。变量dbp在调用成功后将成为数据库句柄，通过它可以完成对底层数据库的配置或访问。接下去调用DB->open()函数打开数据库文件，参数“DATABASE”指明对应的磁盘文件名为demo.db；参数“DB_BTREE”表示数据库底层使用的数据结构是B树；而参数“DB_CREATE”和“0664”则表明当数据库文件不存在时创建一个新的数据库文件，并且将该文件的属性值设置为0664。


　　错误处理是在打开数据库时必须的例行检查，这可以通过调用DB->err()函数来完成。其中参数“ret”是在调用Berkeley DB函数后返回的错误代码，其余参数则用于显示结构化的错误信息。


　　添加数据


　　向Berkeley DB数据库中添加数据可以通过调用DB->put()函数来完成，其原型如下所示：


int DB->put(DB *db, DB_TXN *txnid, DBT *key, DBT *data, u_int32_t flags);




　　下面这段代码示范了如何向数据库中添加新的数据：


int main()
{
　　DB *dbp;
　　DBT key, data;
　　int ret;
　　if ((ret = db_create(&dbp, NULL, 0)) != 0)
　　{
　　　　fprintf(stderr, "db_create: %s\n", db_strerror(ret));
　　　　exit (1);
　　}
　　if ((ret = dbp->open(dbp, NULL, DATABASE, NULL, DB_BTREE, DB_CREATE, 0664)) != 0)
　　{
　　　　dbp->err(dbp, ret, "%s", DATABASE);
　　　　exit (1);
　　}
　　memset(&key, 0, sizeof(key));
　　memset(&data, 0, sizeof(data));
　　key.data = "sport";
　　key.size = sizeof("sport");
　　data.data = "football";
　　data.size = sizeof("football");
　　if ((ret = dbp->put(dbp, NULL, &key, &data, 0)) == 0)
　　　　printf("db: %s: key stored.\n", (char *)key.data);
　　else
　　　　dbp->err(dbp, ret, "DB->put");
}




　　代码首先声明了两个DBT结构变量，并分别用字符串“sport”和“football”进行填充。它们随后作为关键字和数据传递给用来添加数据的DB->put()函数。DBT结构几乎会在所有同数据访问相关的函数中被用到。


　　在向数据库中添加数据时，如果给定的关键字已经存在，大多数应用会对于已经存在的数据采用覆盖原则。也就是说，如果数据库中已经保存了一个“sport/basketball”对，再次调用DB->put()函数添加一个“sport/football”对，那么先前保存的那些数据将会被覆盖。但Berkeley DB允许在调用DB->put()函数时指定参数“DB_NOOVERWRITE”，声明不对数据库中已经存在的数据进行覆盖，其代码如下：


if ((ret = dbp->put(dbp, NULL, &key, &data, DB_NOOVERWRITE)) == 0)
　　printf("db: %s: key stored.\n", (char *)key.data);
else
　　dbp->err(dbp, ret, "DB->put");




　　一旦给出“DB_NOOVERWRITE”标记，如果DB->put()函数在执行过程中发现给出的关键字在数据库中已经存在了，就无法成功地把该Key/Data对添加到数据库中，于是将返回错误代号“DB_KEYEXIST”。


　　检索数据


　　从Berkeley DB数据库中检索数据可以通过调用DB->get()函数来完成，其原型如下所示：


int DB->get(DB *db, DB_TXN *txnid, DBT *key, DBT *data, u_int32_t flags);




　　下面这段代码示范了如何从数据库中检索出所需的数据：


int main()
{
　　DB *dbp;
　　DBT key, data;
　　int ret;
　　if ((ret = db_create(&dbp, NULL, 0)) != 0)
　　{
　　　　fprintf(stderr, "db_create: %s\n", db_strerror(ret));
　　　　exit (1);
　　}
　　if ((ret = dbp->open(dbp, NULL, DATABASE, NULL, DB_BTREE, DB_CREATE, 0664)) != 0)
　　{
　　　　dbp->err(dbp, ret, "%s", DATABASE);
　　　　exit (1);
　　}
　　memset(&key, 0, sizeof(key));
　　memset(&data, 0, sizeof(data));
　　key.data = "sport";
　　key.size = sizeof("sport");
　　if ((ret = dbp->get(dbp, NULL, &key, &data, 0)) == 0)
　　　　printf("db: %s: key retrieved: data was %s.\n", (char *)key.data, (char *)data.data);
　　else
　　　　dbp->err(dbp, ret, "DB->get");
}




　　代码同样声明了两个DBT结构变量，并且调用memset()函数对它们的内容清空。虽然Berkeley DB并不强制要求在进行数据操作之前先清空它们，但出于提高代码质量考虑还是建议先进行清空操作。在进行数据检索时，对DB->get()函数的返回值进行处理是必不可少的，因为它携带着检索操作是否成功完成等信息。下面列出的是DB->get()函数的返回值：


　　◆ 0 函数调用成功，指定的关键字被找到；


　　◆ DB_NOTFOUND 函数调用成功，但指定的关键字未被找到；


　　◆大于0 函数调用失败，可能出现了系统错误。


　　删除数据


　　从Berkeley DB数据库中删除数据可以通过调用DB->del()函数来完成，其原型如下所示：


int DB->del(DB *db, DB_TXN *txnid, DBT *key, u_int32_t flags);




　　下面这段代码示范了如何从数据库中删除数据：


int main()
{
　　DB *dbp;
　　DBT key;
　　int ret;
　　if ((ret = db_create(&dbp, NULL, 0)) != 0)
　　{
　　　　fprintf(stderr, "db_create: %s\n", db_strerror(ret));
　　　　exit (1);
　　}
　　if ((ret = dbp->open(dbp, NULL, DATABASE, NULL, DB_BTREE, DB_CREATE, 0664)) != 0)
　　{
　　　　dbp->err(dbp, ret, "%s", DATABASE);
　　　　exit (1);
　　}
　　memset(&key, 0, sizeof(key));
　　key.data = "sport";
　　key.size = sizeof("sport");
　　if ((ret = dbp->del(dbp, NULL, &key, 0)) == 0)
　　　　printf("db: %s: key was deleted.\n", (char *)key.data);
　　else
　　　　dbp->err(dbp, ret, "DB->del");
}




　　删除数据只需给出相应的关键字，不用指明与之对应的数据。


　　关闭数据库


　　对于一次完整的数据库操作过程来说，关闭数据库是不可或缺的一个环节。这是因为Berkeley DB需要依赖于系统底层的缓冲机制，也就是说只有在数据库正常关闭的时候，修改后的数据才有可能全部写到磁盘上，同时它所占用的资源也才能真正被全部释放。关闭数据库的操作是通过调用DB->close()函数来完成的，其原型如下所示：


int DB->close(DB *db, u_int32_t flags);




　　下面这段代码示范了如何在需要的时候关闭数据库：


int main()
{
　　DB *dbp;
　　DBT key, data;
　　int ret, t_ret;
　　if ((ret = db_create(&dbp, NULL, 0)) != 0)
　　{
　　　　fprintf(stderr, "db_create: %s\n", db_strerror(ret));
　　　　exit (1);
　　}
　　if ((ret = dbp->open(dbp, NULL, DATABASE, NULL, DB_BTREE, DB_CREATE, 0664)) != 0)
　　{
　　　　dbp->err(dbp, ret, "%s", DATABASE);
　　　　goto err;
　　}
　　memset(&key, 0, sizeof(key));
　　memset(&data, 0, sizeof(data));
　　key.data = "sport";
　　key.size = sizeof("sport");
　　if ((ret = dbp->get(dbp, NULL, &key, &data, 0)) == 0)
　　　　printf("db: %s: key retrieved: data was %s.\n", (char *)key.data, (char *)data.data);
　　else
　　　　dbp->err(dbp, ret, "DB->get");
　　if ((t_ret = dbp->close(dbp, 0)) != 0 && ret == 0)
　　　　ret = t_ret;
　　exit(ret);
}