Couchbase View

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