In GQL, a query consists of one or more statements. Each statement is a complete unit that can be executed by the database, starting with commands like MATCH and INSERT to retrieve or modify data in the graph.
A clause is a component of a statement that performs a specific function, such as filtering with WHERE. A clause on its own is not a complete instruction, but must be part of a statement.
Statements
Catalog-modifying Statements
Statement |
Description |
|---|---|
| CREATE GRAPH | Creates a graph. |
| DROP GRAPH | Drops a graph. |
Graph creation and deletion using GQL is not yet supported. You may use UQL to manage graphs in the database.
Data-modifying Statements
Statement |
Description |
|---|---|
| INSERT | Inserts new nodes and edges into the graph using patterns. |
| SET | Updates, adds, or removes properties on nodes and edges. |
| DELETE | Deletes nodes and edges from the graph. |
Query Statements
Statement |
Description |
|---|---|
| MATCH | Retrieves data from the graph using patterns and binds data with variables for subsequent references. |
| FILTER | Selects a subset of records from the current working table based on conditions. |
| LET | Defines variables for use and add columns to the current working table. |
| FOR | Unnest a list into individual rows by expanding the current working table. |
| RETURN | Specifies the columns to include in the final output table. |
| ORDER BY | Sorts the current working table or the output table based on a list of specifications. |
| LIMIT | Restricts the maximum number of records to be retained in the current working table or the output table. |
| SKIP | Discards a specified number of records from the beginning of the current working table or the output table. |
| CALL | Invokes a subquery or pre-defined procedure with in a query. |
| Composite Query | Combines linear queries with query conjunctions. |
Other Statements
Statement |
Description |
|---|---|
| NEXT | Chains multiple statements. |
Clauses
A clause must operate as part of the its subject statement.
Clause |
Description | Subject Statement |
|---|---|---|
| WHERE | Applies search conditions during graph pattern matching. | MATCH |
| GROUP BY | Groups the final table. | RETURN |
| Graph Pattern YIELD | Selects variables from the graph pattern to allow exposure in subsequent parts of the query. | MATCH |
| YIELD | Selects and renames variables to allow exposure in subsequent parts of the query. | CALL, NEXT |