Table.update()
Applies to an OJAI document the updates that are contained in a
DocumentMutation
object.
Operations Performed
- If a document with the ID does not exist, returns an error.
- If a document with the ID does exist, applies a mutation to the document.
Example
- Original document
-
{ "_id" : "movie0000001", "title" : "OJAI -- The Documentary", "studio" : "MapR Technologies, Inc.", "release_date" : "2015-09-29", "trailers" : { "teaser" : "https://10.10.21.90/trailers/teaser", "theatrical" : "https://10.10.21.90/trailers/theatrical" }, "characters" : [ "Heroic Developer", "Evil Release Manager", "Mad Development Manager" ], "box_office_gross" : 1000000000L }
- Example code for the update
-
public DocumentMutation buildDocumentMutation() { return MapRDB.newDocumentMutation() .increment("box_office_gross", 1000000000L); } public void update(String tablePath, DocumentMutation mutation, String _id) { try(Table table = MapRDB.getTable(tablePath)) { table.update(_id, mutation); } }
Parameter Description _id
The value of the document's _id
field.tablePath
The path of the table in the MapR file system. See Table Paths. - Revised document with the change in bold
-
{ "_id" : "movie0000001", "title" : "OJAI -- The Documentary", "studio" : "MapR Technologies, Inc.", "release_date" : "2015-09-29", "trailers" : { "teaser" : "https://10.10.21.90/trailers/teaser", "theatrical" : "https://10.10.21.90/trailers/theatrical" }, "characters" : [ "Heroic Developer", "Evil Release Manager", "Mad Development Manager" ], "box_office_gross" : 2000000000L }
Permissions Required
- The
writeAce
permission on the volumes where the JSON tables that contain the documents are located. For information about how to set permissions on volumes, see Setting/Modifying Whole Volume ACEs. writeperm
on the column families in the row. See How to Obtainreadperm
orwriteperm
on a Field.