Overview

A GQLDB instance can host multiple graphs, each representing a dataset of interconnected nodes and edges.

There are three graph modes:

Open graph: A schema-free labeled property graph (LPG) where nodes and edges can be added with any labels and properties on the fly, no predefined type required, ideal for agile work. This is the default when no graph mode is specified. Learn More
Closed graph: A graph bound to a defined graph type (a set of node and edge types), so all data must conform to the declared, enforcing strict data integrity for production-grade applications. Learn More
Ontology graph: A graph for modeling RDF data with OWL semantics (classes, object/data properties, characteristics, and inference), enabling semantically rich, standards-based knowledge representation. Learn More

Showing Graphs

Show graphs in the database:

GQL
SHOW GRAPHS

To inspect a single graph:

GQL
DESCRIBE GRAPH myGraph

-- DESC is a shorthand for DESCRIBE
DESC GRAPH myGraph

Each graph provides the following metadata:

Field	Description
`graph_id`	The ID of the graph.
`graph_name`	The unique name of the graph.
`current`	Whether the graph is the current graph.
`graph_mode`	The mode of the graph (`OPEN`, `CLOSED` or `ONTOLOGY`).
`bounded_graph_type`	The named graph type this graph is bound to.
`node_count`	The number of nodes in the graph.
`edge_count`	The number of edges in the graph.
`node_label_count`	The number of node labels in the graph.
`edge_label_count`	The number of edge labels in the graph.
`procedure_count`	The number of stored procedures in the graph.
`fulltext_index_count`	The number of full-text indexes in the graph.
`trigger_count`	The number of triggers in the graph.
`created_at`	The creation time of the graph.
`comment`	The comment of the graph.
`status`	Lifecycle status. `READY` (the common case) means the graph accepts queries and writes; other values (e.g. `COPYING`, `FAILED`) surface in-flight or failed background operations. While not `READY`, queries and writes against this graph are rejected.
`copy_source`	When the graph was created by `CREATE GRAPH … AS COPY OF …` and the data copy is still in progress, the name of the source graph. Empty otherwise.
`copy_progress_pct`	Background-copy completion percentage (`0`–`100`). Empty / `0` when no background copy is in progress.
`copy_started_at`	Timestamp when the background copy began. Empty when no background copy is in progress.

Selecting Current Graph

Most GQL queries operate on the current graph. The USE statement allows you to select it:

GQL
USE myGraph

-- USE is a shorthand for USE GRAPH
USE GRAPH myGraph

All subsequent queries in the session will run against myGraph until another USE is issued.

To get the name of the current graph at query time, use the CURRENT_GRAPH bare keyword. It returns the graph name as a STRING:

GQL
RETURN CURRENT_GRAPH

Creating Graphs

The CREATE GRAPH statement creates a new named graph in the database, optionally specifying its mode (open, closed, or ontology) and schema. Default to an open, schema-free graph when no mode is given.

Syntax
<create graph statement> ::= 
  "CREATE GRAPH" [ "IF NOT EXISTS" ] <graph name> [ <graph mode> ] [ <edge id toggle> ]

<graph mode> ::= <open> | <closed> | <ontology>

<edge id toggle> ::= "WITH EDGE_ID" < "DISABLED" | "ENABLED" >

Details

Learn more about different graph modes: open graph (default), closed graph, and ontology graph.
Edge _id is enabled by default, WITH EDGE_ID DISABLED disables it. Learn more about Node and Edge IDs.

Cloning Graphs

Syntax
<clone graph statement> ::= 
  "CREATE GRAPH" [ "IF NOT EXISTS" ] <graph name> "AS COPY OF" <graph name>

A new graph can be created from an existing one, cloning both data and its graph type (if it's a closed graph):

GQL
CREATE GRAPH newGraph AS COPY OF myGraph

Converting Between Open and Closed

A closed graph can be converted to an open graph, and vice versa.

Convert a closed graph to open. Existing type definitions are preserved but no longer enforced:

GQL
ALTER GRAPH myGraph SET OPEN

Convert an open graph to closed:

GQL
ALTER GRAPH myGraph SET CLOSED

After conversion, the graph has no node/edge types defined. You must add node and edge types before inserting new data. Existing data is not validated against the new types, only future inserts are checked.

Renaming Graphs

Rename myGraph to newGraph:

GQL
ALTER GRAPH myGraph RENAME TO newGraph

Commenting Graphs

Set comment for myGraph:

GQL
ALTER GRAPH myGraph COMMENT "This is a description"

Dropping Graphs

Drop the graph myGraph:

GQL
DROP GRAPH myGraph

-- Use IF EXISTS to prevent errors when attempting to delete a graph that does not exist
DROP GRAPH IF EXISTS myGraph

Truncating Graphs

The truncating operation deletes all nodes, edges, and index data from the graph while preserving the graph itself. For closed graphs, the graph type is preserved.

You may truncate the entire graph, all nodes or edges, or nodes or edges with a specific label (open graph) or type (closed graph). Note that truncating nodes will also remove any edges connected to them.

GQL
-- Truncate the entire graph
TRUNCATE GRAPH myGraph

-- Truncate all nodes in the current graph
TRUNCATE NODE *

-- Truncate User nodes in the current graph
TRUNCATE NODE User

-- Truncate all edges in the current graph
TRUNCATE EDGE *

-- Truncate Follows edges in the current graph
TRUNCATE EDGE Follows