Please use the form below to provide your feedback. Because your feedback is valuable to us, the information you submit in this form is recorded in our issue tracking system (JIRA), which is publicly available. You can track the status of your feedback using the ticket number displayed in the dialog once you submit the form.

Function: Advanced Sub-Document MUTATEIN Array Operation

    March 23, 2025
    + 12

    Perform the Advanced Sub-Document MUTATEIN operation on an array where Eventing interacts with the Data Service.

    The advancedMutateInArray function:

    • Demonstrates the CAS-free Sub-Document MUTATEIN operation on a document array field

    • Requires Eventing Storage (or a metadata collection) and a source collection

    • Requires a binding of type bucket alias

    • Operates on any mutation where the meta.id or KEY is combine_landmark_names

    For example, you can generate an input document with the KEY combine_landmark_names and the DATA { "id": "combine_landmark_names", "landmark_names": [] }, then set the number of workers in the Eventing Function’s setting to 18. Running the Function adds 4,495 landmark names to an array without conflict and in no particular order.

    For more information about the Advanced Sub-Document MUTATEIN operation, see Sub-Document MUTATEIN Operation.

    javascript
    Copy
    // Configure the settings for the advancedMutateInArray function as follows:
//
// Version 7.6+
//   "Function Scope"
//     *.* (or try bulk.data if non-privileged)
//   "Listen to Location"
//     travel-sample.inventory.landmark
//   "Eventing Storage"
//     rr100.eventing.metadata
//   Binding(s)
//    1. "binding type", "alias name...", "bucket.scope.collection", "Access"
//       "bucket alias", "dst_col",       "bulk.data.source",        "read and write"

function OnUpdate(doc, meta) {
 var accum_meta = {"id": "combine_landmark_names" };
 couchbase.mutateIn(dst_col, accum_meta, [
    couchbase.MutateInSpec.arrayAppend("landmark_names", doc.name),
  ]);
}