Skip to content
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.

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

Add D1 changelog and release notes for request latency improvements #19235

Merged
merged 22 commits into from
Jan 21, 2025
Merged
Show file tree
Hide file tree
Changes from 18 commits
Commits
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
Binary file added src/assets/images/d1/faster-d1-worker-api.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
17 changes: 17 additions & 0 deletions src/content/changelogs-next/2025-01-07-d1-faster-query.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
title: 40-60% Faster D1 Worker API Requests
description: D1's Worker API request latency decreases by 40-60%.
products:
- d1
date: 2025-01-07T18:00:00Z
---

Users making [D1](/d1/) requests via the [Workers API](/d1/worker-api/) can see up to a 60% end-to-end latency improvement due to the removal of network round trips needed for each request to a D1 database.
vy-ton marked this conversation as resolved.
Show resolved Hide resolved

![D1 Worker API latency](../../assets/images/d1/faster-d1-worker-api.png)
vy-ton marked this conversation as resolved.
Show resolved Hide resolved
Oxyjun marked this conversation as resolved.
Show resolved Hide resolved

*p50, p90, and p95 request latency aggregated across entire D1 service. These latencies are a reference point and should not be viewed as your exact workload improvement.*

This performance improvement benefits all D1 Worker API traffic, especially cross-region requests where network latency is an outsized latency factor. For example, a user in Europe talking to a database in North America. D1 [location hints](/d1/configuration/data-location/#provide-a-location-hint) can be used to influence the geographic location of a database.

For more details on how D1 removed redundant round trips, see the D1 specific changelog [entry](/d1/platform/changelog/#2025-01-07).
13 changes: 13 additions & 0 deletions src/content/changelogs/d1.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,19 @@ entries:

For better insight into your current usage, refer to your [billing metrics](/d1/observability/billing/) for rows read and rows written, which can be found on the [D1 dashboard](https://dash.cloudflare.com/?account=/workers/d1) or GraphQL API.

- publish_date: "2025-01-07"
lambrospetrou marked this conversation as resolved.
Show resolved Hide resolved
title: D1 Worker API request latency decreases by 40-60%.
description: |-
D1 lowered end-to-end Worker API request latency by 40-60% by eliminating redundant network round trips for each request.

![D1 Worker API latency](../../assets/images/d1/faster-d1-worker-api.png)

*p50, p90, and p95 request latency aggregated across entire D1 service. These latencies are a reference point and should not be viewed as your exact workload improvement.*

For each request to a D1 database, at least two network round trips were eliminated. One round trip was due to a bug that is now fixed. The remaining removed round trips are due to avoiding creating a new TCP connection for each request when reaching out to the datacenter hosting the database.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bringing this up into post helps me as reader understand

Ohhhh the metrics you're sharing are not query latency, they are total network time

Quick diagram may go long way

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would also put the image in both sections.


The removal of redundant network round trips also applies to D1\'s [REST API](/api/resources/d1/subresources/database/methods/query/). However, the REST API still depends on Cloudflare's centralized datacenters for authentication, which reduces the relative performance improvement.

- publish_date: "2024-08-23"
title: D1 alpha databases have stopped accepting SQL queries
description: |-
Expand Down
Loading