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":"attachments 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