NAME

MongoDB::Database - A Mongo Database

ATTRIBUTES

name

The name of the database.

METHODS

collection_names

my @collections = $database->collection_names;

Returns the list of collections in this database.

get_collection ($name)

my $collection = $database->get_collection('foo');

Returns a MongoDB::Collection for the collection called $name within this database.

get_gridfs ($prefix?)

my $grid = $database->get_gridfs;

Returns a MongoDB::GridFS for storing and retrieving files from the database. Default prefix is "fs", making $grid-files> "fs.files" and $grid-chunks> "fs.chunks".

drop

$database->drop;

Deletes the database.

last_error

my $err = $db->last_error;

Queries the database to check if the last operation caused an error.

run_command ($command)

my $result = $database->run_command({ some_command => 1 });

Runs a command for this database on the mongo server. Throws an exception with an error message if the command fails. Returns the result of the command on success. For a list of possible database commands, see http://www.mongodb.org/display/DOCS/Table+of+Database+Commands.

eval ($code, $args?)

my $result = $database->eval('function(x) { return "hello, "+x; }', ["world"]);

Evaluate a JavaScript expression on the Mongo server.

Useful if you need to touch a lot of data lightly; in such a scenario the network transfer of the data could be a bottleneck. The $code argument must be a JavaScript function. $args is an array of parameters that will be passed to the function. For more examples of using eval see http://www.mongodb.org/display/DOCS/Server-side+Code+Execution#Server-sideCodeExecution-Using{{db.eval%28%29}}.

AUTHOR

Kristina Chodorow <kristina@mongodb.org>