aws-samples / aws-samples/serverless-full-stack-webapp-starter-kit
feat(db): Aurora DSQL の FOREIGN KEY 対応を取り込み、参照整合性を DB 側へ移譲する
- Lingua principale
- TypeScript
- Stelle
- 229
- Fork
- 45
- Merge medio
- 1m
- PR unite (30g)
- 4
Descrizione
## 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 周りだけに絞ります。
Guida per i contributori
Apri la guida per i contributori
Direzione di ricerca
Inizia da packages/db/src/dsql-compat.ts e confronta la gestione delle chiavi esterne con il comportamento CREATE INDEX → ASYNC esistente. Poi esamina safe-action.ts, lo schema di esempio, AGENTS.md, packages/db/README.md e l’ADR pertinente. Il lavoro è completato quando l’SQL di FK viene preservato con il comportamento ADD CONSTRAINT richiesto, DROP CONSTRAINT è consentito, i controlli duplicati dell’applicazione vengono rimossi e lo schema e la documentazione riflettono la modifica.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Valutazione
- Stack tecnologico
- aws, sql, typescript
- Ambito
- backend, databases, documentation
- Tipo di issue
- Funzionalità
- Difficoltà
- 4/5
- Tempo stimato
- 3-5 giorni
- Stato di attività
- Attiva
- Chiarezza
- Abbastanza chiara
- Idoneità per principianti
- 68/100