Getting Started

Tenant Virtualization

Tenant Virtualization

Astra supports virtual tenant keyspaces by prefixing keys with:

/__tenant/<tenant_id>/...

Where It Is Applied

  • Online API path: request tenant identity from auth claim.
  • Migration path (astra-forge converge): explicit tenant IDs per source snapshot.

Why It Matters

  • Enables multi-tenant disaggregation with overlapping raw key names.
  • Prevents cross-tenant key collision during convergence and steady-state operation.

Guardrails

  • Auth and tenant claim mapping must be configured consistently.
  • Migration validation must include per-tenant key parity and marker checks.