{
    "basePath": "/",
    "swaggerVersion": "1.1",
    "apiVersion": "0.1",
    "apis": [
        {
            "operations": [
                {
                    "errorResponses": [
                        {
                            "reason": "If the query is valid, the server will respond with <em>HTTP 200</em> and return a list of the individual query execution steps in the <em>\"plan\"</em> attribute of the response. <br><br>",
                            "code": "200"
                        },
                        {
                            "reason": "The server will respond with <em>HTTP 400</em> in case of a malformed request, or if the query contains a parse error. The body of the response will contain the error details embedded in a JSON object. Omitting bind variables if the query references any will result also result in an <em>HTTP 400</em> error. <br><br>",
                            "code": "400"
                        },
                        {
                            "reason": "The server will respond with <em>HTTP 404</em> in case a non-existing collection is accessed in the query. <br><br>",
                            "code": "404"
                        }
                    ],
                    "parameters": [
                        {
                            "dataType": "Json",
                            "paramType": "body",
                            "required": "true",
                            "name": "body",
                            "description": "The query string needs to be passed in the attribute <em>query</em> of a JSON object as the body of the POST request. If the query references any bind variables, these must also be passed in the attribute <em>bindVars</em>. <br><br>"
                        }
                    ],
                    "notes": "<br><br> To explain how an AQL query would be executed on the server, the query string can be sent to the server via an HTTP POST request. The server will then validate the query and create an execution plan for it, but will not execute it. <br><br> The execution plan that is returned by the server can be used to estimate the probable performance of an AQL query. Though the actual performance will depend on many different factors, the execution plan normally can give some good hint on the amount of work the server needs to do in order to actually run the query. <br><br> The top-level statements will appear in the result in the same order in which they have been used in the original query. Each result element has at most the following attributes:  <ul class=\"swagger-list\"><li><em>id</em>: the row number of the top-level statement, starting at 1 <li><em>type</em>: the type of the top-level statement (e.g. <em>for</em>, <em>return</em> ...) <li><em>loopLevel</em>: the nesting level of the top-level statement, starting at 1 </ul> Depending on the type of top-level statement, there might be other attributes providing additional information, for example, if and which indexed will be used. Many top-level statements will provide an <em>expression</em> attribute that contains data about the expression they operate on. This is true for <em>FOR</em>, <em>FILTER</em>, <em>SORT</em>, <em>COLLECT</em>, and <em>RETURN</em> statements. The <em>expression</em> attribute has the following sub-attributes:  <ul class=\"swagger-list\"><li><em>type</em>: the type of the expression. Some possible values are: - <em>collection</em>: an iteration over documents from a collection. The   <em>value</em> attribute will then contain the collection name. The <em>extra</em>   attribute will contain information about if and which index is used when   accessing the documents from the collection. If no index is used, the   <em>accessType</em> sub-attribute of the <em>extra</em> attribute will have the   value <em>all</em>, otherwise it will be <em>index</em>. - <em>list</em>: a list of dynamic values. The <em>value</em> attribute will contain the   list elements. - <em>const list</em>: a list of constant values. The <em>value</em> attribute will contain the   list elements. - <em>reference</em>: a reference to another variable. The <em>value</em> attribute   will contain the name of the variable that is referenced.  </ul> Please note that the structure of the explain result data might change in future versions of ArangoDB without further notice and without maintaining backwards compatibility. <br><br>",
                    "summary": " Explain query",
                    "httpMethod": "POST",
                    "examples": "<br><br> Valid query: <br><br><br><br><pre><code class=\"json\">shell> curl -X POST --data-binary @- --dump - http://localhost:8529/_api/explain\n{ \"query\" : \"FOR p IN products FILTER p.id == @id LIMIT 2 RETURN p.name\", \"bindVars\": { \"id\" : 3 } }\n\nHTTP/1.1 200 OK\ncontent-type: application/json; charset=utf-8\n\n{ \n  \"plan\" : { \n    \"plan\" : { \n      \"nodes\" : [ \n        { \n          \"type\" : \"SingletonNode\", \n          \"dependencies\" : [ ], \n          \"id\" : 1, \n          \"estimatedCost\" : 1, \n          \"depth\" : 0, \n          \"varInfoList\" : [ ], \n          \"nrRegs\" : [ ], \n          \"regsToClear\" : [ ] \n        }, \n        { \n          \"type\" : \"EnumerateCollectionNode\", \n          \"dependencies\" : [ \n            1 \n          ], \n          \"id\" : 2, \n          \"estimatedCost\" : 0, \n          \"depth\" : 0, \n          \"varInfoList\" : [ ], \n          \"nrRegs\" : [ ], \n          \"regsToClear\" : [ ], \n          \"database\" : \"_system\", \n          \"collection\" : \"products\", \n          \"outVariable\" : { \n            \"id\" : 0, \n            \"name\" : \"p\" \n          } \n        }, \n        { \n          \"type\" : \"CalculationNode\", \n          \"dependencies\" : [ \n            2 \n          ], \n          \"id\" : 3, \n          \"estimatedCost\" : 0, \n          \"depth\" : 0, \n          \"varInfoList\" : [ ], \n          \"nrRegs\" : [ ], \n          \"regsToClear\" : [ ], \n          \"expression\" : { \n            \"type\" : \"compare ==\", \n            \"subNodes\" : [ \n              { \n                \"type\" : \"attribute access\", \n                \"name\" : \"id\", \n                \"subNodes\" : [ \n                  { \n                    \"type\" : \"reference\", \n                    \"name\" : \"p\", \n                    \"id\" : 0 \n                  } \n                ] \n              }, \n              { \n                \"type\" : \"value\", \n                \"value\" : 3 \n              } \n            ] \n          }, \n          \"outVariable\" : { \n            \"id\" : 1, \n            \"name\" : \"1\" \n          }, \n          \"canThrow\" : false \n        }, \n        { \n          \"type\" : \"FilterNode\", \n          \"dependencies\" : [ \n            3 \n          ], \n          \"id\" : 4, \n          \"estimatedCost\" : 0, \n          \"depth\" : 0, \n          \"varInfoList\" : [ ], \n          \"nrRegs\" : [ ], \n          \"regsToClear\" : [ ], \n          \"inVariable\" : { \n            \"id\" : 1, \n            \"name\" : \"1\" \n          } \n        }, \n        { \n          \"type\" : \"CalculationNode\", \n          \"dependencies\" : [ \n            4 \n          ], \n          \"id\" : 6, \n          \"estimatedCost\" : 0, \n          \"depth\" : 0, \n          \"varInfoList\" : [ ], \n          \"nrRegs\" : [ ], \n          \"regsToClear\" : [ ], \n          \"expression\" : { \n            \"type\" : \"attribute access\", \n            \"name\" : \"name\", \n            \"subNodes\" : [ \n              { \n                \"type\" : \"reference\", \n                \"name\" : \"p\", \n                \"id\" : 0 \n              } \n            ] \n          }, \n          \"outVariable\" : { \n            \"id\" : 2, \n            \"name\" : \"2\" \n          }, \n          \"canThrow\" : false \n        }, \n        { \n          \"type\" : \"LimitNode\", \n          \"dependencies\" : [ \n            6 \n          ], \n          \"id\" : 5, \n          \"estimatedCost\" : 0, \n          \"depth\" : 0, \n          \"varInfoList\" : [ ], \n          \"nrRegs\" : [ ], \n          \"regsToClear\" : [ ], \n          \"offset\" : 0, \n          \"limit\" : 2 \n        }, \n        { \n          \"type\" : \"ReturnNode\", \n          \"dependencies\" : [ \n            5 \n          ], \n          \"id\" : 7, \n          \"estimatedCost\" : 0, \n          \"depth\" : 0, \n          \"varInfoList\" : [ ], \n          \"nrRegs\" : [ ], \n          \"regsToClear\" : [ ], \n          \"inVariable\" : { \n            \"id\" : 2, \n            \"name\" : \"2\" \n          } \n        } \n      ], \n      \"rules\" : [ \n        \"move-calculations-up\", \n        \"move-filters-up\", \n        \"move-calculations-up-2\", \n        \"move-filters-up-2\" \n      ], \n      \"collections\" : [ \n        { \n          \"name\" : \"products\", \n          \"type\" : \"read\" \n        } \n      ], \n      \"estimatedCost\" : 0 \n    } \n  }, \n  \"error\" : false, \n  \"code\" : 200 \n}\n</code></pre><br><br><br> Invalid query: <br><br><br><br><pre><code class=\"json\">shell> curl -X POST --data-binary @- --dump - http://localhost:8529/_api/explain\n{ \"query\" : \"FOR p IN products FILTER p.id == @id LIMIT 2 RETURN p.n\" }\n\nHTTP/1.1 400 Bad Request\ncontent-type: application/json; charset=utf-8\n\n{ \n  \"error\" : true, \n  \"code\" : 400, \n  \"errorNum\" : 1551, \n  \"errorMessage\" : \"in state parsing: no value specified for declared bind parameter 'id'\" \n}\n</code></pre><br><br><br> The data returned in the <em>plan</em> attribute of the result contains one element per AQL top-level statement (i.e. <em>FOR</em>, <em>RETURN</em>, <em>FILTER</em> etc.). If the query optimiser removed some unnecessary statements, the result might also contain less elements than there were top-level statements in the AQL query. The following example shows a query with a non-sensible filter condition that the optimiser has removed so that there are less top-level statements: <br><br><br><br><pre><code class=\"json\">shell> curl -X POST --data-binary @- --dump - http://localhost:8529/_api/explain\n{ \"query\" : \"FOR i IN [ 1, 2, 3 ] FILTER 1 == 2 RETURN i\" }\n\nHTTP/1.1 200 OK\ncontent-type: application/json; charset=utf-8\n\n{ \n  \"plan\" : { \n    \"plan\" : { \n      \"nodes\" : [ \n        { \n          \"type\" : \"SingletonNode\", \n          \"dependencies\" : [ ], \n          \"id\" : 1, \n          \"estimatedCost\" : 0, \n          \"depth\" : 0, \n          \"varInfoList\" : [ ], \n          \"nrRegs\" : [ ], \n          \"regsToClear\" : [ ] \n        }, \n        { \n          \"type\" : \"CalculationNode\", \n          \"dependencies\" : [ \n            1 \n          ], \n          \"id\" : 2, \n          \"estimatedCost\" : 0, \n          \"depth\" : 0, \n          \"varInfoList\" : [ ], \n          \"nrRegs\" : [ ], \n          \"regsToClear\" : [ ], \n          \"expression\" : { \n            \"type\" : \"list\", \n            \"subNodes\" : [ \n              { \n                \"type\" : \"value\", \n                \"value\" : 1 \n              }, \n              { \n                \"type\" : \"value\", \n                \"value\" : 2 \n              }, \n              { \n                \"type\" : \"value\", \n                \"value\" : 3 \n              } \n            ] \n          }, \n          \"outVariable\" : { \n            \"id\" : 1, \n            \"name\" : \"1\" \n          }, \n          \"canThrow\" : false \n        }, \n        { \n          \"type\" : \"NoResultsNode\", \n          \"dependencies\" : [ \n            2 \n          ], \n          \"id\" : 7, \n          \"estimatedCost\" : 0, \n          \"depth\" : 0, \n          \"varInfoList\" : [ ], \n          \"nrRegs\" : [ ], \n          \"regsToClear\" : [ ] \n        }, \n        { \n          \"type\" : \"EnumerateListNode\", \n          \"dependencies\" : [ \n            7 \n          ], \n          \"id\" : 3, \n          \"estimatedCost\" : 0, \n          \"depth\" : 0, \n          \"varInfoList\" : [ ], \n          \"nrRegs\" : [ ], \n          \"regsToClear\" : [ ], \n          \"inVariable\" : { \n            \"id\" : 1, \n            \"name\" : \"1\" \n          }, \n          \"outVariable\" : { \n            \"id\" : 0, \n            \"name\" : \"i\" \n          } \n        }, \n        { \n          \"type\" : \"ReturnNode\", \n          \"dependencies\" : [ \n            3 \n          ], \n          \"id\" : 6, \n          \"estimatedCost\" : 0, \n          \"depth\" : 0, \n          \"varInfoList\" : [ ], \n          \"nrRegs\" : [ ], \n          \"regsToClear\" : [ ], \n          \"inVariable\" : { \n            \"id\" : 0, \n            \"name\" : \"i\" \n          } \n        } \n      ], \n      \"rules\" : [ \n        \"move-calculations-up\", \n        \"move-filters-up\", \n        \"remove-unnecessary-filters\", \n        \"remove-unnecessary-calculations\" \n      ], \n      \"collections\" : [ ], \n      \"estimatedCost\" : 0 \n    } \n  }, \n  \"error\" : false, \n  \"code\" : 200 \n}\n</code></pre><br><br><br>",
                    "nickname": "ExplainQuery"
                }
            ],
            "path": "/_api/explain"
        }
    ]
}