Create
Create( collection, param_object )
Description
The Create
function adds a new document to a collection. The
collection_ref
parameter indicates in what collection the document
should be created, while param_object
has the document data and
optional metadata.
Parameters
Parameter | Type | Definition and Requirements |
---|---|---|
|
The name, or Reference, of the collection that should have the new
document. A collection Reference can be acquired using the
|
|
|
The |
param_object
Field Name | Field Type | Definition and Requirements |
---|---|---|
|
An object with the fields and values for this document. |
|
|
Optional - The permissions for this document. |
|
|
||
|
Optional - A timestamp that indicates the time-to-live for a document,
which is when the document is removed from the collection and can’t be
queried. The document history can continue to be accessed using
the |
Returns
A document with the data and metadata about the results of the operations.
Field Name | Field Type | Definition and Requirements |
---|---|---|
|
A reference to the created document. |
|
|
The created document data. |
|
|
The timestamp, with microsecond resolution, associated with the creation of the document. |
Examples
The following query creates a document by providing a reference to the
collection "spells" and a param_object
with a data
field. The data
field has the user data to be inserted for this document.
{
ref: Ref(Collection("spells"), "302043888864985600"),
ts: 1624310349250000,
data: { name: 'Mountainous Thunder', element: 'air', cost: 15 }
}
The following query creates a document in the posts
collection with a
defined document ID (using the Ref
function):
{
ref: Ref(Collection("Posts"), "1"),
ts: 1624310598180000,
data: { title: 'The first post' }
}
Is this article helpful?
Tell Fauna how the article can be improved:
Visit Fauna's forums
or email docs@fauna.com
Thank you for your feedback!