Basic Queries¶

This guide covers the fundamentals of querying graph data with GraphQL in Grafeo.

Anonymous Queries¶

The simplest query uses an anonymous operation with a selection set:

{
  Person {
    name
  }
}

This finds all nodes with the Person label and returns their name property.

Named Queries¶

Name your queries for clarity:

query GetPeople {
  Person {
    name
    age
  }
}

Field Selection¶

Select the specific properties you want returned:

# Single field
{
  Person {
    name
  }
}

# Multiple fields
{
  Person {
    name
    age
    email
    city
  }
}

Type-to-Label Mapping¶

The root field name maps to a node label in the graph. Grafeo automatically capitalizes the first letter:

GraphQL Root Field	Node Label
`Person { ... }`	`:Person`
`user { ... }`	`:User`
`company { ... }`	`:Company`

Filtering with Direct Arguments¶

Pass arguments to filter by property values:

# Filter by name
{
  Person(name: "Alice") {
    name
    age
  }
}

# Filter by multiple properties (AND)
{
  Person(age: 30, city: "Seattle") {
    name
    email
  }
}

Pagination¶

Use first and skip to paginate results:

# First 10 people
{
  Person(first: 10) {
    name
  }
}

# Skip 20, take next 10
{
  Person(first: 10, skip: 20) {
    name
  }
}

You can also use limit and offset as aliases:

{
  Person(limit: 10, offset: 20) {
    name
  }
}

Ordering¶

Sort results with orderBy:

# Ascending by name
{
  Person(orderBy: { name: ASC }) {
    name
    age
  }
}

# Descending by age
{
  Person(orderBy: { age: DESC }) {
    name
    age
  }
}

# Multiple sort keys
{
  Person(orderBy: { age: DESC, name: ASC }) {
    name
    age
  }
}

Combining Features¶

Combine filtering, ordering, and pagination:

{
  Person(
    name: "Alice"
    orderBy: { age: DESC }
    first: 5
  ) {
    name
    age
    city
  }
}

Python Example¶

import grafeo

db = grafeo.GrafeoDB()

# Create data
db.execute("INSERT (:Person {name: 'Alice', age: 30})")
db.execute("INSERT (:Person {name: 'Bob', age: 25})")

# Simple query
result = db.execute_graphql("""
{
  Person {
    name
    age
  }
}
""")
for row in result:
    print(row)

# With filter and pagination
result = db.execute_graphql("""
{
  Person(first: 10, orderBy: { name: ASC }) {
    name
  }
}
""")

Rust Example¶

use grafeo_engine::GrafeoDB;

let db = GrafeoDB::new_in_memory();
db.execute("INSERT (:Person {name: 'Alice', age: 30})").unwrap();

let result = db.execute_graphql(r#"
{
  Person {
    name
    age
  }
}
"#).unwrap();