DB Migrations

Create a database migration with Drizzle on a fresh Neon branch. Use when changing the packages/db schema or generating migrations.

gabrielmoreira Updated 17 repo stars

File contents

DB migrations

  • Always spin up a new neon branch to create migrations. Update our root .env files to point at the neon branch locally.
  • Use drizzle to manage the migration. You can see the schema at packages/db/src/schema. Generating and applying against a dev Neon branch is fine; never apply against a shared or production database — those go through the normal deploy flow.
  • Create migrations by changing drizzle schema then running bunx drizzle-kit generate --name="<sample_name_snake_case>"
  • NEON_ORG_ID and NEON_PROJECT_ID env vars are set in .env
  • list_projects tool requires org_id passed in
  • NEVER manually edit files in packages/db/drizzle/ - this includes .sql migration files, meta/_journal.json, and snapshot files. These are auto-generated by Drizzle. Change only the schema files in packages/db/src/schema/ and let drizzle-kit generate write the migration (hand-edits to generated files require explicit user confirmation).

gabrielmoreira/agent-skills-mirror/tree/main/mirrors/repos/superset-sh@superset/.agents/skills/db-migrations commit 12adf64c49

Frequently asked questions

npx skillmds@latest add gabrielmoreira/db-migrations