Quick Start Guide | Geode Database

<h2 id="quick-start-guide" class="position-relative d-flex align-items-center group"> Quick Start Guide <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="quick-start-guide" aria-haspopup="dialog" aria-label="Share link: Quick Start Guide"> 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>Get up and running with Geode in just 5 minutes. This guide walks you through installation, creating your first graph, and running basic queries. <h3 id="prerequisites" class="position-relative d-flex align-items-center group"> Prerequisites <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="prerequisites" aria-haspopup="dialog" aria-label="Share link: Prerequisites"> Share link </button> </h3><ul> <li>Docker installed (recommended) OR</li> <li>Go 1.24.0+ (for building from source)</li> </ul> <h3 id="step-1-start-geode" class="position-relative d-flex align-items-center group"> Step 1: Start 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="step-1-start-geode" aria-haspopup="dialog" aria-label="Share link: Step 1: Start Geode"> Share link </button> </h3> <h4 id="using-docker-recommended" class="position-relative d-flex align-items-center group"> Using Docker (Recommended) <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="using-docker-recommended" aria-haspopup="dialog" aria-label="Share link: Using Docker (Recommended)"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">docker run -d \ --name geode \ -p 3141:3141 \ -v geode-data:/var/lib/geode \ geodedb/geode:latest serve --listen 0.0.0.0:3141 </code></pre></div> <h4 id="using-docker-compose" class="position-relative d-flex align-items-center group"> Using Docker Compose <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="using-docker-compose" aria-haspopup="dialog" aria-label="Share link: Using Docker Compose"> Share link </button> </h4>Create <code>docker-compose.yml</code>: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">version: '3.8' services: geode: image: geodedb/geode:latest ports: - "3141:3141" volumes: - geode-data:/var/lib/geode environment: - GEODE_LOG_LEVEL=info command: ["serve", "--listen", "0.0.0.0:3141"] volumes: geode-data: </code></pre></div>Start: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">docker-compose up -d </code></pre></div> <h4 id="from-source" class="position-relative d-flex align-items-center group"> From Source <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="from-source" aria-haspopup="dialog" aria-label="Share link: From Source"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">git clone https://gitlab.com/devnw/codepros/geode/geode cd geode make build ./zig-out/bin/geode serve --listen 0.0.0.0:3141 </code></pre></div> <h3 id="step-2-install-client" class="position-relative d-flex align-items-center group"> Step 2: Install Client <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="step-2-install-client" aria-haspopup="dialog" aria-label="Share link: Step 2: Install Client"> Share link </button> </h3>Choose your preferred language: <div class="docs-tabs mb-4"> <ul class="nav nav-tabs" id="tabs-1774880881716879876" role="tablist"><li class="nav-item" role="presentation"> <button class="nav-link active" id="tabs-1774880881716879876-tab-0-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881716879876-tab-0" type="button" role="tab" aria-controls="tabs-1774880881716879876-tab-0" aria-selected="true" > Go </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881716879876-tab-1-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881716879876-tab-1" type="button" role="tab" aria-controls="tabs-1774880881716879876-tab-1" aria-selected="false" > Python </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881716879876-tab-2-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881716879876-tab-2" type="button" role="tab" aria-controls="tabs-1774880881716879876-tab-2" aria-selected="false" > Rust </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881716879876-tab-3-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881716879876-tab-3" type="button" role="tab" aria-controls="tabs-1774880881716879876-tab-3" aria-selected="false" > Node.js </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881716879876-tab-4-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881716879876-tab-4" type="button" role="tab" aria-controls="tabs-1774880881716879876-tab-4" aria-selected="false" > Zig </button> </li></ul> <div class="tab-content border border-top-0 rounded-bottom p-3" id="tabs-1774880881716879876-content"><div class="tab-pane fade show active" id="tabs-1774880881716879876-tab-0" role="tabpanel" aria-labelledby="tabs-1774880881716879876-tab-0-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">go get geodedb.com/geode </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881716879876-tab-1" role="tabpanel" aria-labelledby="tabs-1774880881716879876-tab-1-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">pip install geode-client </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881716879876-tab-2" role="tabpanel" aria-labelledby="tabs-1774880881716879876-tab-2-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-toml" data-lang="toml"># Add to Cargo.toml [dependencies] geode-client = "0.1" tokio = { version = "1", features = ["full"] } </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881716879876-tab-3" role="tabpanel" aria-labelledby="tabs-1774880881716879876-tab-3-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">npm install @geodedb/client </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881716879876-tab-4" role="tabpanel" aria-labelledby="tabs-1774880881716879876-tab-4-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Add to build.zig.zon dependencies .geode_client = .{ .url = "https://gitlab.com/devnw/codepros/geode/geode-client-zig/-/archive/main/geode-client-zig-main.tar.gz", }, </code></pre></div> </div></div> </div> <h4 id="cli-tool" class="position-relative d-flex align-items-center group"> CLI Tool <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="cli-tool" aria-haspopup="dialog" aria-label="Share link: CLI Tool"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Debian/Ubuntu curl -fsSL https://apt.geodedb.com/geode.gpg | sudo gpg --dearmor -o /usr/share/keyrings/geode-archive-keyring.gpg echo "deb [signed-by=/usr/share/keyrings/geode-archive-keyring.gpg] https://apt.geodedb.com stable main" | sudo tee /etc/apt/sources.list.d/geode.list sudo apt update && sudo apt install geode # Or via Docker docker exec -it geode geode shell </code></pre></div> <h3 id="step-3-verify-connection" class="position-relative d-flex align-items-center group"> Step 3: Verify Connection <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="step-3-verify-connection" aria-haspopup="dialog" aria-label="Share link: Step 3: Verify Connection"> Share link </button> </h3><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">geode ping localhost:3141 </code></pre></div>Expected output: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">Connected to Geode v0.1.0 Latency: 2ms </code></pre></div> <h3 id="step-4-create-your-first-graph" class="position-relative d-flex align-items-center group"> Step 4: Create Your First Graph <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="step-4-create-your-first-graph" aria-haspopup="dialog" aria-label="Share link: Step 4: Create Your First Graph"> Share link </button> </h3>Let’s create a simple social network. First, here’s the GQL: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">// Create people CREATE (:Person {name: "Alice", age: 30, city: "New York"}) CREATE (:Person {name: "Bob", age: 25, city: "San Francisco"}) CREATE (:Person {name: "Charlie", age: 35, city: "Seattle"}) // Create relationships MATCH (alice:Person {name: "Alice"}) MATCH (bob:Person {name: "Bob"}) CREATE (alice)-[:KNOWS {since: 2020}]->(bob) MATCH (bob:Person {name: "Bob"}) MATCH (charlie:Person {name: "Charlie"}) CREATE (bob)-[:KNOWS {since: 2019}]->(charlie) </code></pre></div> <h4 id="using-client-libraries" class="position-relative d-flex align-items-center group"> Using Client Libraries <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="using-client-libraries" aria-haspopup="dialog" aria-label="Share link: Using Client Libraries"> Share link </button> </h4><div class="docs-tabs mb-4"> <ul class="nav nav-tabs" id="tabs-1774880881719750116" role="tablist"><li class="nav-item" role="presentation"> <button class="nav-link active" id="tabs-1774880881719750116-tab-0-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881719750116-tab-0" type="button" role="tab" aria-controls="tabs-1774880881719750116-tab-0" aria-selected="true" > Go </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881719750116-tab-1-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881719750116-tab-1" type="button" role="tab" aria-controls="tabs-1774880881719750116-tab-1" aria-selected="false" > Python </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881719750116-tab-2-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881719750116-tab-2" type="button" role="tab" aria-controls="tabs-1774880881719750116-tab-2" aria-selected="false" > Rust </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881719750116-tab-3-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881719750116-tab-3" type="button" role="tab" aria-controls="tabs-1774880881719750116-tab-3" aria-selected="false" > Node.js </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881719750116-tab-4-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881719750116-tab-4" type="button" role="tab" aria-controls="tabs-1774880881719750116-tab-4" aria-selected="false" > Zig </button> </li></ul> <div class="tab-content border border-top-0 rounded-bottom p-3" id="tabs-1774880881719750116-content"><div class="tab-pane fade show active" id="tabs-1774880881719750116-tab-0" role="tabpanel" aria-labelledby="tabs-1774880881719750116-tab-0-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go">package main import ( "context" "database/sql" "log" _ "geodedb.com/geode" ) func main() { db, err := sql.Open("geode", "localhost:3141") if err != nil { log.Fatal(err) } defer db.Close() ctx := context.Background() // Create people _, err = db.ExecContext(ctx, `CREATE (:Person {name: ?, age: ?, city: ?})`, "Alice", 30, "New York") if err != nil { log.Fatal(err) } _, err = db.ExecContext(ctx, `CREATE (:Person {name: ?, age: ?, city: ?})`, "Bob", 25, "San Francisco") if err != nil { log.Fatal(err) } // Create relationship _, err = db.ExecContext(ctx, ` MATCH (a:Person {name: ?}), (b:Person {name: ?}) CREATE (a)-[:KNOWS {since: ?}]->(b) `, "Alice", "Bob", 2020) if err != nil { log.Fatal(err) } log.Println("Graph created!") } </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881719750116-tab-1" role="tabpanel" aria-labelledby="tabs-1774880881719750116-tab-1-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">import asyncio from geode_client import Client async def main(): client = Client(host="localhost", port=3141, skip_verify=True) async with client.connection() as conn: # Create people await conn.execute( "CREATE (:Person {name: $name, age: $age, city: $city})", {"name": "Alice", "age": 30, "city": "New York"} ) await conn.execute( "CREATE (:Person {name: $name, age: $age, city: $city})", {"name": "Bob", "age": 25, "city": "San Francisco"} ) # Create relationship await conn.execute(""" MATCH (a:Person {name: $from}), (b:Person {name: $to}) CREATE (a)-[:KNOWS {since: $since}]->(b) """, {"from": "Alice", "to": "Bob", "since": 2020}) print("Graph created!") asyncio.run(main()) </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881719750116-tab-2" role="tabpanel" aria-labelledby="tabs-1774880881719750116-tab-2-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-rust" data-lang="rust">use geode_client::{Client, Value}; use std::collections::HashMap; #[tokio::main] async fn main() -> Result<(), Box<dyn std::error::Error>> { let client = Client::new("127.0.0.1", 3141).skip_verify(true); let mut conn = client.connect().await?; // Create people let mut params = HashMap::new(); params.insert("name".to_string(), Value::string("Alice")); params.insert("age".to_string(), Value::int(30)); params.insert("city".to_string(), Value::string("New York")); conn.query_with_params( "CREATE (:Person {name: $name, age: $age, city: $city})", &params ).await?; params.insert("name".to_string(), Value::string("Bob")); params.insert("age".to_string(), Value::int(25)); params.insert("city".to_string(), Value::string("San Francisco")); conn.query_with_params( "CREATE (:Person {name: $name, age: $age, city: $city})", &params ).await?; // Create relationship let mut rel_params = HashMap::new(); rel_params.insert("from".to_string(), Value::string("Alice")); rel_params.insert("to".to_string(), Value::string("Bob")); rel_params.insert("since".to_string(), Value::int(2020)); conn.query_with_params(r#" MATCH (a:Person {name: $from}), (b:Person {name: $to}) CREATE (a)-[:KNOWS {since: $since}]->(b) "#, &rel_params).await?; println!("Graph created!"); Ok(()) } </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881719750116-tab-3" role="tabpanel" aria-labelledby="tabs-1774880881719750116-tab-3-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-typescript" data-lang="typescript">import { createClient } from '@geodedb/client'; async function main() { const client = await createClient('quic://localhost:3141'); // Create people await client.exec( 'CREATE (:Person {name: $name, age: $age, city: $city})', { params: { name: 'Alice', age: 30, city: 'New York' } } ); await client.exec( 'CREATE (:Person {name: $name, age: $age, city: $city})', { params: { name: 'Bob', age: 25, city: 'San Francisco' } } ); // Create relationship await client.exec(` MATCH (a:Person {name: $from}), (b:Person {name: $to}) CREATE (a)-[:KNOWS {since: $since}]->(b) `, { params: { from: 'Alice', to: 'Bob', since: 2020 } }); console.log('Graph created!'); await client.close(); } main(); </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881719750116-tab-4" role="tabpanel" aria-labelledby="tabs-1774880881719750116-tab-4-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">const std = @import("std"); const geode = @import("geode_client"); pub fn main() !void { var gpa = std.heap.GeneralPurposeAllocator(.{}){}; defer _ = gpa.deinit(); const allocator = gpa.allocator(); var client = geode.GeodeClient.init(allocator, "localhost", 3141, true); defer client.deinit(); try client.connect(); try client.sendHello("quickstart", "1.0.0"); _ = try client.receiveMessage(30000); // Create people with parameterized queries var params = std.json.ObjectMap.init(allocator); defer params.deinit(); try params.put("name", .{ .string = "Alice" }); try params.put("age", .{ .integer = 30 }); try params.put("city", .{ .string = "New York" }); try client.sendRunGql(1, "CREATE (:Person {name: $name, age: $age, city: $city})", .{ .object = params }); _ = try client.receiveMessage(30000); params.clearRetainingCapacity(); try params.put("name", .{ .string = "Bob" }); try params.put("age", .{ .integer = 25 }); try params.put("city", .{ .string = "San Francisco" }); try client.sendRunGql(2, "CREATE (:Person {name: $name, age: $age, city: $city})", .{ .object = params }); _ = try client.receiveMessage(30000); // Create relationship params.clearRetainingCapacity(); try params.put("from", .{ .string = "Alice" }); try params.put("to", .{ .string = "Bob" }); try params.put("since", .{ .integer = 2020 }); try client.sendRunGql(3, \\MATCH (a:Person {name: $from}), (b:Person {name: $to}) \\CREATE (a)-[:KNOWS {since: $since}]->(b) , .{ .object = params }); _ = try client.receiveMessage(30000); std.debug.print("Graph created!\n", .{}); } </code></pre></div> </div></div> </div> <h4 id="using-cli" class="position-relative d-flex align-items-center group"> Using CLI <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="using-cli" aria-haspopup="dialog" aria-label="Share link: Using CLI"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">geode shell geode> CREATE (:Person {name: 'Alice', age: 30, city: 'New York'}) geode> CREATE (:Person {name: 'Bob', age: 25, city: 'San Francisco'}) geode> MATCH (a:Person {name: 'Alice'}), (b:Person {name: 'Bob'}) CREATE (a)-[:KNOWS {since: 2020}]->(b) </code></pre></div> <h3 id="step-5-query-your-data" class="position-relative d-flex align-items-center group"> Step 5: Query Your Data <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="step-5-query-your-data" aria-haspopup="dialog" aria-label="Share link: Step 5: Query Your Data"> Share link </button> </h3> <h4 id="find-all-people" class="position-relative d-flex align-items-center group"> Find All People <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="find-all-people" aria-haspopup="dialog" aria-label="Share link: Find All People"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">MATCH (p:Person) RETURN p.name, p.age, p.city ORDER BY p.age </code></pre></div><div class="docs-tabs mb-4"> <ul class="nav nav-tabs" id="tabs-1774880881738237768" role="tablist"><li class="nav-item" role="presentation"> <button class="nav-link active" id="tabs-1774880881738237768-tab-0-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881738237768-tab-0" type="button" role="tab" aria-controls="tabs-1774880881738237768-tab-0" aria-selected="true" > Go </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881738237768-tab-1-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881738237768-tab-1" type="button" role="tab" aria-controls="tabs-1774880881738237768-tab-1" aria-selected="false" > Python </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881738237768-tab-2-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881738237768-tab-2" type="button" role="tab" aria-controls="tabs-1774880881738237768-tab-2" aria-selected="false" > Rust </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881738237768-tab-3-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881738237768-tab-3" type="button" role="tab" aria-controls="tabs-1774880881738237768-tab-3" aria-selected="false" > Node.js </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881738237768-tab-4-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881738237768-tab-4" type="button" role="tab" aria-controls="tabs-1774880881738237768-tab-4" aria-selected="false" > Zig </button> </li></ul> <div class="tab-content border border-top-0 rounded-bottom p-3" id="tabs-1774880881738237768-content"><div class="tab-pane fade show active" id="tabs-1774880881738237768-tab-0" role="tabpanel" aria-labelledby="tabs-1774880881738237768-tab-0-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go">rows, err := db.QueryContext(ctx, ` MATCH (p:Person) RETURN p.name, p.age, p.city ORDER BY p.age `) if err != nil { log.Fatal(err) } defer rows.Close() for rows.Next() { var name, city string var age int rows.Scan(&name, &age, &city) fmt.Printf("%s, %d, %s\n", name, age, city) } </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881738237768-tab-1" role="tabpanel" aria-labelledby="tabs-1774880881738237768-tab-1-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">async with client.connection() as conn: page, _ = await conn.query(""" MATCH (p:Person) RETURN p.name, p.age, p.city ORDER BY p.age """) for row in page.rows: print(f"{row['p.name'].as_string}, {row['p.age'].as_int}, {row['p.city'].as_string}") </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881738237768-tab-2" role="tabpanel" aria-labelledby="tabs-1774880881738237768-tab-2-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-rust" data-lang="rust">let (page, _) = conn.query(r#" MATCH (p:Person) RETURN p.name, p.age, p.city ORDER BY p.age "#).await?; for row in &page.rows { let name = row.get("p.name").unwrap().as_string()?; let age = row.get("p.age").unwrap().as_int()?; let city = row.get("p.city").unwrap().as_string()?; println!("{}, {}, {}", name, age, city); } </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881738237768-tab-3" role="tabpanel" aria-labelledby="tabs-1774880881738237768-tab-3-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-typescript" data-lang="typescript">const rows = await client.queryAll(` MATCH (p:Person) RETURN p.name, p.age, p.city ORDER BY p.age `); for (const row of rows) { console.log(`${row.get('p.name')?.asString}, ${row.get('p.age')?.asNumber}, ${row.get('p.city')?.asString}`); } </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881738237768-tab-4" role="tabpanel" aria-labelledby="tabs-1774880881738237768-tab-4-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">try client.sendRunGql(1, \\MATCH (p:Person) \\RETURN p.name, p.age, p.city \\ORDER BY p.age , null); const schema = try client.receiveMessage(30000); defer allocator.free(schema); // Pull results try client.sendPull(1, 1000); const result = try client.receiveMessage(30000); defer allocator.free(result); // Parse JSON response and iterate rows std.debug.print("Result: {s}\n", .{result}); </code></pre></div> </div></div> </div> Expected output: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">| p.name | p.age | p.city | |----------|-------|----------------| | Bob | 25 | San Francisco | | Alice | 30 | New York | | Charlie | 35 | Seattle | </code></pre></div> <h4 id="find-friends" class="position-relative d-flex align-items-center group"> Find Friends <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="find-friends" aria-haspopup="dialog" aria-label="Share link: Find Friends"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">MATCH (p:Person)-[:KNOWS]->(friend:Person) RETURN p.name AS person, friend.name AS friend </code></pre></div><div class="docs-tabs mb-4"> <ul class="nav nav-tabs" id="tabs-1774880881744683436" role="tablist"><li class="nav-item" role="presentation"> <button class="nav-link active" id="tabs-1774880881744683436-tab-0-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881744683436-tab-0" type="button" role="tab" aria-controls="tabs-1774880881744683436-tab-0" aria-selected="true" > Go </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881744683436-tab-1-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881744683436-tab-1" type="button" role="tab" aria-controls="tabs-1774880881744683436-tab-1" aria-selected="false" > Python </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881744683436-tab-2-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881744683436-tab-2" type="button" role="tab" aria-controls="tabs-1774880881744683436-tab-2" aria-selected="false" > Rust </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881744683436-tab-3-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881744683436-tab-3" type="button" role="tab" aria-controls="tabs-1774880881744683436-tab-3" aria-selected="false" > Node.js </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881744683436-tab-4-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881744683436-tab-4" type="button" role="tab" aria-controls="tabs-1774880881744683436-tab-4" aria-selected="false" > Zig </button> </li></ul> <div class="tab-content border border-top-0 rounded-bottom p-3" id="tabs-1774880881744683436-content"><div class="tab-pane fade show active" id="tabs-1774880881744683436-tab-0" role="tabpanel" aria-labelledby="tabs-1774880881744683436-tab-0-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go">rows, _ := db.QueryContext(ctx, ` MATCH (p:Person)-[:KNOWS]->(friend:Person) RETURN p.name AS person, friend.name AS friend `) defer rows.Close() for rows.Next() { var person, friend string rows.Scan(&person, &friend) fmt.Printf("%s knows %s\n", person, friend) } </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881744683436-tab-1" role="tabpanel" aria-labelledby="tabs-1774880881744683436-tab-1-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">page, _ = await conn.query(""" MATCH (p:Person)-[:KNOWS]->(friend:Person) RETURN p.name AS person, friend.name AS friend """) for row in page.rows: print(f"{row['person'].as_string} knows {row['friend'].as_string}") </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881744683436-tab-2" role="tabpanel" aria-labelledby="tabs-1774880881744683436-tab-2-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-rust" data-lang="rust">let (page, _) = conn.query(r#" MATCH (p:Person)-[:KNOWS]->(friend:Person) RETURN p.name AS person, friend.name AS friend "#).await?; for row in &page.rows { println!("{} knows {}", row.get("person").unwrap().as_string()?, row.get("friend").unwrap().as_string()?); } </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881744683436-tab-3" role="tabpanel" aria-labelledby="tabs-1774880881744683436-tab-3-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-typescript" data-lang="typescript">const rows = await client.queryAll(` MATCH (p:Person)-[:KNOWS]->(friend:Person) RETURN p.name AS person, friend.name AS friend `); for (const row of rows) { console.log(`${row.get('person')?.asString} knows ${row.get('friend')?.asString}`); } </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881744683436-tab-4" role="tabpanel" aria-labelledby="tabs-1774880881744683436-tab-4-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">try client.sendRunGql(1, \\MATCH (p:Person)-[:KNOWS]->(friend:Person) \\RETURN p.name AS person, friend.name AS friend , null); const schema = try client.receiveMessage(30000); defer allocator.free(schema); try client.sendPull(1, 1000); const result = try client.receiveMessage(30000); defer allocator.free(result); std.debug.print("Result: {s}\n", .{result}); </code></pre></div> </div></div> </div> Expected output: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">| person | friend | |---------|---------| | Alice | Bob | | Bob | Charlie | </code></pre></div> <h4 id="find-friends-of-friends" class="position-relative d-flex align-items-center group"> Find Friends of Friends <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="find-friends-of-friends" aria-haspopup="dialog" aria-label="Share link: Find Friends of Friends"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">MATCH (p:Person {name: "Alice"})-[:KNOWS*2..2]->(fof:Person) RETURN DISTINCT fof.name AS friend_of_friend </code></pre></div>Expected output: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">| friend_of_friend | |------------------| | Charlie | </code></pre></div> <h4 id="count-by-city" class="position-relative d-flex align-items-center group"> Count by City <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="count-by-city" aria-haspopup="dialog" aria-label="Share link: Count by City"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">MATCH (p:Person) RETURN p.city, count(p) AS population ORDER BY population DESC </code></pre></div>Expected output: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">| p.city | population | |---------------|------------| | New York | 1 | | San Francisco | 1 | | Seattle | 1 | </code></pre></div> <h3 id="step-6-use-transactions" class="position-relative d-flex align-items-center group"> Step 6: Use Transactions <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="step-6-use-transactions" aria-haspopup="dialog" aria-label="Share link: Step 6: Use Transactions"> Share link </button> </h3><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">BEGIN // Create a person CREATE (:Person {name: "David", age: 28}) // Create relationship MATCH (david:Person {name: "David"}) MATCH (alice:Person {name: "Alice"}) CREATE (david)-[:KNOWS]->(alice) COMMIT </code></pre></div><div class="docs-tabs mb-4"> <ul class="nav nav-tabs" id="tabs-1774880881749826862" role="tablist"><li class="nav-item" role="presentation"> <button class="nav-link active" id="tabs-1774880881749826862-tab-0-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881749826862-tab-0" type="button" role="tab" aria-controls="tabs-1774880881749826862-tab-0" aria-selected="true" > Go </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881749826862-tab-1-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881749826862-tab-1" type="button" role="tab" aria-controls="tabs-1774880881749826862-tab-1" aria-selected="false" > Python </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881749826862-tab-2-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881749826862-tab-2" type="button" role="tab" aria-controls="tabs-1774880881749826862-tab-2" aria-selected="false" > Rust </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881749826862-tab-3-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881749826862-tab-3" type="button" role="tab" aria-controls="tabs-1774880881749826862-tab-3" aria-selected="false" > Node.js </button> </li><li class="nav-item" role="presentation"> <button class="nav-link" id="tabs-1774880881749826862-tab-4-tab" data-bs-toggle="tab" data-bs-target="#tabs-1774880881749826862-tab-4" type="button" role="tab" aria-controls="tabs-1774880881749826862-tab-4" aria-selected="false" > Zig </button> </li></ul> <div class="tab-content border border-top-0 rounded-bottom p-3" id="tabs-1774880881749826862-content"><div class="tab-pane fade show active" id="tabs-1774880881749826862-tab-0" role="tabpanel" aria-labelledby="tabs-1774880881749826862-tab-0-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go">tx, err := db.BeginTx(ctx, nil) if err != nil { log.Fatal(err) } // Create a person _, err = tx.ExecContext(ctx, `CREATE (:Person {name: ?, age: ?})`, "David", 28) if err != nil { tx.Rollback() log.Fatal(err) } // Create relationship _, err = tx.ExecContext(ctx, ` MATCH (d:Person {name: ?}), (a:Person {name: ?}) CREATE (d)-[:KNOWS]->(a) `, "David", "Alice") if err != nil { tx.Rollback() log.Fatal(err) } err = tx.Commit() if err != nil { log.Fatal(err) } log.Println("Transaction committed!") </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881749826862-tab-1" role="tabpanel" aria-labelledby="tabs-1774880881749826862-tab-1-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">async with client.connection() as conn: await conn.begin() try: # Create a person await conn.execute( "CREATE (:Person {name: $name, age: $age})", {"name": "David", "age": 28} ) # Create relationship await conn.execute(""" MATCH (d:Person {name: $david}), (a:Person {name: $alice}) CREATE (d)-[:KNOWS]->(a) """, {"david": "David", "alice": "Alice"}) await conn.commit() print("Transaction committed!") except Exception as e: await conn.rollback() raise e </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881749826862-tab-2" role="tabpanel" aria-labelledby="tabs-1774880881749826862-tab-2-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-rust" data-lang="rust">conn.begin().await?; // Create a person let mut params = HashMap::new(); params.insert("name".to_string(), Value::string("David")); params.insert("age".to_string(), Value::int(28)); conn.query_with_params("CREATE (:Person {name: $name, age: $age})", &params).await?; // Create relationship let mut rel_params = HashMap::new(); rel_params.insert("david".to_string(), Value::string("David")); rel_params.insert("alice".to_string(), Value::string("Alice")); match conn.query_with_params(r#" MATCH (d:Person {name: $david}), (a:Person {name: $alice}) CREATE (d)-[:KNOWS]->(a) "#, &rel_params).await { Ok(_) => { conn.commit().await?; println!("Transaction committed!"); } Err(e) => { conn.rollback().await?; return Err(e.into()); } } </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881749826862-tab-3" role="tabpanel" aria-labelledby="tabs-1774880881749826862-tab-3-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-typescript" data-lang="typescript">await client.withTransaction(async (tx) => { // Create a person await tx.exec( 'CREATE (:Person {name: $name, age: $age})', { params: { name: 'David', age: 28 } } ); // Create relationship await tx.exec(` MATCH (d:Person {name: $david}), (a:Person {name: $alice}) CREATE (d)-[:KNOWS]->(a) `, { params: { david: 'David', alice: 'Alice' } }); // Auto-commits on success }); console.log('Transaction committed!'); </code></pre></div> </div><div class="tab-pane fade" id="tabs-1774880881749826862-tab-4" role="tabpanel" aria-labelledby="tabs-1774880881749826862-tab-4-tab" > <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">// Begin transaction try client.sendBegin(); _ = try client.receiveMessage(30000); // Create a person with params var params = std.json.ObjectMap.init(allocator); defer params.deinit(); try params.put("name", .{ .string = "David" }); try params.put("age", .{ .integer = 28 }); try client.sendRunGql(1, "CREATE (:Person {name: $name, age: $age})", .{ .object = params }); _ = try client.receiveMessage(30000); // Create relationship with params params.clearRetainingCapacity(); try params.put("david", .{ .string = "David" }); try params.put("alice", .{ .string = "Alice" }); try client.sendRunGql(2, \\MATCH (d:Person {name: $david}), (a:Person {name: $alice}) \\CREATE (d)-[:KNOWS]->(a) , .{ .object = params }); _ = try client.receiveMessage(30000); // Commit try client.sendCommit(); _ = try client.receiveMessage(30000); std.debug.print("Transaction committed!\n", .{}); </code></pre></div> </div></div> </div> <h3 id="step-7-create-indexes" class="position-relative d-flex align-items-center group"> Step 7: Create Indexes <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="step-7-create-indexes" aria-haspopup="dialog" aria-label="Share link: Step 7: Create Indexes"> Share link </button> </h3>Improve query performance with indexes: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">// Create index on Person.name CREATE INDEX person_name ON :Person(name) // Create index on Person.age CREATE INDEX person_age ON :Person(age) // Verify indexes SHOW INDEXES </code></pre></div> <h3 id="step-8-add-constraints" class="position-relative d-flex align-items-center group"> Step 8: Add Constraints <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="step-8-add-constraints" aria-haspopup="dialog" aria-label="Share link: Step 8: Add Constraints"> Share link </button> </h3>Ensure data integrity: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">// Ensure Person.name is unique CREATE CONSTRAINT person_name_unique ON :Person(name) ASSERT UNIQUE // Ensure Person.age exists CREATE CONSTRAINT person_age_exists ON :Person(age) ASSERT EXISTS </code></pre></div> <h3 id="common-operations" class="position-relative d-flex align-items-center group"> Common Operations <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-operations" aria-haspopup="dialog" aria-label="Share link: Common Operations"> Share link </button> </h3> <h4 id="update-properties" class="position-relative d-flex align-items-center group"> Update Properties <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="update-properties" aria-haspopup="dialog" aria-label="Share link: Update Properties"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">MATCH (p:Person {name: "Alice"}) SET p.age = 31, p.updated_at = timestamp() </code></pre></div> <h4 id="delete-relationships" class="position-relative d-flex align-items-center group"> Delete Relationships <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="delete-relationships" aria-haspopup="dialog" aria-label="Share link: Delete Relationships"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">MATCH (p:Person {name: "Alice"})-[r:KNOWS]->() DELETE r </code></pre></div> <h4 id="delete-nodes" class="position-relative d-flex align-items-center group"> Delete Nodes <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="delete-nodes" aria-haspopup="dialog" aria-label="Share link: Delete Nodes"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">MATCH (p:Person {name: "Alice"}) DELETE p </code></pre></div> <h4 id="delete-everything" class="position-relative d-flex align-items-center group"> Delete Everything <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="delete-everything" aria-haspopup="dialog" aria-label="Share link: Delete Everything"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">MATCH (n) DETACH DELETE n </code></pre></div> <h3 id="interactive-cli" class="position-relative d-flex align-items-center group"> Interactive CLI <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-cli" aria-haspopup="dialog" aria-label="Share link: Interactive CLI"> Share link </button> </h3>Use the interactive CLI for exploration: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">geode cli -h localhost:3141 </code></pre></div>Example session: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">geode> MATCH (n) RETURN count(n) | count(n) | |----------| | 3 | geode> MATCH (p:Person) RETURN p.name | p.name | |----------| | Alice | | Bob | | Charlie | geode> \help Available commands: \help - Show this help \exit - Exit the CLI \clear - Clear screen \schema - Show schema \indexes - Show indexes geode> \exit Goodbye! </code></pre></div> <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>Now that you have Geode running: <ol> <li>Learn GQL: Read the <a href="/docs/gql-reference/" >GQL Reference</a> to master the query language</li> <li>Design Your Schema: Follow the <a href="/guides/graph-modeling/" >Graph Modeling Guide</a> </li> <li>Optimize Performance: Check out <a href="/guides/query-performance/" >Query Optimization</a> </li> <li>Build an Application: See <a href="/docs/tutorials/" >Example Applications</a> </li> <li>Deploy to Production: Review <a href="/guides/production-deployment/" >Production Deployment</a> </li> </ol> <h3 id="troubleshooting" class="position-relative d-flex align-items-center group"> Troubleshooting <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="troubleshooting" aria-haspopup="dialog" aria-label="Share link: Troubleshooting"> Share link </button> </h3> <h4 id="connection-refused" class="position-relative d-flex align-items-center group"> Connection Refused <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="connection-refused" aria-haspopup="dialog" aria-label="Share link: Connection Refused"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Check if Geode is running docker ps | grep geode # Check logs docker logs geode # Restart docker restart geode </code></pre></div> <h4 id="port-already-in-use" class="position-relative d-flex align-items-center group"> Port Already in Use <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="port-already-in-use" aria-haspopup="dialog" aria-label="Share link: Port Already in Use"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Use different port docker run -d -p 3142:3141 geode:latest # Then connect geode ping localhost:3142 </code></pre></div> <h4 id="query-errors" class="position-relative d-flex align-items-center group"> Query Errors <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-errors" aria-haspopup="dialog" aria-label="Share link: Query Errors"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Enable verbose logging geode exec -v -q "MATCH (n) RETURN n" # Check query syntax geode check query.gql </code></pre></div> <h3 id="resources" class="position-relative d-flex align-items-center group"> 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="resources" aria-haspopup="dialog" aria-label="Share link: Resources"> Share link </button> </h3><ul> <li><a href="/docs/" >Full Documentation</a> </li> <li><a href="/docs/gql-reference/" >GQL Reference</a> </li> <li><a href="/clients/" >Client Libraries</a> </li> <li><a href="/docs/use-cases/" >Use Cases</a> </li> <li><a href="https://forum.geodedb.com" aria-label="Community Forum – opens in new window" target="_blank" rel="noopener noreferrer" >Community Forum ↗ </a> </li> </ul> <h3 id="get-help" class="position-relative d-flex align-items-center group"> Get 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="get-help" aria-haspopup="dialog" aria-label="Share link: Get Help"> Share link </button> </h3><ul> <li><a href="https://docs.geodedb.com" aria-label="Documentation – opens in new window" target="_blank" rel="noopener noreferrer" >Documentation ↗ </a> </li> <li><a href="https://gitlab.com/devnw/codepros/geode/geode/-/issues" aria-label="GitLab Issues – opens in new window" target="_blank" rel="noopener noreferrer" >GitLab Issues ↗ </a> </li> <li><a href="https://chat.geodedb.com" aria-label="Community Chat – opens in new window" target="_blank" rel="noopener noreferrer" >Community Chat ↗ </a> </li> <li><a href="mailto:[email protected]" >Email Support</a> </li> </ul>

Related Guides

Building Your First Application

Installation Guide