Quickstart Resources

<h2 id="quickstart-resources" class="position-relative d-flex align-items-center group"> Quickstart 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="quickstart-resources" aria-haspopup="dialog" aria-label="Share link: Quickstart Resources"> 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>Quickstart resources provide the fastest path to productivity with Geode graph database. Skip lengthy explanations and jump straight into working code, essential commands, and production-ready patterns. <h3 id="60-second-installation" class="position-relative d-flex align-items-center group"> 60-Second Installation <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="60-second-installation" aria-haspopup="dialog" aria-label="Share link: 60-Second Installation"> Share link </button> </h3><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Docker (fastest) docker run -d -p 3141:3141 --name geode geodedb/geode:latest # Or build from source git clone https://github.com/codeprosorg/geode && cd geode && make build && ./zig-out/bin/geode serve </code></pre></div> <h3 id="30-second-first-query" class="position-relative d-flex align-items-center group"> 30-Second First Query <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="30-second-first-query" aria-haspopup="dialog" aria-label="Share link: 30-Second First Query"> Share link </button> </h3><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Install Python client pip install geode-client # Run first query python3 << 'PY' import asyncio from geode_client import Client async def quick(): client = Client(host="localhost", port=3141) async with client.connection() as conn: await conn.execute("CREATE (p:Person {name: 'Alice'})") page, _ = await conn.query("MATCH (p:Person) RETURN p.name AS name") print([row["name"].as_string for row in page.rows]) asyncio.run(quick()) PY </code></pre></div> <h3 id="essential-gql-cheatsheet" class="position-relative d-flex align-items-center group"> Essential GQL Cheatsheet <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="essential-gql-cheatsheet" aria-haspopup="dialog" aria-label="Share link: Essential GQL Cheatsheet"> Share link </button> </h3> <h4 id="crud-operations" class="position-relative d-flex align-items-center group"> CRUD 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="crud-operations" aria-haspopup="dialog" aria-label="Share link: CRUD Operations"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">-- CREATE CREATE (p:Person {name: 'Alice', age: 30}) -- READ MATCH (p:Person {name: 'Alice'}) RETURN p -- UPDATE MATCH (p:Person {name: 'Alice'}) SET p.age = 31 -- DELETE MATCH (p:Person {name: 'Alice'}) DETACH DELETE p </code></pre></div> <h4 id="relationships" class="position-relative d-flex align-items-center group"> 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="relationships" aria-haspopup="dialog" aria-label="Share link: Relationships"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">-- Create relationship MATCH (a:Person {name: 'Alice'}) MATCH (b:Person {name: 'Bob'}) CREATE (a)-[:KNOWS {since: 2020}]->(b) -- Query relationship MATCH (a:Person)-[:KNOWS]->(b:Person) RETURN a.name, b.name -- Delete relationship MATCH (a:Person)-[r:KNOWS]->(b:Person) WHERE a.name = 'Alice' AND b.name = 'Bob' DELETE r </code></pre></div> <h4 id="patterns" class="position-relative d-flex align-items-center group"> Patterns <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="patterns" aria-haspopup="dialog" aria-label="Share link: Patterns"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">-- Friends of friends MATCH (me)-[:KNOWS]->(friend)-[:KNOWS]->(fof) WHERE me.name = 'Alice' AND NOT (me)-[:KNOWS]->(fof) RETURN DISTINCT fof.name -- Variable length (1 to 3 hops) MATCH (a:Person)-[:KNOWS*1..3]->(b:Person) RETURN a.name, b.name, length(path) -- Optional match MATCH (u:User) OPTIONAL MATCH (u)-[:HAS_AVATAR]->(img:Image) RETURN u.name, img.url </code></pre></div> <h3 id="language-quick-references" class="position-relative d-flex align-items-center group"> Language Quick References <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="language-quick-references" aria-haspopup="dialog" aria-label="Share link: Language Quick References"> Share link </button> </h3> <h4 id="python-quickstart" class="position-relative d-flex align-items-center group"> Python Quickstart <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="python-quickstart" aria-haspopup="dialog" aria-label="Share link: Python Quickstart"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">from geode_client import Client import asyncio async def main(): client = Client(host="localhost", port=3141) async with client.connection() as conn: # Transaction await conn.begin() try: await conn.execute("CREATE (p:Person {name: $n})", {"n": "Alice"}) await conn.commit() except Exception: await conn.rollback() raise # Query with parameters result, _ = await conn.query( "MATCH (p:Person {name: $name}) RETURN p", {"name": "Alice"} ) # Stream results for row in result.rows: print(row["p"]) asyncio.run(main()) </code></pre></div> <h4 id="go-quickstart" class="position-relative d-flex align-items-center group"> Go Quickstart <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="go-quickstart" aria-haspopup="dialog" aria-label="Share link: Go Quickstart"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go">import ( "database/sql" _ "geodedb.com/geode" ) func main() { db, _ := sql.Open("geode", "quic://localhost:3141") defer db.Close() // Execute with parameters db.Exec("CREATE (p:Person {name: $name})", sql.Named("name", "Alice")) // Query rows, _ := db.Query("MATCH (p:Person) RETURN p.name") defer rows.Close() for rows.Next() { var name string rows.Scan(&name) } // Transaction tx, _ := db.Begin() tx.Exec("CREATE (p:Person {name: 'Bob'})") tx.Commit() } </code></pre></div> <h4 id="rust-quickstart" class="position-relative d-flex align-items-center group"> Rust Quickstart <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="rust-quickstart" aria-haspopup="dialog" aria-label="Share link: Rust Quickstart"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-rust" data-lang="rust">use geode_client::{Client, Result, Value}; use std::collections::HashMap; #[tokio::main] async fn main() -> Result<()> { let client = Client::new("localhost", 3141).skip_verify(true); let mut conn = client.connect().await?; // Execute with params let mut params = HashMap::new(); params.insert("name".to_string(), Value::string("Alice")); conn.query_with_params( "CREATE (p:Person {name: $name})", &params ).await?; // Read results let (page, _) = conn.query("MATCH (p:Person) RETURN p.name AS name").await?; for row in &page.rows { let name = row.get("name").unwrap().as_string()?; println!("{}", name); } // Transaction conn.begin().await?; conn.query("CREATE (p:Person {name: 'Bob'})").await?; conn.commit().await?; Ok(()) } </code></pre></div> <h3 id="common-use-cases" class="position-relative d-flex align-items-center group"> Common 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-use-cases" aria-haspopup="dialog" aria-label="Share link: Common Use Cases"> Share link </button> </h3> <h4 id="social-network" class="position-relative d-flex align-items-center group"> Social Network <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" aria-haspopup="dialog" aria-label="Share link: Social Network"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">-- Find mutual friends MATCH (me:Person {id: $myId})-[:FRIENDS]-(friend)-[:FRIENDS]-(other) WHERE (me)-[:FRIENDS]-(other) AND me <> other RETURN friend.name, other.name -- Suggested connections (friends of friends) MATCH (me:Person {id: $myId})-[:FRIENDS*2]-(suggested) WHERE NOT (me)-[:FRIENDS]-(suggested) AND me <> suggested RETURN DISTINCT suggested.name, suggested.id LIMIT 10 </code></pre></div> <h4 id="e-commerce" class="position-relative d-flex align-items-center group"> E-Commerce <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="e-commerce" aria-haspopup="dialog" aria-label="Share link: E-Commerce"> Share link </button> </h4><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) RETURN rec.name, COUNT(*) as relevance ORDER BY relevance DESC LIMIT 5 -- Category browsing MATCH (c:Category {name: $category})<-[:IN_CATEGORY]-(p:Product) WHERE p.in_stock = true RETURN p.name, p.price ORDER BY p.price </code></pre></div> <h4 id="knowledge-graph" class="position-relative d-flex align-items-center group"> Knowledge 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="knowledge-graph" aria-haspopup="dialog" aria-label="Share link: Knowledge Graph"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">-- Find related concepts MATCH (concept:Concept {name: $name})-[:RELATED_TO*1..2]-(related) RETURN DISTINCT related.name, related.description -- Hierarchical navigation MATCH (parent:Category {name: $name})<-[:SUBCATEGORY_OF*]-(child) RETURN child.name, length(path) as depth ORDER BY depth, child.name </code></pre></div> <h3 id="quick-configuration" class="position-relative d-flex align-items-center group"> Quick Configuration <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-configuration" aria-haspopup="dialog" aria-label="Share link: Quick Configuration"> Share link </button> </h3> <h4 id="connection-pooling" class="position-relative d-flex align-items-center group"> Connection Pooling <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-pooling" aria-haspopup="dialog" aria-label="Share link: Connection Pooling"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"># Python - automatic pooling from geode_client import ConnectionPool pool = ConnectionPool(host="localhost", port=3141, min_size=10, max_size=100) </code></pre></div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go">// Go - manual configuration db.SetMaxOpenConns(100) db.SetMaxIdleConns(10) db.SetConnMaxLifetime(time.Hour) </code></pre></div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-rust" data-lang="rust">// Rust - builder pattern use geode_client::ConnectionPool; let pool = ConnectionPool::new("localhost", 3141, 100); </code></pre></div> <h4 id="error-handling" class="position-relative d-flex align-items-center group"> Error Handling <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="error-handling" aria-haspopup="dialog" aria-label="Share link: Error Handling"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"># Python try: async with client.connection() as conn: await conn.query(query) except QueryError as exc: if "SERIALIZATION" in str(exc): # Retry logic else: # Log and fail </code></pre></div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go">// Go if err == sql.ErrNoRows { // Not found } else if geodeErr, ok := err.(*geode.Error); ok { if geodeErr.IsRetryable() { // Retry } } </code></pre></div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-rust" data-lang="rust">// Rust match conn.query_with_params(query, &params).await { Ok((_page, _)) => { /* success */ } Err(err) if err.is_retryable() => { /* retry */ } Err(e) => { /* other error */ } } </code></pre></div> <h3 id="performance-quick-wins" class="position-relative d-flex align-items-center group"> Performance Quick Wins <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-quick-wins" aria-haspopup="dialog" aria-label="Share link: Performance Quick Wins"> Share link </button> </h3> <h4 id="1-create-indexes" class="position-relative d-flex align-items-center group"> 1. 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="1-create-indexes" aria-haspopup="dialog" aria-label="Share link: 1. Create Indexes"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">-- Index frequently queried properties CREATE INDEX ON Person(email) CREATE INDEX ON Product(name) CREATE INDEX ON User(id) </code></pre></div> <h4 id="2-profile-queries" class="position-relative d-flex align-items-center group"> 2. Profile 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="2-profile-queries" aria-haspopup="dialog" aria-label="Share link: 2. Profile Queries"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">-- See execution plan PROFILE MATCH (p:Person {name: 'Alice'}) RETURN p -- Identify bottlenecks EXPLAIN MATCH (a:Person)-[:KNOWS*3]->(b) RETURN count(*) </code></pre></div> <h4 id="3-batch-operations" class="position-relative d-flex align-items-center group"> 3. Batch 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="3-batch-operations" aria-haspopup="dialog" aria-label="Share link: 3. Batch Operations"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"># Insert multiple nodes in one query async with client.connection() as conn: await conn.execute( """ UNWIND $users AS user CREATE (p:Person {name: user.name, email: user.email}) """, { "users": [ {"name": "Alice", "email": "[email protected]"}, {"name": "Bob", "email": "[email protected]"}, ] }, ) </code></pre></div> <h4 id="4-use-transactions" class="position-relative d-flex align-items-center group"> 4. 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="4-use-transactions" aria-haspopup="dialog" aria-label="Share link: 4. Use Transactions"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"># Group related operations async with client.connection() as conn: await conn.begin() try: await conn.execute("CREATE (o:Order {id: $id})", {"id": order_id}) for item in items: await conn.execute( "CREATE (o)-[:CONTAINS]->(p:Product {id: $pid})", {"pid": item.product_id}, ) await conn.commit() except Exception: await conn.rollback() raise </code></pre></div> <h3 id="production-quickstart" class="position-relative d-flex align-items-center group"> Production Quickstart <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="production-quickstart" aria-haspopup="dialog" aria-label="Share link: Production Quickstart"> Share link </button> </h3> <h4 id="docker-compose" class="position-relative d-flex align-items-center group"> 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="docker-compose" aria-haspopup="dialog" aria-label="Share link: Docker Compose"> Share link </button> </h4><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:/data environment: - GEODE_LISTEN=0.0.0.0:3141 - GEODE_LOG_LEVEL=info restart: unless-stopped volumes: geode-data: </code></pre></div> <h4 id="kubernetes" class="position-relative d-flex align-items-center group"> Kubernetes <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="kubernetes" aria-haspopup="dialog" aria-label="Share link: Kubernetes"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">apiVersion: apps/v1 kind: Deployment metadata: name: geode spec: replicas: 3 selector: matchLabels: app: geode template: metadata: labels: app: geode spec: containers: - name: geode image: geodedb/geode:latest ports: - containerPort: 3141 volumeMounts: - name: data mountPath: /data volumes: - name: data persistentVolumeClaim: claimName: geode-pvc </code></pre></div> <h4 id="health-check" class="position-relative d-flex align-items-center group"> Health Check <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="health-check" aria-haspopup="dialog" aria-label="Share link: Health Check"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"># Python health check endpoint @app.get("/health") async def health(): try: async with client.connection() as conn: await conn.query("RETURN 1 AS ok") return {"status": "healthy"} except: return {"status": "unhealthy"}, 503 </code></pre></div> <h3 id="troubleshooting-quick-reference" class="position-relative d-flex align-items-center group"> Troubleshooting Quick Reference <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-quick-reference" aria-haspopup="dialog" aria-label="Share link: Troubleshooting Quick Reference"> Share link </button> </h3> <h4 id="connection-issues" class="position-relative d-flex align-items-center group"> Connection Issues <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-issues" aria-haspopup="dialog" aria-label="Share link: Connection Issues"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Test connectivity telnet localhost 3141 # Check if server is running ps aux | grep geode # View server logs ./geode serve --log-level debug </code></pre></div> <h4 id="query-issues" class="position-relative d-flex align-items-center group"> Query Issues <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-issues" aria-haspopup="dialog" aria-label="Share link: Query Issues"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">-- Check if data exists MATCH (n) RETURN count(n) -- Verify relationship direction MATCH (a)-[r]->(b) RETURN type(r), count(*) -- Find duplicate nodes MATCH (n:Person) WITH n.email as email, collect(n) as nodes WHERE size(nodes) > 1 RETURN email, size(nodes) </code></pre></div> <h4 id="performance-issues" class="position-relative d-flex align-items-center group"> Performance Issues <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-issues" aria-haspopup="dialog" aria-label="Share link: Performance Issues"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">-- Find slow queries with PROFILE PROFILE MATCH (a)-[:KNOWS*]->(b) RETURN count(*) -- Check for missing indexes SHOW INDEXES -- Identify Cartesian products MATCH (a:Person), (b:Product) -- BAD: no relationship RETURN count(*) </code></pre></div> <h3 id="quick-reference-card" class="position-relative d-flex align-items-center group"> Quick Reference Card <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-reference-card" aria-haspopup="dialog" aria-label="Share link: Quick Reference Card"> Share link </button> </h3> <h4 id="query-clauses" class="position-relative d-flex align-items-center group"> Query Clauses <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-clauses" aria-haspopup="dialog" aria-label="Share link: Query Clauses"> Share link </button> </h4><ul> <li><code>MATCH</code> - Find patterns</li> <li><code>CREATE</code> - Insert data</li> <li><code>SET</code> - Update properties</li> <li><code>DELETE</code> - Remove data</li> <li><code>RETURN</code> - Output results</li> <li><code>WHERE</code> - Filter results</li> <li><code>ORDER BY</code> - Sort results</li> <li><code>LIMIT</code> - Restrict count</li> <li><code>WITH</code> - Chain queries</li> <li><code>OPTIONAL MATCH</code> - Nullable patterns</li> </ul> <h4 id="aggregation-functions" class="position-relative d-flex align-items-center group"> Aggregation Functions <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="aggregation-functions" aria-haspopup="dialog" aria-label="Share link: Aggregation Functions"> Share link </button> </h4><ul> <li><code>COUNT(*)</code> - Count rows</li> <li><code>SUM(expr)</code> - Sum values</li> <li><code>AVG(expr)</code> - Average values</li> <li><code>MIN(expr)</code> - Minimum value</li> <li><code>MAX(expr)</code> - Maximum value</li> <li><code>COLLECT(expr)</code> - Gather into list</li> </ul> <h4 id="path-functions" class="position-relative d-flex align-items-center group"> Path Functions <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-functions" aria-haspopup="dialog" aria-label="Share link: Path Functions"> Share link </button> </h4><ul> <li><code>shortestPath()</code> - Find shortest path</li> <li><code>allShortestPaths()</code> - All shortest paths</li> <li><code>length(path)</code> - Path length</li> <li><code>nodes(path)</code> - Nodes in path</li> <li><code>relationships(path)</code> - Edges in path</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>Now that you’re up and running: <ul> <li>Build Your Schema: Design your graph model</li> <li>Load Data: Import existing datasets</li> <li>Optimize Queries: Profile and add indexes</li> <li>Implement Security: Configure authentication and RLS</li> <li>Monitor Performance: Set up metrics and alerts</li> <li>Plan Scaling: Configure replication and backups</li> </ul> <h3 id="related-topics" class="position-relative d-flex align-items-center group"> Related Topics <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-topics" aria-haspopup="dialog" aria-label="Share link: Related Topics"> Share link </button> </h3><ul> <li>Getting Started: Detailed beginner guide with explanations</li> <li>Examples: More code samples across all features</li> <li>Tutorials: Step-by-step learning paths</li> <li>Quick Start: Another fast-track guide</li> <li>Developer Guide: Complete API reference</li> </ul>

Popular

Related Articles

Getting Started

Quick Start Guide