berkeley DB

[翻译]Berkeley DB内存池相关API-- 8. DB_ENV->set_mp_max_write

Linkman的学习记录 — Thu, 18 Jan 2007 13:46:00 GMT

DB_ENV->set_mp_max_write

#include <db.h>

int

DB_ENV->set_mp_max_write(DB_ENV *env, int maxwrite, int maxwrite_sleep);

int

DB_ENV->get_mp_max_write(DB_ENV *env, int *maxwritep, int *maxwrite_sleepp);

描述： DB_ENV->set_mp_max_write

DB_ENV->set_mp_max_write 方法限定了将脏页从缓冲区写回文件的顺序写操作数量。

DB_ENV->set_mp_max_write 方法返回非0的错误值，0表示成功。

参数

maxwrite

将脏页从缓冲区写回文件的顺序写操作数量的最大值，0表示不限制。

maxwrite_sleep

在线程进行新的写操作前需要休眠的毫秒数。

错误

DB_ENV->set_mp_max_write 方法可能失败，返回如下非0值：

EINVAL

标志或参数非法

描述： DB_ENV->get_mp_max_write

DB_ENV->get_mp_max_write 方法返回将脏页从缓冲区写回文件的顺序写操作数量，以及等待的时间。

DB_ENV->get_mp_max_write 方法可以在应用程序的生命周期的任何时间被调用。

DB_ENV->get_mp_max_write 方法返回非0的错误值，0表示成功。

参数

maxwritep

将脏页从缓冲区写回文件的顺序写操作数量的最大值。

maxwrite_sleepp

在线程进行新的写操作前需要休眠的毫秒数。

类

DB_ENV, DB_MPOOLFILE

另见

内存池和相关方法

[翻译]Berkeley DB内存池相关API-- 7. DB_ENV->set_mp_max_openfd

Linkman的学习记录 — Thu, 18 Jan 2007 13:44:00 GMT

DB_ENV->set_mp_max_openfd

#include <db.h>

int

DB_ENV->set_mp_max_openfd(DB_ENV *env, int maxopenfd);

int

DB_ENV->get_mp_max_openfd(DB_ENV *env, int *maxopenfdp);

描述： DB_ENV->set_mp_max_openfd

DB_ENV->set_mp_max_openfd 方法限定了缓冲区并发打开的文件数。

DB_ENV->set_mp_max_openfd 方法返回非0的错误值，0表示成功。

参数

maxopenfd

将页刷回文件时的缓冲区并发打开的文件数最大数。

错误

DB_ENV->set_mp_max_openfd 方法可能失败，返回如下非0值：

EINVAL

标志或参数非法

描述： DB_ENV->get_mp_max_openfd

DB_ENV->get_mp_max_openfd 方法返回打开的最大文件数。

DB_ENV->get_mp_max_openfd 方法可以在应用程序的生命周期的任何时间被调用。

DB_ENV->get_mp_max_openfd 方法返回非0的错误值，0表示成功。

参数

maxopenfdp

DB_ENV->get_mp_max_openfd 方法maxopenfdp返回打开的最大文件数。

类

DB_ENV, DB_MPOOLFILE

另见

内存池和相关方法

[翻译]Berkeley DB内存池相关API-- 6. DB_ENV->set_cachesize

Linkman的学习记录 — Thu, 18 Jan 2007 13:42:00 GMT

DB_ENV->set_cachesize

#include <db.h>

int

DB_ENV->set_cachesize(DB_ENV *dbenv,

u_int32_t gbytes, u_int32_t bytes, int ncache);

int

DB_ENV->get_cachesize(DB_ENV *dbenv,

u_int32_t *gbytesp, u_int32_t *bytesp, int *ncachep);

描述： DB_ENV->set_cachesize

设置共享内存缓冲池的尺寸。缓冲区的尺寸应当满足应用程序的正常工作需要的工作集，还需要为特殊情况下预留一些尺寸。（注意：工作集与同时访问的页面数的概念不一样，工作集一般情况下要大得多）

缺省的缓冲区尺寸是256KB，不能够小于20KB。所有小于500MB的缓冲区被自动增加25%的大小。而尺寸大于500MB则精确指定。在32位的操作系统中，最大的单个缓冲区的尺寸为4GB，而在64位系统上，值为10TB。（所有的尺寸都是2的幂，比如，256KB是2的18次幂而不是256000）。为了详细了解Berkeley BD如何应如何调整缓冲区尺寸，请见“选缓冲区尺寸”。

可能在某些架构和操作系统上，Berkeley DB不能申请连续的大尺寸缓冲区。比如，在某些版本的Solaris上处理器就限制了能被申请的连续空间的尺寸。如果ncache是0或1，则缓冲区将被申请为一段连续的空间，如果大于1，则缓冲区被平分为数量为ncache的多块内存。

数据库环境的缓冲区尺寸还可以通过环境配置文件DB_CONFIG进行配置。在该文件中以字符串“set_cachesize”开始，一个或多个空格字符，而缓冲区尺寸包括以下三部分：缓冲区的GB部分、字节部分、以及块数，同样由空格隔开。例如： “set_cachesize 2 524288000 3” 应当建立一个2.5GB的逻辑缓冲区，缓冲区被分为3个物理块。因为DB_CONFIG文件是在数据库环境被打开时读入，它将覆盖那些在它之前执行的配置过程。

DB_ENV->set_cachesize 方法配置数据库环境，而不是只处理由DB_ENV 指定的句柄。

DB_ENV->set_cachesize 方法在DB_ENV->open 方法调用后不应当再被调用。如果在执行DB_ENV->open时数据库环境已存在，被DB_ENV->set_cachesize设定的值将会被忽略。

DB_ENV->set_cachesize 方法返回非0的错误值，0表示成功。

参数

bytes

缓冲区的总尺寸为gbytes GB + bytes。

gbytes

缓冲区的总尺寸为gbytes GB + bytes。

ncache

ncache 参数为缓冲区的块数。

错误

DB_ENV->set_cachesize 方法可能错误，返回如下的非0错误号：

EINVAL

指定的缓冲区尺寸太小，或者是在DB_ENV->open 之后被调用，或者带有不正确的标志，或参数不正确。

描述： DB_ENV->get_cachesize

DB_ENV->get_cachesize 方法返回缓冲区的尺寸。

DB_ENV->get_cachesize 方法可以在应用程序的生命周期的任何时间被调用。

DB_ENV->get_cachesize 方法返回非0的错误值，0表示成功。

参数

bytesp

缓冲区的总尺寸为gbytes GB + bytes。

gbytesp

缓冲区的总尺寸为gbytes GB + bytes。

ncachep

ncache 参数为缓冲区的块数。

类

DB_ENV

另见

数据库环境和相关方法

[翻译]Berkeley DB内存池相关API-- 5. DB_ENV->memp_register

Linkman的学习记录 — Thu, 18 Jan 2007 13:41:00 GMT

DB_ENV->memp_register

#include <db.h>

int

DB_ENV->memp_register(DB_ENV *env, int ftype,

int (*pgin_fcn)(DB_ENV *, db_pgno_t pgno, void *pgaddr, DBT *pgcookie),

int (*pgout_fcn)(DB_ENV *, db_pgno_t pgno, void *pgaddr, DBT *pgcookie));

描述： DB_ENV->memp_register

DB_ENV->memp_register 方法在指定的内存池中为类型为ftype的文件为注册页读/写处理函数。

如果pgin_fcn 函数非空，它在每次类型为ftype的文件将页从磁盘文件页读到内存池时被调用。或者是在类型为ftype的页被创建时被调用（见DB_MPOOLFILE->get的DB_MPOOL_CREATE标志）。

如果pgout_fcn 函数非空，则每个类型为ftype的文件在写回到文件前被调用。

DB_ENV->memp_register 函数的目的是为了支持那些在页读入内存池或写回文件时进行处理。例如：该函数可以在页读/写时进行拉丁字节转换。

为了可能在多线程或多进程共享内存池时，让每个线程或进程的页能与其它的页进行区分，需要指定特别的文件类型。在初始化时，应用程序应当调用DB_ENV->memp_register为每种需要共享内存池的文件注册页读/写处理过程。（标准的Berkeley DB访问方式不需要注册函数，因为DB->open 已单独地注册了它们）。

如果线程或进程不为某文件类型调用DB_ENV->memp_register，就不能处理内存池的页读写处理。因为这个原因，DB_ENV->memp_register总是被每个共享内存池的每种文件的每个应用程序调用，不管该应用是否使用使用该类型的文件。

DB_ENV->memp_register 方法返回非0的错误值，0表示成功。

参数

ftype

ftype 参数指定了需要进行页读/写的文件类型。

ftype 的值应当是一个小于128的非0整数值。（0和负数被Berkeley DB内部保留）。

pgin_fcn

pgout_fcn

类

DB_ENV, DB_MPOOLFILE

另见

内存池和相关方法

[翻译]Berkeley DB内存池相关API-- 4. DB_ENV->memp_trickle

Linkman的学习记录 — Wed, 17 Jan 2007 15:14:00 GMT

DB_ENV->memp_trickle

#include <db.h>

int

DB_ENV->memp_trickle(DB_ENV *env, int percent, int *nwrotep);

描述: DB_ENV->memp_trickle

DB_ENV->memp_trickle 方法使得内存池中指定的百分比的页被清空并被写入到对应有文件中。

DB_ENV->memp_trickle 函数的目的是允许内存池管理者确保总有足够多的可用页，以用来读新信息，而不需要等待写入。

DB_ENV->memp_trickle 方法返回非0错误，0表示成功。

参数

nwrotep

当指定的百分比达到时，nwrotep指定需保存的页数

percent

percent 参数是确定多少页页面需要被清空。

错误

DB_ENV->memp_trickle 方法失误时返回非0的错误号：

EINVAL

非法参数。

类

DB_ENV, DB_MPOOLFILE

另见

内存池和相关方法

[翻译]Berkeley DB内存池相关API-- 3. DB_ENV->memp_sync

Linkman的学习记录 — Wed, 17 Jan 2007 15:03:00 GMT

DB_ENV->memp_sync

#include <db.h>

int

DB_ENV->memp_sync(DB_ENV *env, DB_LSN *lsn);

描述: DB_ENV->memp_sync

DB_ENV->memp_sync 方法将缓冲区中已改变的页写入到对应的文件中。

在内存池中的页不会直接被写回到磁盘文件中（例如：该页当前被其它线程使用），而是等到他们能够被写回到磁盘。

为了支持DB_ENV->memp_sync 的功能性，内存池函数知道每一种文件类型的日记顺序号的位置。位置应当在打开时通过DB_MPOOLFILE->set_lsn_offset 方法指定。不需要考虑日记顺序号在页中以何处方式被对齐。

DB_ENV->memp_sync 方法返回非常的错误值，返回0表示成功。

参数

lsn

lsn 参数的目的是支持事务管理者确认（作为检查点的一部分）所有被修改的页面被已被写入到磁盘。

所有具有一个日志顺序号（DB_LSN）的被修改的页，以及所有小于该LSN参数的数据将被写入磁盘。如果lsn 为空，则所有被改动的页将被写入到磁盘。

类

DB_ENV, DB_MPOOLFILE

另见

内存池和相关方法