CODEWITHSUNDEEP
arangodb
mnemon1ck
mnemon1ck

Reputation: 420

"ignoreDocumentNotFound", "readCompleteInput" query options in explain

When I use "explain" on an insert query I get two query options that seems not to be documented:

What are these options for and what they do?

Upvotes: 1

Views: 78

Answers (1)

dothebart
dothebart

Reputation: 6067

Nice to see you like our db._explain() Facility ;-)

To answer your question one has to know that explain re-uses a backend functionality that is also used for different purposes:

  • distribute AQL queries in ArangoDB clusters
  • analyse what the optimizer did with queries in Unittests

The later will explain queries, and check whether certain assumptions over the query plan are still valid. The ignoreDocumentNotFound and readCompleteInput flags are exactly intended for that purpose, so the unittests can revalidate whether certain assumptions for the query are still true.

Since they don't contain additional value for the end user, they're not documented. One could argue whether explain should hide them to avoid irretations

Upvotes: 2

Related Questions