Skip to Content
🚀 Introducing Polygres: Managed cloud for Postgres graph databases. Learn more at polygres.com →
User GuideGQL 1.0 Profile

pgGraph 1.0 implements the documented subset below. It does not claim full ISO GQL, full openCypher, or SQL/PGQ conformance. Every supported GQL write updates its mapped PostgreSQL tables first.

Capability IDProfilePositive executable evidence
matchreadgql_single_directed_match_matches_traverse_fixture
optional_match_single_relationshipreadgql_optional_match_matches_left_outer_sql
where_node_propertiesreadgql_optional_match_filters_orders_and_paginates_null_rows
withreadgql_with_projection_scope_aliases_and_shadows
return_projectionreadgql_defaults_to_hydrated_nodes_and_projects_ids_explicitly
distinctreadgql_distinct_matches_sql_distinct_counts
order_limit_offsetreadgql_optional_match_filters_orders_and_paginates_null_rows
aggregatesreadgql_aggregates_match_sql_grouping_and_numeric_results
bounded_paths_and_path_functionsreadgql_path_values_and_functions_have_stable_shape
mapped_single_node_createwritegql_create_node_inserts_mapped_row_and_records_delta
mapped_single_relationship_createwritegql_create_relationship_inserts_edge_row_and_records_delta
mapped_single_node_set_removewritegql_set_property_updates_source_row_and_filter_index, gql_remove_typed_property_sets_source_column_null_idempotently
mapped_single_relationship_deletewritegql_delete_edge_removes_source_row_and_tombstones_neighbors
mapped_single_node_detach_deletewritegql_detach_delete_removes_incident_edges_before_node
mapped_single_node_mergewritegql_merge_node_inserts_then_updates_mapped_row

Each listed capability is covered by parser, planning, execution, error, access-control, resource, and documentation tests. Write capabilities also include transaction and rollback tests that verify PostgreSQL tables are updated first. The release checker verifies every referenced implementation marker and test.

release/v1-gql-unsupported.json lists unsupported and compatibility syntax. These examples are rejected before execution with the documented SQLSTATE and guidance; pgGraph does not interpret them as supported syntax.

Last updated on