Fluree allows you to specify transactions using FlureeQL, a JSON array/vector syntax which contains subject maps to create, update, upsert or delete. The maximum transaction size is 10 MB.
Transactions can also be done with GraphQL, for more information on GraphQL transactions, reference the GraphQL Transactions section.
Each map requires an
_id as specified below along with key/value pairs containing the predicates
and values you wish to modify. An
_action key is always included, but typically inferred and thus
optional for most operations.
|subject id||Any subject id value which can include the numeric assigned permanent |
|string||Optional (if it can be inferred). One of: |
Every transaction item must have an _id predicate to refer to the subject we are attempting to
create/update. A tempid can simply be the collection name, i.e.
However, if you would like to reference that tempid somewhere else in your transaction,
it is necessary to create a unique tempid. To make a unique tempid, just append the collection
with any non-valid collection character (anything other than a-z, A-Z, 0-9, _) followed by anything
else. For example,
"fullName": "Louis Eliasz",
Adding Custom Metadata
When issuing a transaction, you can include your own metadata. For example, if you want to include
_tx/note, you can issue the below transaction to create the relevant predicate (field):
And, then, whenever you issue a transaction, you are able to include a _tx/note.
"note": "hey there"
Fuel is used to meter usage. Every query and transaction accumulates a certain amount of "fuel." The amount of fuel used is returned in the query or transaction results. Currently, fuel is primarily used as supplemental information.