DB_ENV 　　 *dbenv;           // 环境句柄
DB　　　　  *dbp;             // 数据库句柄
DBT 　　　　key, value;       // 纪录结构
DBC 　　　　*cur;            // 游标结构

typedef struct {
     void *data;          // 数据buf
     u_int32_t size;     // 数据大小
     u_int32_t ulen;     //
     u_int32_t dlen;     // 数据长度
     u_int32_t doff;     // 数据开始处
     u_int32_t flags;     
} DBT;

DB_ENV *dbenv;
db_env_create(&dbenv, 0);                     // 创建数据库环境句柄
dbenv->open(dbenv, path, flags, 0);          // 打开数据库环境, path是环境的目录路径, flag参数参考下面介绍
dbenv->close(dbenv, 0);                      // 关闭数据库环境
dbenv->err(dbenv, ret, formart, ...);        // 错误调试

DB_CREATE               // 打开的环境不存在的话就创建它
DB_THREAD               // 支持线程
DB_INIT_MPOOL         // 初始化内存中的cache
DB_INIT_CDB

DB* dbp; 
db_create(&dbp, dbenv, 0);                                            // 获取数据库句柄
dbp->open(dbp, NULL, filename, NULL, DB_BTREE, flags, 0);　　　　　　　 
dbp->close(&dbp, 0);                                                  // 在关闭数据库前，先关闭所有打开的游标
dbp->sync(dbp, 0)                                                     // 刷新cache，同步到磁盘，close操作会隐含调用该过程
dbp->remove(dbp, filename, NULL, 0)                              　　 // 移除数据库，不要移除已打开的数据库
dbp->rename(dbp, oldname, NULL, newname, 0)                　　　　　　// 数据库重命名，不要重命名已打开的数据库
 
dbp->put(dbp, NULL, &key, &data, DB_NOOVERWRITE);      　　　　　　　　// DB_NOOVERWRITE不允许重写已存在的key
dbp->get(dbp, NULL, &key, &data, flags);                             // 如果存在key重复的记录，只返回第一个，或者使用游标
dbp->del(dbp, NULL, &key, 0);                                        // 删除指定key的记录
dbp->truncate(dbp, NULL, u_int32_t* count, 0);                   　　 // 删除所有记录，count中返回被删除的记录个数
dbp->get_open_flags(dbp, &open_flags);                          　 　// 获取打开的flags，仅对已打开的数据库才有意义
dbp->set_flags(dbp, flags);                                          // 设置打开的flags

DB_CREATE　　//如果打开的数据库不存在，就创建它；不指定这个标志，如果数据库不存在，打开失败！
DB_EXC　　　　//与DB_CREATE一起使用，如果打开的数据库已经存在，则打开失败；不存在，则创建它；
DB_RDONLY　　//只读的方式打开，随后的任何写操作都会失败；
DB_TRUNCATE　　//清空对应的数据库磁盘文件；
DB_DUPSORT 　　//

DBC  *cur;
dbp->cursor(dbp, NULL, &cur, 0);              // 初始化游标对象
cur->close(cur);                              // 关闭游标
cur->get(cur, &key, &data, flags);            // 迭代记录，当没有可迭代的记录时，返回DB_NOTFOUND
cur->put(cur, &key, &data, flags);
cur->del(cur, 0);                             // 删除游标指向的记录

DB_NEXT　　　　// 从第一条纪录遍历到最后一条纪录；
DB_PREV　　　　// 逆序遍历，从最后一条纪录开始；

DB_SET　　　　　　　　　　// 移动游标到键值等于给定值的第一条纪录；
DB_SET_RANGE　　　　　　// 如果数据库使用BTREE的算法，移动游标到键值大于或等于给定值的纪录集合；
DB_GET_BOTH　　　　　　// 移动游标到键值和数据项均等于给定值的第一条记录；
DB_GET_BOTH_RAGNE　　 // 移动游标到键值等于给定值，数据项大于或等于给定值的纪录集合；
 
DB_NEXT_DUP　　　　　　// 获取下一个key重复的记录；
DB_PREV_DUP　　　　　　// 获取上一个key重复的记录；
DB_NEXT_NODUP　　　　 // 获取下一个key不重复的记录；
DB_PREV_NODUP　　　　// 获取上一个key不重复的记录；

DB_NODUPDATA　　　// 如果插入的key已存在，返回DB_KEYEXIST，如果不存在，则记录的插入顺序由其在数据库的插入顺序决定；
DB_KEYFIRST　　　　// 在key重复的集合里面放在第一个位置；
DB_KEYLAST　　　　// 在key重复的集合里面放在最后一个位置；
DB_CURRENT　　　　// replace

primary_dbp->associate(primary_dbp, NULL, second_dbp, key_creator, 0);
int key_creator(DB* dbp, const DBT* pkey, const DBT* pdata, DBT* skey);

DB *dbp, *sdbp;     /* Primary and secondary DB handles */
u_int32_t flags;    /* Primary database open flags */
int ret;            /* Function return value */

typedef struct vendor {
    char name[MAXFIELD]; 　　　　　　　 /* Vendor name */
    char street[MAXFIELD]; 　　　　　　 /* Street name and number */
    char city[MAXFIELD]; 　　　　　　　 /* City */
    char state[3]; 　　　　　　　　　　　/* Two-digit US state code */
    char zipcode[6]; 　　　　　　　　　　/* US zipcode */
    char phone_number[13]; 　　　　　　/* Vendor phone number */
    char sales_rep[MAXFIELD]; 　　　　 /* Name of sales representative */
    char sales_rep_phone[MAXFIELD];  /* Sales rep‘s phone number */
} VENDOR;

/* Primary */
ret = db_create(&dbp, NULL, 0); 
if (ret != 0) {
    /* Error handling goes here */
}

/* Secondary */
ret = db_create(&sdbp, NULL, 0); 
if (ret != 0) {
    /* Error handling goes here */
}

/* Usually we want to support duplicates for secondary databases */
ret = sdbp->set_flags(sdbp, DB_DUPSORT);
if (ret != 0) {
    /* Error handling goes here */
}

/* Database open flags */
flags = DB_CREATE; /* If the database does not exist, create it.*/

/* open the primary database */
ret = dbp->open(dbp, NULL, "my_db.db", NULL, DB_BTREE, flags, 0); 
if (ret != 0) {
    /* Error handling goes here */
}

/* open the secondary database */
ret = sdbp->open(sdbp, NULL, "my_secdb.db", NULL, DB_BTREE, flags, 0); 
if (ret != 0) {
    /* Error handling goes here */
}

/* Callback used for key creation. Not defined in this example. See the next section. */
int get_sales_rep(DB *sdbp,   /* secondary db handle */
        const DBT *pkey, 　　 /* primary db record‘s key */
        const DBT *pdata, 　　/* primary db record‘s data */
        DBT *skey) 　　　　　　/* secondary db record‘s key */
{
    VENDOR *vendor;

    /* First, extract the structure contained in the primary‘s data */
    vendor = pdata->data;

    /* Now set the secondary key‘s data to be the representative‘s name */
    memset(skey, 0, sizeof(DBT));
    skey->data = vendor->sales_rep;
    skey->size = strlen(vendor->sales_rep) + 1;

    /* Return 0 to indicate that the record can be created/updated. */
    return (0);
}


/* Now associate the secondary to the primary */
dbp->associate(dbp, NULL, sdbp, get_sales_rep, 0);