page:migrate:amazon rds for postgresql:multi tenant relational data

Migrate Amazon RDS for PostgreSQL: Multi-tenant relational data

Move PostgreSQL data from Amazon RDS for PostgreSQL to Ample, one component at a time. Destination verified on Ample: a tenant column on every row and query, with a cross-tenant read returning nothing (tenant_isolation=ok). Source procedure: Take a logical backup with pg_dump -Fc from a network location that can reach the instance. Not migrated automatically: Multi-AZ failover, read replicas, IAM authentication, PITR and Performance Insights have no equivalent on the managed database. Cutover: Freeze writes at the source with the user's go-ahead, take the final dump, restore, validate, redeploy with the managed DATABASE_URL, keep RDS until confirmed. Rollback: keep the source untouched until you confirm; nothing at the source is changed or deleted by this guide.

Representative Queries

Resource Requirements

Infrastructure Requirements

Migration Source

Prerequisites

  1. Authorized access to the Amazon RDS for PostgreSQL source and its export tooling
  2. An inventory of every component in scope and out of scope
  3. A validated backup or copy before any cutover
  4. An Ample account token with servers:write, databases:read

Workflow Steps

  1. Inventory the source: List what Amazon RDS for PostgreSQL provides beyond the component you are moving. Out of scope here: Multi-AZ failover, read replicas, IAM authentication, PITR and Performance Insights have no equivalent on the managed database.
  2. Source step 1: Take a logical backup with pg_dump -Fc from a network location that can reach the instance.
  3. Source step 2: Check the engine major version, extensions and parameter-group settings the app depends on.
  4. Source step 3: Restore into a scratch managed database first and compare row counts.
  5. Provision and restore: Deploy the app once so a managed PostgreSQL 16 database exists (or create one with ample database create --engine postgres), then restore the dump with pg_restore using its connection string; keep migrations idempotent.
  6. Validate before cutover: Run the app's own checks and, for data, compare counts and checksums; the example checks are the pattern self-tests (/p/multi-tenant-relational-data).
  7. Cut over: Freeze writes at the source with the user's go-ahead, take the final dump, restore, validate, redeploy with the managed DATABASE_URL, keep RDS until confirmed.
  8. Rollback: Point DNS or configuration back to the source. The source was never modified; deletion is a separate, user-executed step after validation.

Examples

Success Checks

Limitations

Cost Estimate

Evidence Summary

Next Actions

Last Verified At