Skip to content

Add D1 vs Hyperdrive #17465

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Oct 18, 2024
Merged

Add D1 vs Hyperdrive #17465

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
9e1cd8b
Add D1 vs Hyperdrive
thomasgauvin Oct 10, 2024
f57dcfa
thomasgauvin: nit
thomasgauvin Oct 10, 2024
e4ff9d2
Update src/content/docs/workers/platform/storage-options.mdx
Oxyjun Oct 11, 2024
7433cce
Actioning feedback.
Oxyjun Oct 14, 2024
12a79f3
Update src/content/docs/workers/platform/storage-options.mdx
Oxyjun Oct 16, 2024
d9d4349
Update src/content/docs/workers/platform/storage-options.mdx
Oxyjun Oct 16, 2024
97a6b34
Apply suggestions from code review
Oxyjun Oct 18, 2024
6cca59c
Update src/content/docs/workers/platform/storage-options.mdx
Oxyjun Oct 18, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions src/content/docs/workers/platform/storage-options.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -209,4 +209,15 @@ The new beta version of Durable Objects is available where each Durable Object h

:::

## D1 vs Hyperdrive

D1 is a standalone, serverless database that provides a SQL API to store and access your relational data.

Hyperdrive is a service that improves the performance of your existing, regional PostgreSQL databases, optimizing them for global data access from Workers.

If you are building a new project on Workers or are considering migrating your data, use D1.

If you are building a Workers project with an existing PostgreSQL database, use Hyperdrive.

D1 does not need to be used with Hyperdrive because it does not have slow connection setups which would benefit from Hyperdrive's connection pooling. D1 data can also be cached within Workers using the [Cache API](/workers/runtime-apis/cache/).

3 changes: 1 addition & 2 deletions src/content/partials/workers/storage-products-table.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
{}

---

| Use-case | Product | Ideal for |
Expand All @@ -12,4 +11,4 @@
| Global co-ordination | [Durable Objects](/durable-objects/) | Building collaborative applications; global co-ordination across clients; strongly consistent, transactional storage. |
| Vector search (database) | [Vectorize](/vectorize/) | Storing [embeddings](/workers-ai/models/#text-embeddings) from AI models for semantic search and classification tasks. |
| Task processing & batching | [Queues](/queues/) | Background job processing (emails, notifications, APIs) and log processing/batching. |
| Connect to an existing database | [Hyperdrive](/hyperdrive/) | Connecting to an existing database in a cloud or on-prem. |
| Connect to an existing database | [Hyperdrive](/hyperdrive/) | Connecting to an existing database in a cloud or on-premise. |
Loading