1
0
Fork 0
arangodb/Documentation/Books/AQL
Wilfried Goesgens eb221d97e6 mention howto use indices for joins (#3229) 2017-09-13 17:45:45 +02:00
..
Advanced rename .mdpp files to .md so the handling is easier. 2017-05-04 12:04:24 +02:00
Examples mention howto use indices for joins (#3229) 2017-09-13 17:45:45 +02:00
ExecutionAndPerformance Feature/reduce extraction to projection (#2792) 2017-07-14 08:40:29 +02:00
Extending rename .mdpp files to .md so the handling is easier. 2017-05-04 12:04:24 +02:00
Functions Bug fix/fixes 0609 (#3227) 2017-09-13 16:28:21 +02:00
Fundamentals rename .mdpp files to .md so the handling is easier. 2017-05-04 12:04:24 +02:00
Graphs Docs: Call to Action hints added 2017-06-06 18:43:43 +02:00
Invocation No access collections (#3088) 2017-08-25 13:59:03 +02:00
Operations documented WITH change 2017-05-25 23:01:33 +02:00
styles Docs: Fix 2.8 version switching 2017-07-20 05:04:55 +02:00
CommonErrors.md rename .mdpp files to .md so the handling is easier. 2017-05-04 12:04:24 +02:00
DataQueries.md rename .mdpp files to .md so the handling is easier. 2017-05-04 12:04:24 +02:00
FOOTER.html Add footer to docs, unify slogan 2017-05-12 10:19:37 +02:00
HEADER.html Docs: Gitbook 3 upgrade 2016-12-08 01:34:54 +01:00
Operators.md rename .mdpp files to .md so the handling is easier. 2017-05-04 12:04:24 +02:00
README.md rename .mdpp files to .md so the handling is easier. 2017-05-04 12:04:24 +02:00
SUMMARY.md Make DataModification -> DataQueries in docs 2016-06-14 02:19:46 +02:00
book.json Docs: Reformat gitbook plugin lists, add priority to sitemaps 2017-06-28 14:35:00 +02:00

README.md

Introduction

The ArangoDB query language (AQL) can be used to retrieve and modify data that are stored in ArangoDB. The general workflow when executing a query is as follows:

  • A client application ships an AQL query to the ArangoDB server. The query text contains everything ArangoDB needs to compile the result set
  • ArangoDB will parse the query, execute it and compile the results. If the query is invalid or cannot be executed, the server will return an error that the client can process and react to. If the query can be executed successfully, the server will return the query results (if any) to the client

AQL is mainly a declarative language, meaning that a query expresses what result should be achieved but not how it should be achieved. AQL aims to be human-readable and therefore uses keywords from the English language. Another design goal of AQL was client independency, meaning that the language and syntax are the same for all clients, no matter what programming language the clients may use. Further design goals of AQL were the support of complex query patterns and the different data models ArangoDB offers.

In its purpose, AQL is similar to the Structured Query Language (SQL). AQL supports reading and modifying collection data, but it doesn't support data-definition operations such as creating and dropping databases, collections and indexes. It is a pure data manipulation language (DML), not a data definition language (DDL) or a data control language (DCL).

The syntax of AQL queries is different to SQL, even if some keywords overlap. Nevertheless, AQL should be easy to understand for anyone with an SQL background.

For some example queries, please refer to the pages Data Queries and Usual query patterns.