Function lmdb_master_sys::mdb_dbi_close

source ·
pub unsafe extern "C" fn mdb_dbi_close(
    env: *mut MDB_env,
    dbi: MDB_dbi,
)
Expand description

Close a database handle. Normally unnecessary. Use with care:

This call is not mutex protected. Handles should only be closed by a single thread, and only if no other threads are going to reference the database handle or one of its cursors any further. Do not close a handle if an existing transaction has modified its database. Doing so can cause misbehavior from database corruption to errors like MDB_BAD_VALSIZE (since the DB name is gone).

Closing a database handle is not necessary, but lets #mdb_dbi_open() reuse the handle value. Usually it’s better to set a bigger #mdb_env_set_maxdbs(), unless that value would be large.

§Arguments

  • env (direction in) - An environment handle returned by #mdb_env_create()
  • dbi (direction in) - A database handle returned by #mdb_dbi_open()