mirror of
https://github.com/prdlk/skills.git
synced 2026-11-02 13:12:48 +00:00
2.1 KiB
2.1 KiB
D1 Gotchas & Troubleshooting
Use current documentation to diagnose the failure before changing query or database configuration.
| Symptom or question | What to check |
|---|---|
| Missing table, query exception, or constraint error | Debug D1; verify the target binding, environment, and applied migrations |
| Boolean, date, or other binding type mismatch | Workers Binding API type conversion and SQL support |
| Foreign key failure during writes or migrations | Foreign key enforcement and deferral |
| Slow queries, scans, or excessive rows read | Indexes and query plans and metrics |
| Query duration, statement, storage, or account limits | Current limits |
| Unexpected usage charges or plan assumptions | Pricing |
| Stale reads after a write | Sessions, bookmarks, and read replication |
| Transient query failures | Retry guidance; check idempotency before retrying writes |
| Import/export failure or unsupported data | Import/export behavior and limitations |
| Local and deployed databases differ | Local development and environment configuration |
Continue to bind untrusted SQL values as described in api.md. Do not treat SQL injection as a recoverable database error or assume retries correct invalid queries.