convex-migrate

Migrer le schéma et réapprovisionner les données sur une application Convex déployée à l'aide de @convex-dev/migrations.

npx skills add https://github.com/get-convex/agent-skills --skill convex-migrate

Migrate the schema / data on a live app

Change a deployed schema without breaking existing data: stage the schema change, install @convex-dev/migrations, write a backfill that makes old rows valid, run it, and verify before tightening the validator.

Workflow

  1. Make the new field optional first (so deploy doesn't reject existing rows).
  2. Install @convex-dev/migrations; write a migration that backfills/transforms existing rows.
  3. Run the migration; verify all rows are valid.
  4. Tighten the validator (make the field required) once the backfill is complete.

Rules

  • Never tighten a validator before the backfill completes — it rejects existing rows and breaks the live app.
  • Add new fields as optional first, migrate, then require.
  • Verify row counts before and after.

Plus de skills de get-convex

convex-performance-audit
get-convex
Audite les performances Convex pour les lectures, les abonnements, la contention d'écriture et les limites de fonctions. Utilisez pour les fonctionnalités lentes, les résultats d'insights, les conflits OCC ou l'amplification de lecture.
developmentdatabasedata-analysis
convex
get-convex
Achemine les requêtes générales Convex vers la bonne compétence de projet. À utiliser lorsque l'utilisateur demande quelle compétence Convex utiliser ou donne une tâche d'application Convex sous-spécifiée.
developmentdatabase
convex-setup-auth
get-convex
Configure l'authentification Convex, le mappage d'identité et le contrôle d'accès. À utiliser pour la connexion, les fournisseurs d'authentification, les tables d'utilisateurs, les fonctions protégées ou les rôles dans une application Convex.
developmentdatabaseapi
convex-quickstart
get-convex
Crée ou ajoute Convex à une application. À utiliser pour les nouveaux projets Convex, npm create convex@latest, la configuration du frontend, les variables d'environnement ou la première exécution de npx convex dev.
developmentdatabase
convex-migration-helper
get-convex
Planifie les migrations de schéma et de données Convex avec widen-migrate-narrow et @convex-dev/migrations. À utiliser pour les changements de schéma cassants, les backfills, le remodelage de tables ou les déploiements sans temps d'arrêt.
developmentdatabase
convex-create-component
get-convex
Construit des composants Convex réutilisables avec des tables isolées et des API orientées application. À utiliser pour de nouveaux composants, des modules backend réutilisables, des intégrations ou des travaux de délimitation de composants.
developmentdatabase
convex-optimize
get-convex
Auditer et optimiser une application Convex existante : sécurité, passage à l'échelle, mises à niveau, observabilité.
convex-env
get-convex
Configurer et connecter les env vars / secrets de déploiement Convex pour l'application.