Once a database has been opened, records may be retrieved (DB->get()), stored (), and deleted (DB->del()).

Additional operations supported by the database handle include statistics (), truncation (DB->truncate()), version upgrade (), verification and salvage (DB->verify()), flushing to a backing file (), and association of secondary indices (DB->associate()). Database handles are eventually closed using .

For more information on the access method operations supported by the database handle, see the Database and Related Methods section in the Berkeley DB C API Reference Guide.

Database open

The method opens a database, and takes five arguments:

file

The name of the file to be opened.

database

type

The type of database to open. This value will be one of the five access methods Berkeley DB supports: DB_BTREE, DB_HASH, DB_HEAP, DB_QUEUE or DB_RECNO, or the special value DB_UNKNOWN, which allows you to open an existing file without knowing its type.

mode

The permissions to give to any created file.

There are a few flags that you can set to customize open:

DB_CREATE

Create the underlying database and any necessary physical files.

Do not map this database into process memory.

Treat the data base as read-only.

DB_THREAD

The returned handle is free-threaded, that is, it can be used simultaneously by multiple threads within the process.

Physically truncate the underlying database file, discarding all databases it contained. Underlying filesystem primitives are used to implement this flag. For this reason it is only applicable to the physical file and cannot be used to discard individual databases from within physical files.

Upgrade the database format as necessary.