Several years back, when designing the Perl client (before I was working for Couchbase), I wanted an efficient way to handle processing view results as they arrived from the network without having to wait for all the rows to arrive so they could be parsed as a proper JSON array. To solve this problem, I create the jsonsl library to incrementally parse the JSON rows – allowing users of this library to receive data as it arrives despite not yet having a complete JSON object.

Support for this feature was implemented to a certain degree in both the Python and Perl clients. Now it’s finally made its way into the C library. This adds the benefit of the enhanced testing infrastructure found in the C client, but also an improved API – which for C users, should be much simpler than the raw HTTP API.

Using the views API

Here’s an example of how to use it:

The new view functionality also includes the ability for the library to fetch documents for the results. Simply set the LCB_CMDVIEWQUERY_F_INCLUDE_DOCS flag in the cmd.cmdflags field.

Using the N1QL API

N1QL is an experimental feature to be added in future versions of Couchbase. It is available as a developer preview (http://docs.couchbase.com/developer/n1ql-dp3/n1ql-intro.html). Version 2.4.7 of the client provides some new APIs to interface with N1QL.

Using the N1QL API is very similar to the views API. Like views, it is row-based. Unlike views however, the passing of N1QL query parameters is more abstracted (because of its complexity) and involves creating a special “parameters” object.

Installing

Simply follow the normal upgrade/install instructions

Author

Posted by Mark Nunberg, Software Engineer, Couchbase

Mark Nunberg is a software engineer working at Couchbase. He maintains the C client library (libcouchbase) as well as the Python client. He also developed the Perl client (for use at his previous company) - which initially led him to working at Couchbase. Prior to joining Couchbase, he worked on distributed and high performance routing systems at an eCommerce analytics firm. Mark studied Linguistics at the Hebrew University of Jerusalem.

Leave a reply