Skip to main content

SQL Migration Guide

This guide helps developers familiar with relational databases understand how to model and query data in Fluree's graph model.

Conceptual Mapping

SQL ConceptFluree Equivalent
TableClass/Type
RowEntity (node)
ColumnProperty
Primary KeyEntity ID (@id)
Foreign KeyRelationship (reference)
JOINGraph traversal
SchemaOntology

Key Differences

  1. No fixed schema: Properties can be added to any entity
  2. Relationships are first-class: No join tables needed
  3. Multi-valued properties: An entity can have multiple values for a property
  4. Semantic types: Properties carry meaning via ontologies

When to Migrate

Consider Fluree when you need:

  • Complex relationships (many-to-many, hierarchies)
  • Flexible schemas that evolve
  • Built-in versioning and audit trails
  • Semantic data integration