Data modeling

Build Pinot tables by getting schema, table shape, logical-table, and schema-evolution decisions right before ingestion starts.

Pinot works best when the table shape is clear before data lands. Start here to understand the structure that every ingestion and query decision depends on: schema design, table composition, logical-table layout, and how schemas evolve without breaking existing pipelines.

If you need dense JSON config or controller endpoints, jump to the Reference section instead. This section stays narrative and decision-oriented.

Start Here

• Schema and Table Shape

• Logical Tables

• Schema Evolution

Related Existing Docs

• Schema

• Table

• Logical Table

• Schema Evolution Tutorial

• Schema Reference

• Table Reference

What this page covered

This landing page defines the scope of Pinot data modeling and points to the core pages that matter first.

Next step

Read Schema and Table Shape to lock in the table structure before designing ingestion.

Related pages

• Schema and Table Shape

• Logical Tables

• Schema Evolution