Couchbase index: called view -- virtually another document build via map-reduce function

  • Map function:
       Call emit() to generate a key-value pair

  • Reduce function:
       Optional (disabled by reduce=false)
       Used to calculate count, sum etc

 

Query View:

  • Call ViewResult.success() to check whether view execution is successful. Call ViewResult.error()  to see error details

  • Set ViewQuery.debug(true) generate statistics information. Retrieved by  ViewResult.debug()

  • Remember to call ViewQuery.development(true) if a development View has not been published as production view

  • For dev mode, full design doc name is:    _design/dev_[designdoc name],  to query it, just use designdoc name
       If you specify  designdoc name as dev_xxx, you get error:
       com.couchbase.client.java.error.ViewDoesNotExistException: View does not exist
       If you specify designdoc name as  /dev_xxx or  _design/dev_xxx, you get error:
       {"error":"bad_request","reason":"p_w_uploads not supported in Couchbase"}

  • To query composite key, do not use ViewQuery.key(String),  which causes additional quote to be added to the key, add get a json format error:
        invalid UTF-8 JSON  {error,garbage_after_value}
    Uses ViewQuery.key(JsonArray) and JsonArray.from(Object[] array). Each element of array must of correct type (String or Long)

  • To view complete query as url parameter after encoding:  use ViewQuery.toString()

  • Suppose a view composes of 3 field [a, b, c],   it is possible to find documents by  [a, b] only and [a, c] only using that view.  ViewQuery.startKey([a, b, null])  and ViewQuery.startKey([a, null, c])

  • Sort query result:  ViewQuery.desc()

  • References:
    http://docs.couchbase.com/admin/admin/Views/views-writing.html
    http://docs.couchbase.com/admin/admin/Views/views-querySample.html

 

Bulk operations:

  • Couchbase java sdk supports bulk operation, which improves performance for read/write for a number of documents

  • References:
    http://docs.couchbase.com/developer/java-2.1/documents-bulk.html