Options for retrieving a collection checksum.
If set to true
, document data will be included in the calculation
of the checksum.
Default: false
If set to true
, revision IDs will be included in the calculation
of the checksum.
Default: false
Options for dropping collections.
Whether the collection is a system collection. If the collection is a
system collection, this option must be set to true
or ArangoDB will
refuse to drop the collection.
Default: false
Result of retrieving edges in a collection.
Options for bulk importing documents into a collection.
If set to true
, the import will abort if any error occurs.
Whether the response should contain additional details about documents that could not be imported.
(Edge collections only.) Prefix to prepend to _from
attribute values.
Controls behavior when a unique constraint is violated.
"error"
: the document will not be imported."update
: the document will be merged into the existing document."replace"
: the document will replace the existing document."ignore"
: the document will not be imported and the unique constraint
error will be ignored.Default: "error"
If set to true
, the collection is truncated before the data is imported.
Default: false
(Edge collections only.) Prefix to prepend to _to
attribute values.
Whether to wait for the documents to have been synced to disk.
Result of a collection bulk import.
Number of new documents imported.
Additional details about any errors encountered during the import.
Number of empty documents.
Whether the import failed.
Number of documents that failed with an error.
Number of documents that failed with an error that is ignored.
Number of documents updated.
Options for inserting a new document into a collection.
If set to true
, a document with the same _key
or _id
already
existing will be overwritten instead of resulting in an exception.
Defines what should happen if a document with the same _key
or _id
already exists, instead of throwing an exception.
If set to true
, the complete new document will be returned as the new
property on the result object. Has no effect if silent
is set to true
.
Default: false
If set to true
, no data will be returned by the server. This option can
be used to reduce network traffic.
Default: false
If set to true
, data will be synchronized to disk before returning.
Default: false
An object defining the collection's key generation.
Unless set to false
, documents can be created with a user-specified
_key
attribute.
Default: true
(Autoincrement only.) How many steps to increment the key each time.
(Autoincrement only.) Initial offset for the key.
Type of key generator to use.
An object defining the collection's key generation.
Whether documents can be created with a user-specified _key
attribute.
(Autoincrement only.) How many steps to increment the key each time.
Most recent key that has been generated.
(Autoincrement only.) Initial offset for the key.
Type of key generator to use.
General information about a collection.
A globally unique identifier for this collection.
Collection name.
An integer indicating the collection loading status.
An integer indicating the collection type.
An object defining the properties of a collection.
(Enterprise Edition cluster only.) If set to a collection name, sharding of the new collection will follow the rules for that collection. As long as the new collection exists, the indicated collection can not be dropped.
(MMFiles only.) Whether the collection will be compacted.
(MMFiles only.) Number of buckets into which indexes using hash tables are split.
(MMFiles only.) If set to true
, the collection will only be kept
in-memory and discarded when unloaded, resulting in full data loss.
(MMFiles only.) Maximum size for each journal or datafile in bytes.
An object defining the collection's key generation.
(Cluster only.) Write concern for this collection.
(Cluster only.) Number of shards of this collection.
(Cluster only.) Replication factor of the collection.
(Cluster only.) Keys of this collection that will be used for sharding.
(Cluster only.) Sharding strategy of the collection.
(Enterprise Edition cluster only.) Attribute containing the shard key value of the referred-to smart join collection.
A human-readable representation of the collection loading status.
Properties for validating documents in the collection.
Whether data should be synchronized to disk before returning from a document create, update, replace or removal operation.
(Cluster only.) Write concern for this collection.
Options for setting a collection's properties.
See DocumentCollection.properties and EdgeCollection.properties.
(MMFiles only.) Maximum size for each journal or datafile in bytes.
Must be a number greater than or equal to 1048576
(1 MiB).
Options for validating documents in this collection.
Whether data should be synchronized to disk before returning from a document create, update, replace or removal operation.
Options for retrieving a document from a collection.
If set to true
, the request will explicitly permit ArangoDB to return a
potentially dirty or stale result and arangojs will load balance the
request without distinguishing between leaders and followers.
If set to true
, null
is returned instead of an exception being thrown
if the document does not exist.
Options for removing a document from a collection.
If set to true
, the complete old document will be returned as the old
property on the result object. Has no effect if silent
is set to true
.
Default: false
If set to true
, no data will be returned by the server. This option can
be used to reduce network traffic.
Default: false
If set to true
, changes will be synchronized to disk before returning.
Default: false
Options for replacing an existing document in a collection.
If set to false
, the existing document will only be modified if its
_rev
property matches the same property on the new data.
Default: true
If set to true
, the complete new document will be returned as the new
property on the result object. Has no effect if silent
is set to true
.
Default: false
If set to true
, the complete old document will be returned as the old
property on the result object. Has no effect if silent
is set to true
.
Default: false
If set to true
, no data will be returned by the server. This option can
be used to reduce network traffic.
Default: false
If set to true
, data will be synchronized to disk before returning.
Default: false
Options for updating a document in a collection.
If set to false
, the existing document will only be modified if its
_rev
property matches the same property on the new data.
Default: true
If set to false
, properties with a value of null
will be removed from
the new document.
Default: true
If set to false
, object properties that already exist in the old
document will be overwritten rather than merged. This does not affect
arrays.
Default: true
If set to true
, the complete new document will be returned as the new
property on the result object. Has no effect if silent
is set to true
.
Default: false
If set to true
, the complete old document will be returned as the old
property on the result object. Has no effect if silent
is set to true
.
Default: false
If set to true
, no data will be returned by the server. This option can
be used to reduce network traffic.
Default: false
If set to true
, data will be synchronized to disk before returning.
Default: false
Options for creating a collection.
See Database.createCollection, Database.createEdgeCollection and {@link Collection.create}.
(Enterprise Edition cluster only.) If set to a collection name, sharding of the new collection will follow the rules for that collection. As long as the new collection exists, the indicated collection can not be dropped.
(MMFiles only.) Whether the collection will be compacted.
Default: true
(Cluster only.) Unless set to false
, the server will check whether
enough replicas are available at creation time and bail out otherwise.
Default: true
(MMFiles only.) Number of buckets into which indexes using hash tables are split.
Must be a power of 2 and less than or equal to 1024
.
Default: 16
(MMFiles only.) If set to true
, the collection will only be kept
in-memory and discarded when unloaded, resulting in full data loss.
Default: false
(MMFiles only.) Maximum size for each journal or datafile in bytes.
Must be a number greater than or equal to 1048576
(1 MiB).
An object defining the collection's key generation.
(Cluster only.) Write concern for this collection.
(Cluster only.) Number of shards to distribute the collection across.
Default: 1
(Cluster only.) How many copies of each document should be kept in the cluster.
Default: 1
(Cluster only.) Document attributes to use to determine the target shard for each document.
Default: ["_key"]
(Cluster only.) Sharding strategy to use.
(Enterprise Edition cluster only.) Attribute containing the shard key value of the referred-to smart join collection.
Options for validating documents in the collection.
If set to true
, data will be synchronized to disk before returning from
a document create, update, replace or removal operation.
Default: false
(Cluster only.) Unless set to false
, the server will wait for all
replicas to create the collection before returning.
Default: true
(Cluster only.) Write concern for this collection.
Type of key generator.
Strategy for sharding a collection.
Options for retrieving all documents in a collection.
Number of result values to be transferred by the server in each network roundtrip (or "batch").
Must be greater than zero.
See also QueryOptions.
Maximum number of documents to return.
Number of documents to skip in the query.
If set to true
, the query will be executed as a streaming query.
See also QueryOptions.
Time-to-live for the cursor in seconds. The cursor results may be garbage collected by ArangoDB after this much time has passed.
See also QueryOptions.
Options for retrieving documents by example.
Number of result values to be transferred by the server in each network roundtrip (or "batch").
Must be greater than zero.
See also QueryOptions.
Maximum number of documents to return.
Number of documents to skip in the query.
Time-to-live for the cursor in seconds. The cursor results may be garbage collected by ArangoDB after this much time has passed.
See also QueryOptions.
Options for performing a fulltext query.
Unique identifier of the fulltext index to use to perform the query.
Maximum number of documents to return.
Number of documents to skip in the query.
Type of document reference.
Options for removing documents by example.
Maximum number of documents to return.
If set to true
, the request will wait until all modifications have been
synchronized to disk before returning successfully.
Default: false
Result of removing documents by an example.
See DocumentCollection.removeByExample and EdgeCollection.removeByExample.
Number of documents removed.
Options for removing documents by keys.
If set to true
, the complete old document will be returned as the old
property on the result object. Has no effect if silent
is set to true
.
Default: false
If set to true
, no data will be returned by the server. This option can
be used to reduce network traffic.
Default: false
If set to true
, the request will wait until all modifications have been
synchronized to disk before returning successfully.
Default: false
Result of removing documents by keys.
See DocumentCollection.removeByKeys and EdgeCollection.removeByKeys.
Number of documents not removed.
Documents that have been removed.
Number of documents removed.
Options for replacing documents by example.
Result of replacing documents by an example.
See DocumentCollection.replaceByExample and EdgeCollection.replaceByExample.
Number of documents replaced.
Options for updating documents by example.
If set to false
, properties with a value of null
will be removed from
the new document.
Default: true
Maximum number of documents to return.
If set to false
, object properties that already exist in the old
document will be overwritten rather than merged. This does not affect
arrays.
Default: true
If set to true
, the request will wait until all modifications have been
synchronized to disk before returning successfully.
Default: false
Result of updating documents by an example.
See DocumentCollection.updateByExample and EdgeCollection.updateByExample.
Number of documents updated.
Options for performing a graph traversal.
Direction of the traversal, relative to the starting vertex if expander
is not set.
A string evaluating to the body of a JavaScript function to be executed
on the server to use when direction
is not set.
The code has access to three variables: config
, vertex
, path
.
The code must return an array of objects with edge
and vertex
attributes representing the connections for the vertex.
Note: This code will be evaluated and executed on the server inside ArangoDB's embedded JavaScript environment and can not access any other variables.
See the official ArangoDB documentation for
the JavaScript @arangodb
module
for information about accessing the database from within ArangoDB's
server-side JavaScript environment.
A string evaluating to the body of a JavaScript function to be executed on the server to filter nodes.
The code has access to three variables: config
, vertex
, path
.
The code may include a return statement for the following values:
"exclude"
: The vertex will not be visited."prune"
: The edges of the vertex will not be followed.""
or undefined
: The vertex will be visited and its edges followed.Note: This code will be evaluated and executed on the server inside ArangoDB's embedded JavaScript environment and can not access any other variables.
See the official ArangoDB documentation for
the JavaScript @arangodb
module
for information about accessing the database from within ArangoDB's
server-side JavaScript environment.
A string evaluating to the body of a JavaScript function to be executed on the server to initialize the traversal result object.
The code has access to two variables: config
, result
.
The code may modify the result
object.
Note: This code will be evaluated and executed on the server inside ArangoDB's embedded JavaScript environment and can not access any other variables.
See the official ArangoDB documentation for
the JavaScript @arangodb
module
for information about accessing the database from within ArangoDB's
server-side JavaScript environment.
Item iteration order.
If specified, only nodes in at most this depth will be visited.
Maximum number of iterations before a traversal is aborted because of a potential endless loop.
If specified, only nodes in at least this depth will be visited.
Traversal order.
A string evaluating to the body of a JavaScript function to be executed
on the server to sort edges if expander
is not set.
The code has access to two variables representing edges: l
, r
.
The code must return -1
if l < r
, 1
if l > r
or 0
if both
values are equal.
Note: This code will be evaluated and executed on the server inside ArangoDB's embedded JavaScript environment and can not access any other variables.
See the official ArangoDB documentation for
the JavaScript @arangodb
module
for information about accessing the database from within ArangoDB's
server-side JavaScript environment.
Traversal strategy.
Specifies uniqueness for vertices and edges.
A string evaluating to the body of a JavaScript function to be executed on the server when a node is visited.
The code has access to five variables: config
, result
, vertex
,
path
, connected
.
The code may modify the result
object.
Note: This code will be evaluated and executed on the server inside ArangoDB's embedded JavaScript environment and can not access any other variables.
See the official ArangoDB documentation for
the JavaScript @arangodb
module
for information about accessing the database from within ArangoDB's
server-side JavaScript environment.
When a validation should be applied.
"none"
: No validation."new"
: Newly inserted documents are validated."moderate"
: New and modified documents are validated unless the modified
document was already invalid."strict"
: New and modified documents are always validated.Options for validating collection documents.
When validation should be applied.
Default: "strict"
Message to be used if validation fails.
JSON Schema description of the validation schema for documents.
Properties for validating documents in a collection.
When validation should be applied.
Message to be used if validation fails.
JSON Schema description of the validation schema for documents.
Type of document validation.
Coerces the given collection name or ArangoCollection object to a string representing the collection name.
Collection name or ArangoCollection object.
Indicates whether the given value represents an ArangoCollection.
A value that might be a collection.
Generated using TypeDoc
import type { DocumentCollection, EdgeCollection, } from "arangojs/collection";
The "collection" module provides collection related types and interfaces for TypeScript.