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