Document N1QL Error Codes When Prepared Statements Are Invalidated

A N1QL prepared statement may become invalid if a dependent object (most likely an index) is deleted and/or recreated after the statement was prepared. In this case, executions of the prepared statement by client programs will fail.

The purpose of this documentation request is to make sure that all of the possible return codes are documented that that users coding client programs will know how to code exception handlers working on those specific return codes so that the invalidated statement can be re-prepared.

This is important because there is presently no facility for detecting and transparently re-preparing these invalidated statements: the logic to perceive statement invalidation and respond to it must be included in the client program code.