Documentation on how N1QL executes?

I would like to understand more how N1QL works inside.
I found only n1ql: How works? a total change in the “couchbase way”? as some description, but I can’t see any insights of how it work on official documentation

Could you please pinpoint me where ‘how it works inside’ lies in or when it will be available?
Questions I’m interested in:

  1. CREATE INDEX on large bucket may take few hours to generate view (so I’ll receive timeout on SDK), when do I know it’s created?
  2. What does mean ‘N1QL has it’s own processing engine’?
  3. Are there any other types of document indexing, except of views?
  4. Are there any type of BTree indexes to access view faster? As far as I understood all views are just plain key-value string accessed from startKey to endKey.
  5. Does N1QL take document from RAM, when it needs to get some data from it, not available in initial view?
  6. Java SDK 2.1.x has async query, and when you try access document it has async access to it. Do it mean there is GET:/document call to CB? Why not to add flag (as it was at 1.4.x) ‘include document’ to avoid additional network load?
  7. UPDATE … WHERE how it is correlated to CAS and atomicity? If during UPDATE…WHERE there will be update from other thread to same document it’ll change CAS, so it may drop CASMismatch error. If it will do error, other documents will remain changed or will rollback?


seems like such docs just doesn’t exists…


There are many presentations under the architecture track from the most recent Cocuhbase Connect conference:

Please click on the architecture track. Your questions above are answered in the presentations.

You are correct that the documentation focuses on how to use Couchbase and N1QL, rather than under the hood. Lmk if the presentations work for you, or we can answer specific questions on this forum.