3 Basic Operations

procedure
( mongo-db-create-collection! db
name
#:capped?capped?
#:sizesize
[ #:maxmax])
→mongo-collection?
db:mongo-db?
name:string?
capped?:boolean?
size:number?
max:(or/c false/c number? )=#f

Creates a new collection in the database and returns a handle to it. Refer to Capped Collections for details on the options.

procedure
( mongo-db-drop-collection! dbname)→bson-document/c
db:mongo-db?
name:string?

Drops a collection from the database.

procedure
( mongo-db-drop db)→bson-document/c
db:mongo-db?

Drops a database from its server.

value
mongo-db-profiling/c :contract?

Defined as (symbols 'none'low'all).

procedure
( mongo-db-profiling db)→mongo-db-profiling/c
db:mongo-db?

Returns the profiling level of the database.

procedure
( set-mongo-db-profiling! dbv)→boolean?
db:mongo-db?
v:mongo-db-profiling/c

Sets the profiling level of the database. Returns #t on success.

procedure
( mongo-db-profiling-info db)→bson-document/c
db:mongo-db?

Returns the profiling information from the database. Refer to Database Profiler for more details.

procedure
( mongo-db-valid-collection? dbname)→boolean?
db:mongo-db?
name:string?

Returns #t if name is a valid collection.

3.3Collections🔗 i

struct
(struct mongo-collection (dbname)
#:extra-constructor-namemake-mongo-collection )
db:mongo-db?
name:string?

A structure representing a Mongo collection.

procedure
( mongo-collection-drop! mc)→void
mc:mongo-collection?

Drops the collection from its database.

procedure
( mongo-collection-valid? mc)→boolean?
mc:mongo-collection?

Returns #t if mc is a valid collection.

procedure
( mongo-collection-full-name mc)→string?
mc:mongo-collection?

Returns the full name of the collection.

procedure
( mongo-collection-find mc
query
[ #:tailable?tailable?
#:slave-okay?slave-okay?
#:no-timeout?no-timeout?
#:selectorselector
#:skipskip
#:limitlimit])
→mongo-cursor?
mc:mongo-collection?
query:bson-document/c
tailable?:boolean? =#f
slave-okay?:boolean? =#f
no-timeout?:boolean? =#f
selector:(or/c false/c bson-document/c )=#f
skip:int32? =0
limit:(or/c false/c int32? )=#f

Performs a query in the collection. Refer to Querying for more details.

If limit is #f, then a limit of 2 is sent. This is the smallest limit that creates a server-side cursor, because 1 is interpreted as -1.

procedure
( mongo-collection-insert-docs! mcdocs)→void
mc:mongo-collection?
docs:(sequenceofbson-document/c )

Inserts a sequence of documents into the collection.

procedure
( mongo-collection-insert-one! mcdoc)→void
mc:mongo-collection?
doc:bson-document/c

Insert an document into the collection.

procedure
( mongo-collection-insert! mcdoc...)→void
mc:mongo-collection?
doc:bson-document/c

Inserts any number of documents into the collection.

procedure
( mongo-collection-remove! mcsel)→void
mc:mongo-collection?
sel:bson-document/c

Removes documents matching the selector. Refer to Removing for more details.

procedure
( mongo-collection-modify! mcselmod)→void
mc:mongo-collection?
sel:bson-document/c
mod:bson-document/c

Modifies all documents matching the selector according to mod. Refer to Modifier Operations for more details.

procedure
( mongo-collection-replace! mcseldoc)→void
mc:mongo-collection?
sel:bson-document/c
doc:bson-document/c

Replaces the first document matching the selector with obj.

procedure
( mongo-collection-repsert! mcseldoc)→void
mc:mongo-collection?
sel:bson-document/c
doc:bson-document/c

If a document matches the selector, it is replaced; otherwise the document is inserted. Refer to Upserts with Modifiers for more details on using modifiers.

procedure
( mongo-collection-count mc[query])→exact-integer?
mc:mongo-collection?
query:bson-document/c =empty

Returns the number of documents matching the query.

3.3.1Indexing🔗 i

Refer to Indexes for more details on indexing.

procedure
( mongo-collection-index! mcspec[name])→void
mc:mongo-collection?
spec:bson-document/c
name:string? =....

Creates an index of the collection. A name will be automatically generated if not specified.

procedure
( mongo-collection-indexes mc)→mongo-cursor?
mc:mongo-collection?

Queries for index information.

procedure
( mongo-collection-drop-index! mcname)→void
mc:mongo-collection?
name:string?

Drops an index by name.

3.4Cursors🔗 i

Query results are returned as Mongo cursors.

A Mongo cursor is a sequence of BSON documents.

procedure
( mongo-cursor? x)→boolean?
x:any/c

A test for Mongo cursors.

procedure
( mongo-cursor-done? mc)→boolean?
mc:mongo-cursor?

Returns #t if the cursor has no more answers. #f otherwise.

procedure
( mongo-cursor-kill! mc)→void
mc:mongo-cursor?

Frees the server resources for the cursor.

top ← prev up next →