aws-samples / aws-samples/serverless-full-stack-webapp-starter-kit
feat(db): Aurora DSQL の FOREIGN KEY 対応を取り込み、参照整合性を DB 側へ移譲する
- Lenguaje dominante
- TypeScript
- Estrellas
- 229
- Forks
- 45
- Merge medio
- 1 min
- PR fusionados (30 d)
- 4
Descripción
## Problem
Aurora DSQL が FOREIGN KEY に対応しました([Working with foreign key constraints](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/working-with-foreign-key-constraints.html))。`ADD CONSTRAINT` に `NOT VALID` が必要な点を除けば、ほぼ Postgres と同じように書けます。
一方 kit は FK 非対応前提のままで、`packages/db/src/dsql-compat.ts` が生成 SQL から `REFERENCES` / `FOREIGN KEY` を無言で削除します。schema.ts に `.references()` を書いてもエラーにならず、FK なしのテーブルができます。`DROP CONSTRAINT` も "Table recreation required." で弾かれますが、こちらも今は使えます。
FK 非対応時代は「無言で削除」が妥当でしたが、現在の仕様であればDB側でも参照整合性を設けるのが好ましそうです。
## Proposed solution
- `dsql-compat.ts`: FK をそのまま通し、`ADD CONSTRAINT` には `NOT VALID` を自動付与(`CREATE INDEX` → `ASYNC` と同じ方針)。`DROP CONSTRAINT` も許可する
- サンプルスキーマ: `TodoItem.userId` → `User.id` に FK を追加(参照アクションは既定の NO ACTION)
- アプリ層: `safe-action.ts` の users 行の存在チェックを削除。FK があれば重複するため
- `AGENTS.md` / `packages/db/README.md` と ADR を更新
`ALTER TABLE` 許可リスト全体の見直しは #220 のスコープなので、ここでは FK 周りだけに絞ります。
Guía de contribución
Línea de trabajo
Comienza con packages/db/src/dsql-compat.ts y compara el manejo de las claves foráneas con el comportamiento existente de CREATE INDEX → ASYNC. Después inspecciona safe-action.ts, el esquema de ejemplo, AGENTS.md, packages/db/README.md y la ADR relevante. Se considera terminado cuando se conserva el SQL de FK con el comportamiento requerido de ADD CONSTRAINT, se permite DROP CONSTRAINT, se eliminan las comprobaciones de aplicación duplicadas y el esquema y la documentación reflejan el cambio.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Stack tecnológico
- aws, sql, typescript
- Área
- backend, databases, documentation
- Tipo de issue
- Nueva funcionalidad
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Estado de actividad
- Activo
- Claridad
- Bastante claro
- Aptitud para principiantes
- 68/100