Skip to main content
The Concepts section explains the why behind Narrative I/O. Rather than step-by-step instructions, you’ll find explanations of how the platform works, why it’s designed the way it is, and how different pieces fit together.

Core Primitives

The fundamental building blocks of the platform.

Data Planes

Where your data lives and is processed

Control Plane

How Narrative orchestrates data collaboration

Execution Context

How data plane, compute pool, database, and schema determine where operations run

Compute Pools

How compute resources are allocated for query execution

Dataset Statistics

Column-level metrics that describe your data

Rosetta Stone

Narrative’s approach to schema normalization and data mapping.

Overview

What Rosetta Stone is and why it matters

How It Works

The mechanics of automatic schema mapping

Normalization Model

How data gets normalized across sources

NQL

The design and philosophy behind Narrative Query Language.

Design Philosophy

Why NQL exists and how it differs from traditional approaches

SQL Comparison

How NQL relates to SQL and when to use each

Type System

How NQL handles data types and type safety

JOIN Performance

Why certain JOIN patterns cause performance problems

Materialized Views

Pre-computed query results for performance and caching

Incremental View Maintenance

How NQL optimizes materialized view refreshes

Identifiers

How identifiers connect records across organizations and systems.

Identity Graphs

How connected components unify identifiers into person-level profiles

Graph Enrichment

Strengthening graph structure with third-party linkage data

Addressability Expansion

Improving activation reach by appending additional identifiers

Architecture

How the platform is built and why.

Query Processing

How queries are compiled, optimized, and executed

Data Flow

How data moves through the platform

Sample Data

How samples cross to the control plane

Security Model

How Narrative protects your data

Workflows

Automating multi-step data pipelines.

Workflow Orchestration

How workflows automate sequential data operations and relate to the jobs system

Webhooks

Push-based notifications for job state changes.

Webhooks

How webhooks deliver notifications when jobs change state

Model Inference

AI-powered operations within your data plane.

Overview

How AI inference works within your infrastructure

Data Privacy

How inference keeps data secure in your data plane

Structured Output

How JSON Schema ensures predictable responses

Apps

Third-party onboarding and account connection.

App Invites

How invite links enable third parties to connect accounts without Narrative authentication

Security

Enterprise security and access management.

Single Sign-On (SSO)

How SSO works with Narrative and why it matters for enterprise security

API Key Permissions

How scoped permissions protect your resources and enforce least privilege

Compliance

Privacy regulations and data protection requirements.

GDPR

The EU’s General Data Protection Regulation and its requirements

CCPA

California’s privacy law and consumer rights framework