convex-migrate

作成者: get-convex

@convex-dev/migrationsを使用して、デプロイされたConvexアプリ上でスキーマの移行 + データのバックフィルを実行します。

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.

get-convexのその他のスキル

convex-performance-audit
get-convex
Convexのパフォーマンスを、読み取り、サブスクリプション、書き込み競合、関数制限について監査します。遅い機能、インサイトの調査結果、OCC競合、または読み取り増幅に使用します。
developmentdatabasedata-analysis
convex
get-convex
一般的なConvexリクエストを適切なプロジェクトスキルにルーティングします。ユーザーがどのConvexスキルを使用すべきか尋ねたり、不十分に指定されたConvexアプリタスクを与えた場合に使用します。
developmentdatabase
convex-setup-auth
get-convex
Convexの認証、IDマッピング、アクセス制御を設定します。Convexアプリでのログイン、認証プロバイダー、ユーザーテーブル、保護された関数、ロールに使用します。
developmentdatabaseapi
convex-quickstart
get-convex
アプリにConvexを作成または追加します。新しいConvexプロジェクト、npm create convex@latest、フロントエンドのセットアップ、環境変数、または最初のnpx convex devの実行に使用します。
developmentdatabase
convex-migration-helper
get-convex
Convexのスキーマとデータマイグレーションを、widen-migrate-narrowおよび@convex-dev/migrationsを用いて計画します。破壊的なスキーマ変更、バックフィル、テーブル再構築、またはダウンタイムゼロのロールアウトに使用します。
developmentdatabase
convex-create-component
get-convex
再利用可能なConvexコンポーネントを、独立したテーブルとアプリ向けAPIとともに構築します。新しいコンポーネント、再利用可能なバックエンドモジュール、統合、またはコンポーネント境界の作業に使用します。
developmentdatabase
convex-optimize
get-convex
既存のConvexアプリを監査および最適化:セキュリティ、スケーリング、アップグレード、可観測性。
convex-env
get-convex
Convexデプロイメントのenv vars/シークレットをアプリ用に設定して接続します。