Graph Query Language (GQL)

<h2 id="graph-query-language-gql" class="position-relative d-flex align-items-center group"> Graph Query Language (GQL) <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="graph-query-language-gql" aria-haspopup="dialog" aria-label="Share link: Graph Query Language (GQL)"> Share link </button> </h2><div id="headingShareModal" class="heading-share-modal" role="dialog" aria-modal="true" aria-labelledby="headingShareTitle" hidden> <div class="hsm-dialog" role="document"> <div class="hsm-header"> <h2 id="headingShareTitle" class="h6 mb-0 fw-bold">Share this section</h2> <button type="button" class="hsm-close" aria-label="Close"> </button> </div> <div class="hsm-body"> <label for="headingShareInput" class="form-label small text-muted mb-1 text-uppercase fw-bold" style="font-size: 0.7rem; letter-spacing: 0.5px;">Permalink</label> <div class="input-group mb-4 hsm-url-group"> <input id="headingShareInput" type="text" class="form-control font-monospace" readonly aria-readonly="true" style="font-size: 0.85rem;" /> <button class="btn btn-primary hsm-copy" type="button" aria-label="Copy" title="Copy"> </button> </div> <div class="small fw-bold mb-2 text-muted text-uppercase" style="font-size: 0.7rem; letter-spacing: 0.5px;">Share via</div> <div class="hsm-share-grid"> <a id="share-twitter" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> Twitter </a> <a id="share-linkedin" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> LinkedIn </a> <a id="share-facebook" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> Facebook </a> </div> </div> </div> </div> <style> .heading-share-modal { position: fixed; inset: 0; display: flex; justify-content: center; align-items: center; background: rgba(0, 0, 0, 0.6); z-index: 1050; padding: 1rem; backdrop-filter: blur(4px); -webkit-backdrop-filter: blur(4px); } .heading-share-modal[hidden] { display: none !important; } .hsm-dialog { max-width: 420px; width: 100%; background: var(--bs-body-bg, #fff); color: var(--bs-body-color, #212529); border: 1px solid var(--bs-border-color, rgba(0,0,0,0.1)); border-radius: 1rem; box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25); overflow: hidden; animation: hsm-fade-in 0.2s ease-out; } @keyframes hsm-fade-in { from { opacity: 0; transform: scale(0.95); } to { opacity: 1; transform: scale(1); } } [data-bs-theme="dark"] .hsm-dialog { background: #1e293b; border-color: rgba(255,255,255,0.1); color: #f8f9fa; } .hsm-header { display: flex; justify-content: space-between; align-items: center; padding: 1rem 1.5rem; border-bottom: 1px solid var(--bs-border-color, rgba(0,0,0,0.1)); background: rgba(0,0,0,0.02); } [data-bs-theme="dark"] .hsm-header { background: rgba(255,255,255,0.02); border-color: rgba(255,255,255,0.1); } .hsm-close { background: transparent; border: none; color: inherit; opacity: 0.5; padding: 0.25rem 0.5rem; border-radius: 0.25rem; font-size: 1.2rem; line-height: 1; transition: opacity 0.2s; } .hsm-close:hover { opacity: 1; } .hsm-body { padding: 1.5rem; } .hsm-url-group { display: flex !important; align-items: stretch; } .hsm-url-group .form-control { flex: 1; min-width: 0; margin: 0; background: var(--bs-secondary-bg, #f8f9fa); border-color: var(--bs-border-color, #dee2e6); border-top-right-radius: 0; border-bottom-right-radius: 0; height: 42px; } .hsm-url-group .btn { flex: 0 0 auto; margin: 0; margin-left: -1px; border-top-left-radius: 0; border-bottom-left-radius: 0; height: 42px; display: flex; align-items: center; justify-content: center; padding: 0 1.25rem; z-index: 2; } [data-bs-theme="dark"] .hsm-url-group .form-control { background: #0f172a; border-color: #334155; color: #e2e8f0; } .hsm-share-grid { display: flex; flex-direction: column; gap: 0.5rem; } .hsm-share-grid .btn { display: flex; align-items: center; justify-content: center; font-size: 0.9rem; padding: 0.6rem; border-color: var(--bs-border-color); width: 100%; } [data-bs-theme="dark"] .hsm-share-grid .btn { color: #e2e8f0; border-color: #475569; } [data-bs-theme="dark"] .hsm-share-grid .btn:hover { background: #334155; border-color: #cbd5e1; } </style> <script> (function(){ const modal = document.getElementById('headingShareModal'); if(!modal) return; const input = modal.querySelector('#headingShareInput'); const copyBtn = modal.querySelector('.hsm-copy'); const twitter = modal.querySelector('#share-twitter'); const linkedin = modal.querySelector('#share-linkedin'); const facebook = modal.querySelector('#share-facebook'); const closeBtn = modal.querySelector('.hsm-close'); let lastFocus=null; let trapBound=false; function buildUrl(id){ return window.location.origin + window.location.pathname + '#' + id; } function isOpen(){ return !modal.hasAttribute('hidden'); } function hydrate(id){ const url=buildUrl(id); input.value=url; const enc=encodeURIComponent(url); const text=encodeURIComponent(document.title); if(twitter) twitter.href=`https://twitter.com/intent/tweet?url=${enc}&text=${text}`; if(linkedin) linkedin.href=`https://www.linkedin.com/sharing/share-offsite/?url=${enc}`; if(facebook) facebook.href=`https://www.facebook.com/sharer/sharer.php?u=${enc}`; } function openModal(id){ lastFocus=document.activeElement; hydrate(id); if(!isOpen()){ modal.removeAttribute('hidden'); } requestAnimationFrame(()=>{ input.focus(); }); trapFocus(); } function closeModal(){ if(!isOpen()) return; modal.setAttribute('hidden',''); if(lastFocus && typeof lastFocus.focus==='function') lastFocus.focus(); } function copyCurrent(){ try{ navigator.clipboard.writeText(input.value).then(()=>feedback(true),()=>fallback()); } catch(e){ fallback(); } } function fallback(){ input.select(); try{ document.execCommand('copy'); feedback(true);}catch(e){ feedback(false);} } function feedback(ok){ if(!copyBtn) return; const icon=copyBtn.querySelector('i'); if(!icon) return; const prev=copyBtn.getAttribute('data-prev')||icon.className; if(!copyBtn.getAttribute('data-prev')) copyBtn.setAttribute('data-prev',prev); icon.className= ok ? 'fa-duotone fa-clipboard-check':'fa-duotone fa-circle-exclamation'; setTimeout(()=>{ icon.className=prev; },1800); } function handleShareClick(e){ e.preventDefault(); const btn=e.currentTarget; const id=btn.getAttribute('data-share-target'); if(id) openModal(id); } function bindShareButtons(){ document.querySelectorAll('.h-share').forEach(btn=>{ if(!btn.dataset.hShareBound){ btn.addEventListener('click', handleShareClick); btn.dataset.hShareBound='1'; } }); } bindShareButtons(); if(document.readyState==='loading'){ document.addEventListener('DOMContentLoaded', bindShareButtons); } else { requestAnimationFrame(bindShareButtons); } document.addEventListener('click', function(e){ const shareBtn=e.target.closest && e.target.closest('.h-share'); if(shareBtn && !shareBtn.dataset.hShareBound){ handleShareClick.call(shareBtn, e); } }, true); document.addEventListener('click', e=>{ if(e.target===modal) closeModal(); if(e.target.closest && e.target.closest('.hsm-close')){ e.preventDefault(); closeModal(); } if(copyBtn && (e.target===copyBtn || (e.target.closest && e.target.closest('.hsm-copy')))) { e.preventDefault(); copyCurrent(); } }); document.addEventListener('keydown', e=>{ if(e.key==='Escape' && isOpen()) closeModal(); }); function trapFocus(){ if(trapBound) return; trapBound=true; modal.addEventListener('keydown', f=>{ if(f.key==='Tab' && isOpen()){ const focusable=[...modal.querySelectorAll('a[href],button,input,textarea,select,[tabindex]:not([tabindex="-1"])')].filter(el=>!el.hasAttribute('disabled')); if(!focusable.length) return; const first=focusable[0]; const last=focusable[focusable.length-1]; if(f.shiftKey && document.activeElement===first){ f.preventDefault(); last.focus(); } else if(!f.shiftKey && document.activeElement===last){ f.preventDefault(); first.focus(); } } }); } if(closeBtn) closeBtn.addEventListener('click', e=>{ e.preventDefault(); closeModal(); }); })(); </script>The Graph Query Language (GQL) is the ISO/IEC 39075:2024 international standard for querying property graphs. As the SQL of graph databases, GQL provides declarative syntax for expressing graph patterns, traversals, and analytics. Geode follows the ISO/IEC 39075:2024 compliance to provide portable, standards-aligned queries with a clearly documented scope. <h3 id="what-is-gql" class="position-relative d-flex align-items-center group"> What is GQL? <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="what-is-gql" aria-haspopup="dialog" aria-label="Share link: What is GQL?"> Share link </button> </h3>GQL is a declarative language designed specifically for property graphs. Unlike imperative traversal APIs, GQL lets you specify what data you want rather than how to retrieve it—the query optimizer determines the execution strategy. This declarative approach enables powerful optimizations while maintaining query readability. <h4 id="key-characteristics" class="position-relative d-flex align-items-center group"> Key Characteristics <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="key-characteristics" aria-haspopup="dialog" aria-label="Share link: Key Characteristics"> Share link </button> </h4>Declarative: Express patterns, not procedures. The database finds efficient execution paths. Pattern-Centric: Graph traversals are expressed as visual patterns matching graph structure. SQL-Like Syntax: Familiar MATCH, WHERE, RETURN clauses reduce the learning curve for SQL users. Type-Safe: Static typing of node labels and relationship types enables compile-time validation. Composable: Subqueries, CTEs, and UNION enable building complex queries from simple parts. Standards-Based: ISO standard ensures portability and interoperability across implementations. <h3 id="gql-in-geode" class="position-relative d-flex align-items-center group"> GQL in Geode <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="gql-in-geode" aria-haspopup="dialog" aria-label="Share link: GQL in Geode"> Share link </button> </h3>Geode provides a production-ready GQL implementation aligned with the conformance profile: <ul> <li>100% GQL compliance: Deterministic ordering and pagination policies</li> <li>Query Optimization: Cost-based optimizer with index-aware execution planning</li> <li>EXPLAIN/PROFILE: Visibility into query execution for performance tuning</li> <li>Error Messages: Clear, actionable error messages with ISO status codes</li> <li>Performance: Statistics-driven planning for graph workloads</li> </ul> <h4 id="isoiec-390752024-conformance" class="position-relative d-flex align-items-center group"> ISO/IEC 39075:2024 Conformance <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="isoiec-390752024-conformance" aria-haspopup="dialog" aria-label="Share link: ISO/IEC 39075:2024 Conformance"> Share link </button> </h4>Geode documents conformance and implementation-defined behaviors in the ISO/IEC 39075:2024 conformance profile: <ul> <li>Pattern Matching: MATCH and OPTIONAL MATCH with bounded expansions</li> <li>Ordering & Pagination: Deterministic ORDER BY with LIMIT/OFFSET policies</li> <li>Set Operations: UNION, INTERSECT, EXCEPT</li> <li>Diagnostics: US001 and related ordering diagnostics (see profile)</li> </ul> See the <a href="/docs/gql/conformance-profile/" >GQL Conformance Profile</a> for authoritative scope. <h3 id="gql-fundamentals" class="position-relative d-flex align-items-center group"> GQL Fundamentals <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="gql-fundamentals" aria-haspopup="dialog" aria-label="Share link: GQL Fundamentals"> Share link </button> </h3> <h4 id="basic-query-structure" class="position-relative d-flex align-items-center group"> Basic Query Structure <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="basic-query-structure" aria-haspopup="dialog" aria-label="Share link: Basic Query Structure"> Share link </button> </h4>GQL queries consist of clauses that compose to form complete operations: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">MATCH (pattern) WHERE (conditions) RETURN (projections) </code></pre></div>MATCH: Specifies graph patterns to find WHERE: Filters matched patterns with predicates RETURN: Projects results with column expressions <h4 id="pattern-matching" class="position-relative d-flex align-items-center group"> Pattern Matching <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="pattern-matching" aria-haspopup="dialog" aria-label="Share link: Pattern Matching"> Share link </button> </h4>Patterns are the heart of GQL, describing graph structure visually: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">// Node pattern MATCH (n:Person) // Relationship pattern MATCH (p:Person)-[:KNOWS]->(f:Person) // Multi-hop pattern MATCH (p:Person)-[:KNOWS*1..3]->(friend) // Complex pattern MATCH (p:Person)-[:WORKS_AT]->(c:Company)<-[:WORKS_AT]-(colleague) WHERE colleague <> p </code></pre></div>Patterns use ASCII art notation: <code>(node)</code> for nodes, <code>-[rel]-></code> for directed relationships, <code>-[rel]-</code> for undirected. <h4 id="data-manipulation" class="position-relative d-flex align-items-center group"> Data Manipulation <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="data-manipulation" aria-haspopup="dialog" aria-label="Share link: Data Manipulation"> Share link </button> </h4>GQL provides full CRUD capabilities: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">// Create nodes INSERT (:Person {name: 'Alice', age: 30}) // Create relationships MATCH (a:Person {name: 'Alice'}), (b:Person {name: 'Bob'}) INSERT (a)-[:KNOWS]->(b) // Update properties MATCH (p:Person {name: 'Alice'}) SET p.age = 31 // Delete nodes and relationships MATCH (p:Person {name: 'Alice'}) DELETE p </code></pre></div> <h4 id="aggregations" class="position-relative d-flex align-items-center group"> Aggregations <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="aggregations" aria-haspopup="dialog" aria-label="Share link: Aggregations"> Share link </button> </h4>GQL supports standard aggregation functions: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">// Count nodes MATCH (p:Person) RETURN COUNT(p) AS person_count // Group by with aggregation MATCH (p:Person)-[:WORKS_AT]->(c:Company) RETURN c.name, COUNT(p) AS employees ORDER BY employees DESC // Multiple aggregations MATCH (p:Person) RETURN COUNT(p) AS total, AVG(p.age) AS avg_age, MIN(p.age) AS min_age, MAX(p.age) AS max_age </code></pre></div> <h3 id="learning-gql" class="position-relative d-flex align-items-center group"> Learning GQL <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="learning-gql" aria-haspopup="dialog" aria-label="Share link: Learning GQL"> Share link </button> </h3> <h4 id="for-sql-users" class="position-relative d-flex align-items-center group"> For SQL Users <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="for-sql-users" aria-haspopup="dialog" aria-label="Share link: For SQL Users"> Share link </button> </h4>GQL will feel familiar with its SQL-like syntax: <table> <thead> <tr> <th>SQL Concept</th> <th>GQL Equivalent</th> </tr> </thead> <tbody> <tr> <td>SELECT</td> <td>RETURN</td> </tr> <tr> <td>FROM</td> <td>MATCH</td> </tr> <tr> <td>WHERE</td> <td>WHERE</td> </tr> <tr> <td>JOIN</td> <td>Pattern matching</td> </tr> <tr> <td>GROUP BY</td> <td>Implicit grouping with aggregations</td> </tr> <tr> <td>ORDER BY</td> <td>ORDER BY</td> </tr> <tr> <td>LIMIT</td> <td>LIMIT</td> </tr> <tr> <td>UNION</td> <td>UNION</td> </tr> </tbody> </table> Key differences: Joins are implicit in patterns; relationships are first-class; paths are queryable. <h4 id="for-cypher-users" class="position-relative d-flex align-items-center group"> For Cypher Users <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="for-cypher-users" aria-haspopup="dialog" aria-label="Share link: For Cypher Users"> Share link </button> </h4>GQL is based on Cypher with ISO standardization: <ul> <li>Similar syntax: Pattern matching, clauses, functions</li> <li>Differences: Type syntax, path semantics, some function names</li> <li>Standard features: ISO-defined behavior, portable across implementations</li> </ul> <h4 id="learning-path" class="position-relative d-flex align-items-center group"> Learning Path <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="learning-path" aria-haspopup="dialog" aria-label="Share link: Learning Path"> Share link </button> </h4>Beginners: Start with basic MATCH patterns and simple WHERE conditions. Master node and relationship patterns before complex traversals. Intermediate: Learn multi-hop patterns, variable-length paths, aggregations, and subqueries. Practice optimization with EXPLAIN. Advanced: Master path queries, graph algorithms, complex analytical queries, and performance tuning. <h3 id="gql-documentation-in-this-category" class="position-relative d-flex align-items-center group"> GQL Documentation in This Category <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="gql-documentation-in-this-category" aria-haspopup="dialog" aria-label="Share link: GQL Documentation in This Category"> Share link </button> </h3> <h4 id="core-gql-guides" class="position-relative d-flex align-items-center group"> Core GQL Guides <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="core-gql-guides" aria-haspopup="dialog" aria-label="Share link: Core GQL Guides"> Share link </button> </h4><a href="/docs/gql/guide/" >GQL Guide</a> Comprehensive GQL tutorial from basics through advanced features. Learn pattern matching, filtering, projections, aggregations, subqueries, and data manipulation. <a href="/docs/gql/advanced-patterns/" >GQL Advanced Patterns</a> Advanced pattern matching techniques including variable-length paths, optional matches, complex predicates, and performance optimization. <a href="/docs/gql/conformance-profile/" >GQL Conformance Profile</a> Detailed ISO/IEC 39075:2024 conformance documentation, including scope and diagnostics. <h4 id="related-documentation" class="position-relative d-flex align-items-center group"> Related Documentation <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="related-documentation" aria-haspopup="dialog" aria-label="Share link: Related Documentation"> Share link </button> </h4><a href="/docs/gql-reference/" >GQL Reference</a> Complete GQL syntax reference including all clauses, operators, functions, and language constructs. <a href="/categories/query/" >Query Language Documentation</a> Broader query language category with optimization, EXPLAIN/PROFILE, indexing, and performance tuning. <a href="/docs/reference/" >Reference Documentation</a> Reference documentation including operators and API details. <h4 id="tutorials-and-examples" class="position-relative d-flex align-items-center group"> Tutorials and Examples <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="tutorials-and-examples" aria-haspopup="dialog" aria-label="Share link: Tutorials and Examples"> Share link </button> </h4><a href="/docs/tutorials/match-basics/" >MATCH Basics Tutorial</a> Step-by-step introduction to GQL with hands-on examples and exercises. <a href="/docs/gql/advanced-patterns/" >GQL Advanced Patterns</a> Deep dive into graph pattern matching with progressive complexity. <a href="/docs/use-cases/" >Use Cases</a> Practical GQL examples across various use cases and domains. <h3 id="common-gql-use-cases" class="position-relative d-flex align-items-center group"> Common GQL Use Cases <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="common-gql-use-cases" aria-haspopup="dialog" aria-label="Share link: Common GQL Use Cases"> Share link </button> </h3> <h4 id="social-network-queries" class="position-relative d-flex align-items-center group"> Social Network Queries <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="social-network-queries" aria-haspopup="dialog" aria-label="Share link: Social Network Queries"> Share link </button> </h4>Find friends, communities, influence: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">// Friends of friends MATCH (me:Person {id: $userId})-[:KNOWS*2..2]->(fof) WHERE fof <> me RETURN DISTINCT fof.name // Community detection MATCH (p:Person)-[:KNOWS]-(friend) WITH p, COUNT(friend) AS degree WHERE degree > 10 RETURN p.name, degree ORDER BY degree DESC </code></pre></div> <h4 id="recommendation-queries" class="position-relative d-flex align-items-center group"> Recommendation Queries <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="recommendation-queries" aria-haspopup="dialog" aria-label="Share link: Recommendation Queries"> Share link </button> </h4>Collaborative filtering, similar items: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">// Product recommendations MATCH (me:User {id: $userId})-[:PURCHASED]->(p:Product) <-[:PURCHASED]-(other:User)-[:PURCHASED]->(rec:Product) WHERE NOT (me)-[:PURCHASED]->(rec) WITH rec, COUNT(other) AS score RETURN rec.name, score ORDER BY score DESC LIMIT 10 </code></pre></div> <h4 id="hierarchy-queries" class="position-relative d-flex align-items-center group"> Hierarchy Queries <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="hierarchy-queries" aria-haspopup="dialog" aria-label="Share link: Hierarchy Queries"> Share link </button> </h4>Organization charts, category trees: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">// Report chain MATCH path = (employee:Person)-[:REPORTS_TO*]->(ceo:Person) WHERE employee.id = $employeeId AND NOT (ceo)-[:REPORTS_TO]->() RETURN [p IN nodes(path) | p.name] AS chain // Subtree query MATCH (category:Category {id: $categoryId})-[:PARENT_OF*]->(child) RETURN child.name </code></pre></div> <h4 id="path-queries" class="position-relative d-flex align-items-center group"> Path Queries <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="path-queries" aria-haspopup="dialog" aria-label="Share link: Path Queries"> Share link </button> </h4>Shortest paths, connectivity: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">// Shortest path MATCH path = shortestPath( (a:Person {id: $id1})-[:KNOWS*]-(b:Person {id: $id2}) ) RETURN length(path) AS distance, [n IN nodes(path) | n.name] AS names // All paths with constraints MATCH path = (a:Person)-[:KNOWS*1..5]-(b:Person) WHERE a.id = $id1 AND b.id = $id2 RETURN path LIMIT 100 </code></pre></div> <h4 id="analytical-queries" class="position-relative d-flex align-items-center group"> Analytical Queries <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="analytical-queries" aria-haspopup="dialog" aria-label="Share link: Analytical Queries"> Share link </button> </h4>Graph metrics, statistics: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">// Degree distribution MATCH (p:Person)-[r:KNOWS]-() WITH p, COUNT(r) AS degree RETURN degree, COUNT(p) AS node_count ORDER BY degree // Connected components size MATCH (p:Person) OPTIONAL MATCH path = (p)-[:KNOWS*]-(other) WITH p.component_id AS component, COUNT(DISTINCT p) AS size RETURN size, COUNT(component) AS components ORDER BY size DESC </code></pre></div> <h3 id="gql-best-practices" class="position-relative d-flex align-items-center group"> GQL Best Practices <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="gql-best-practices" aria-haspopup="dialog" aria-label="Share link: GQL Best Practices"> Share link </button> </h3> <h4 id="query-writing" class="position-relative d-flex align-items-center group"> Query Writing <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="query-writing" aria-haspopup="dialog" aria-label="Share link: Query Writing"> Share link </button> </h4><ol> <li>Start specific: Begin MATCH with the most selective pattern</li> <li>Filter early: Use WHERE immediately after MATCH for selectivity</li> <li>Limit results: Always use LIMIT for open-ended queries</li> <li>Use parameters: Parameterize queries for caching and security</li> <li>Avoid Cartesian products: Ensure patterns are connected</li> </ol> <h4 id="pattern-design" class="position-relative d-flex align-items-center group"> Pattern Design <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="pattern-design" aria-haspopup="dialog" aria-label="Share link: Pattern Design"> Share link </button> </h4><ol> <li>Anchor patterns: Start with indexed properties (IDs, unique values)</li> <li>Direction matters: Use directed relationships when known</li> <li>Relationship types: Specify types to enable index usage</li> <li>Variable-length carefully: Limit maximum depth to avoid infinite expansion</li> <li>Optional matches last: Place OPTIONAL MATCH after required patterns</li> </ol> <h4 id="performance-optimization" class="position-relative d-flex align-items-center group"> Performance Optimization <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="performance-optimization" aria-haspopup="dialog" aria-label="Share link: Performance Optimization"> Share link </button> </h4><ol> <li>Create indexes: Index frequently queried properties and relationship types</li> <li>Use EXPLAIN: Verify query plans before deployment</li> <li>Profile queries: Use PROFILE to measure actual execution time</li> <li>Batch operations: Group inserts/updates for better throughput</li> <li>Denormalize strategically: Duplicate data when read patterns justify it</li> </ol> <h4 id="code-quality" class="position-relative d-flex align-items-center group"> Code Quality <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="code-quality" aria-haspopup="dialog" aria-label="Share link: Code Quality"> Share link </button> </h4><ol> <li>Format queries: Use consistent indentation and line breaks</li> <li>Comment complex logic: Explain non-obvious patterns</li> <li>Use meaningful names: Choose descriptive variable names</li> <li>Validate inputs: Check parameters before query execution</li> <li>Handle errors: Implement proper error handling</li> </ol> <h3 id="gql-features-by-version" class="position-relative d-flex align-items-center group"> GQL Features by Version <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="gql-features-by-version" aria-haspopup="dialog" aria-label="Share link: GQL Features by Version"> Share link </button> </h3>Geode’s GQL implementation is production-ready with all ISO features: **v0.2.18+ (Current stable line)**: <ul> <li>✅ ISO/IEC 39075:2024 compliance</li> <li>✅ MATCH and OPTIONAL MATCH with bounded expansions</li> <li>✅ Aggregations and set operations</li> <li>✅ Deterministic ordering and pagination policies</li> <li>✅ Diagnostics aligned to the conformance profile</li> </ul> <h3 id="isoiec-390752024-standard" class="position-relative d-flex align-items-center group"> ISO/IEC 39075:2024 Standard <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="isoiec-390752024-standard" aria-haspopup="dialog" aria-label="Share link: ISO/IEC 39075:2024 Standard"> Share link </button> </h3>The GQL standard defines: Part 1: Framework: Overall structure, conformance levels, implementation requirements Part 2: Foundation: Core graph concepts, data types, pattern matching, basic queries Part 3: Extended Features: Advanced patterns, paths, graph unions, computed properties Part 4: Routines and Types: Standard functions, user-defined functions, type system Geode implements the complete standard, certified through the official ISO test suite. <h3 id="tools-for-gql-development" class="position-relative d-flex align-items-center group"> Tools for GQL Development <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="tools-for-gql-development" aria-haspopup="dialog" aria-label="Share link: Tools for GQL Development"> Share link </button> </h3> <h4 id="interactive-shell-repl" class="position-relative d-flex align-items-center group"> Interactive Shell (REPL) <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="interactive-shell-repl" aria-haspopup="dialog" aria-label="Share link: Interactive Shell (REPL)"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">geode shell </code></pre></div>Interactive query development with autocomplete, syntax highlighting, and query history. <h4 id="explain-and-profile" class="position-relative d-flex align-items-center group"> EXPLAIN and PROFILE <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="explain-and-profile" aria-haspopup="dialog" aria-label="Share link: EXPLAIN and PROFILE"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">EXPLAIN MATCH (p:Person)-[:KNOWS]->(f) RETURN p, f PROFILE MATCH (p:Person)-[:KNOWS]->(f) RETURN p, f </code></pre></div>Visualize query execution plans and measure performance. <h4 id="ide-integration" class="position-relative d-flex align-items-center group"> IDE Integration <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="ide-integration" aria-haspopup="dialog" aria-label="Share link: IDE Integration"> Share link </button> </h4>Geode provides Language Server Protocol (LSP) support for GQL syntax highlighting, autocomplete, and error checking in editors like VS Code, Vim, and Emacs. <h3 id="gql-resources" class="position-relative d-flex align-items-center group"> GQL Resources <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="gql-resources" aria-haspopup="dialog" aria-label="Share link: GQL Resources"> Share link </button> </h3> <h4 id="official-documentation" class="position-relative d-flex align-items-center group"> Official Documentation <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="official-documentation" aria-haspopup="dialog" aria-label="Share link: Official Documentation"> Share link </button> </h4><ul> <li><a href="/docs/gql/guide/" >GQL Guide</a> - Complete language guide</li> <li><a href="/docs/gql-reference/" >GQL Reference</a> - Syntax reference</li> <li><a href="/docs/quick-reference/" >Quick Reference</a> - Cheat sheet</li> </ul> <h4 id="learning-resources" class="position-relative d-flex align-items-center group"> Learning Resources <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="learning-resources" aria-haspopup="dialog" aria-label="Share link: Learning Resources"> Share link </button> </h4><ul> <li><a href="/categories/tutorials/" >Tutorials</a> - Step-by-step learning paths</li> <li><a href="/categories/examples/" >Examples</a> - Practical code samples</li> <li><a href="/categories/best-practices/" >Best Practices</a> - Production patterns</li> </ul> <h4 id="performance-resources" class="position-relative d-flex align-items-center group"> Performance Resources <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="performance-resources" aria-haspopup="dialog" aria-label="Share link: Performance Resources"> Share link </button> </h4><ul> <li><a href="/categories/query-optimization/" >Query Optimization</a> - Optimization techniques</li> <li><a href="/categories/performance/" >Performance Tuning</a> - Performance guides</li> <li><a href="/docs/query/indexing-and-optimization/" >Indexing Guide</a> - Index strategies</li> </ul> <h3 id="related-categories" class="position-relative d-flex align-items-center group"> Related Categories <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="related-categories" aria-haspopup="dialog" aria-label="Share link: Related Categories"> Share link </button> </h3><ul> <li><a href="/categories/query/" >Query Language & Patterns</a> - Query optimization and advanced techniques</li> <li><a href="/categories/tutorials/" >Tutorials</a> - Hands-on learning materials</li> <li><a href="/categories/reference/" >Reference</a> - Complete technical reference</li> <li><a href="/categories/performance/" >Performance</a> - Performance optimization</li> <li><a href="/categories/examples/" >Examples</a> - Practical code examples</li> </ul> <h3 id="related-tags" class="position-relative d-flex align-items-center group"> Related Tags <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="related-tags" aria-haspopup="dialog" aria-label="Share link: Related Tags"> Share link </button> </h3><ul> <li><a href="/tags/pattern-matching/" >Pattern Matching</a> - Pattern matching techniques</li> <li><a href="/tags/query-optimization/" >Query Optimization</a> - Query performance</li> <li><a href="/tags/iso-standard/" >ISO Standard</a> - ISO/IEC 39075:2024 compliance</li> <li><a href="/tags/match/" >MATCH</a> - MATCH clause documentation</li> <li><a href="/tags/gql-compliance/" >GQL Compliance</a> - Standards conformance</li> </ul> <h3 id="community-and-support" class="position-relative d-flex align-items-center group"> Community and Support <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="community-and-support" aria-haspopup="dialog" aria-label="Share link: Community and Support"> Share link </button> </h3> <h4 id="getting-help" class="position-relative d-flex align-items-center group"> Getting Help <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="getting-help" aria-haspopup="dialog" aria-label="Share link: Getting Help"> Share link </button> </h4><ul> <li>Documentation: Start with guides and reference documentation</li> <li>Examples: Review practical examples for common patterns</li> <li>GitHub Issues: Report bugs or request features</li> <li>Community Forums: Ask questions and share knowledge</li> <li>Commercial Support: Available for enterprise customers</li> </ul> <h4 id="contributing" class="position-relative d-flex align-items-center group"> Contributing <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="contributing" aria-haspopup="dialog" aria-label="Share link: Contributing"> Share link </button> </h4>Found a GQL bug? Have a feature request? Contributions welcome: <ul> <li>Bug Reports: Detailed reproduction steps with queries</li> <li>Feature Requests: Use cases and examples</li> <li>Documentation: Improvements to guides and examples</li> <li>Test Cases: Additional conformance tests</li> </ul> <h3 id="next-steps" class="position-relative d-flex align-items-center group"> Next Steps <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="next-steps" aria-haspopup="dialog" aria-label="Share link: Next Steps"> Share link </button> </h3>New to GQL? Start with the <a href="/docs/gql/guide/" >GQL Guide</a> for a comprehensive introduction. Learning by example? Browse <a href="/categories/examples/" >GQL Examples</a> for practical code samples. Optimizing queries? Check out <a href="/categories/query-optimization/" >Query Optimization</a> for performance techniques. Building applications? Review <a href="/categories/client-libraries/" >Client Libraries</a> for language-specific GQL usage. Advanced features? Explore <a href="/docs/gql/advanced-patterns/" >Advanced Patterns</a> for complex query techniques. <hr> Standard: ISO/IEC 39075:2024 Conformance Profile: ISO/IEC 39075:2024 compliance (see conformance profile) Last Updated: January 2026 Geode Version: v0.2.18+

Popular

Related Articles

Pattern Matching in GQL

Data Model and Types

Graph Query Language (GQL) Guide

Querying, Indexing, and Query Optimization

Transactions and Data Integrity

GQL Tutorial

Aggregation Functions

GQL Quick Reference

GQL Conformance Profile

EXPLAIN Command

PROFILE Command

Advanced GQL Query Patterns