From 5d70728dd5c51faef7cb849c014425a90e7d9af4 Mon Sep 17 00:00:00 2001 From: Thomas Gauvin Date: Wed, 2 Apr 2025 23:31:17 -0400 Subject: [PATCH 1/2] thomasgauvin: update hyperdrive pricing and limits for free plan --- .../docs/hyperdrive/platform/limits.mdx | 25 +++++++++---------- .../docs/hyperdrive/platform/pricing.mdx | 23 ++++++++++++++--- src/content/docs/workers/platform/pricing.mdx | 14 +++++++++-- .../partials/workers/hyperdrive_pricing.mdx | 19 ++++++++++++++ 4 files changed, 62 insertions(+), 19 deletions(-) create mode 100644 src/content/partials/workers/hyperdrive_pricing.mdx diff --git a/src/content/docs/hyperdrive/platform/limits.mdx b/src/content/docs/hyperdrive/platform/limits.mdx index 07a3cfa0439ee21..1719027fe9bb73c 100644 --- a/src/content/docs/hyperdrive/platform/limits.mdx +++ b/src/content/docs/hyperdrive/platform/limits.mdx @@ -3,24 +3,23 @@ pcx_content_type: concept title: Limits sidebar: order: 2 - --- The following limits apply to Hyperdrive configuration, connections, and queries made to your configured origin databases. -| Feature | Limit | -| ---------------------------------------------- | ------------------------------------------------------------------------------------- | -| Maximum configured databases | 25 per account | -| Initial connection timeout | 15 seconds | -| Idle connection timeout | 10 minutes | -| Maximum cached query response size | 50 MB | -| Maximum query (statement) duration | 60 seconds | -| Maximum username length | 63 characters (bytes) [^1] | -| Maximum database name length | 63 characters (bytes) [^1] | -| Maximum potential origin database connections | approx. \~100 connections [^2] | +| Feature | Free | Paid | +| -------------------------------------------------- | ------------------------ | ------------------------- | +| Maximum configured databases | 10 per account | 25 per account | +| Initial connection timeout | 15 seconds | 15 seconds | +| Idle connection timeout | 10 minutes | 10 minutes | +| Maximum cached query response size | 50 MB | 50 MB | +| Maximum query (statement) duration | 60 seconds | 60 seconds | +| Maximum username length [^1] | 63 characters (bytes) | 63 characters (bytes) | +| Maximum database name length [^1] | 63 characters (bytes) | 63 characters (bytes) | +| Maximum potential origin database connections [^2] | approx. \~20 connections | approx. \~100 connections | :::note -Hyperdrive does not have a hard limit on the number of concurrent *client* connections made from your Workers. +Hyperdrive does not have a hard limit on the number of concurrent _client_ connections made from your Workers. As many hosted databases have limits on the number of unique connections they can manage, Hyperdrive attempts to keep number of concurrent pooled connections to your origin database lower. ::: @@ -31,4 +30,4 @@ As many hosted databases have limits on the number of unique connections they ca :::note You can request adjustments to limits that conflict with your project goals by contacting Cloudflare. Not all limits can be increased. To request an increase, submit a [Limit Increase Request](https://forms.gle/ukpeZVLWLnKeixDu7) and we will contact you with next steps. -::: \ No newline at end of file +::: diff --git a/src/content/docs/hyperdrive/platform/pricing.mdx b/src/content/docs/hyperdrive/platform/pricing.mdx index f13b4c57e6df375..8b279046700b8e0 100644 --- a/src/content/docs/hyperdrive/platform/pricing.mdx +++ b/src/content/docs/hyperdrive/platform/pricing.mdx @@ -3,15 +3,30 @@ pcx_content_type: concept title: Pricing sidebar: order: 1 - --- -**Hyperdrive is free and included in every [Workers Paid](/workers/platform/pricing/#workers) plan**. +import { Render } from "~/components"; + + + +Hyperdrive limits are automatically adjusted when subscribed to a Workers Paid plan. Hyperdrive's [connection pooling and query caching](/hyperdrive/configuration/how-hyperdrive-works/) are included in Workers Paid plan, so do not incur any additional charges. + +## Pricing FAQ + +### Does connection pooling or query caching incur additional charges? + +No. Hyperdrive's built-in cache and connection pooling are included within the stated plans above. There are no hidden limits other than those [published](/hyperdrive/platform/limits/). + +### Are cached queries counted the same as uncached queries? + +Yes, any query made through Hyperdrive, whether cached or uncached, whether query or mutation, is counted according to the limits above. + +### Does Hyperdrive charge for data transfer / egress? -Hyperdrive is automatically enabled when subscribed to a Workers Paid plan, and does not require you to pay any additional fees to use. Hyperdrive's [connection pooling and query caching](/hyperdrive/configuration/how-hyperdrive-works/) do not incur any additional charges, and there are no hidden limits other than those [published](/hyperdrive/platform/limits/). +No. :::note For questions about pricing, refer to the [pricing FAQs](/hyperdrive/reference/faq/#pricing). -::: \ No newline at end of file +::: diff --git a/src/content/docs/workers/platform/pricing.mdx b/src/content/docs/workers/platform/pricing.mdx index 728c3bb1c245d55..18f0ae1dfa4f15d 100644 --- a/src/content/docs/workers/platform/pricing.mdx +++ b/src/content/docs/workers/platform/pricing.mdx @@ -9,9 +9,9 @@ description: Workers plans and pricing information. import { GlossaryTooltip, Render } from "~/components"; -By default, users have access to the Workers Free plan. The Workers Free plan includes limited usage of Workers, Pages Functions and Workers KV. Read more about the [Free plan limits](/workers/platform/limits/#worker-limits). +By default, users have access to the Workers Free plan. The Workers Free plan includes limited usage of Workers, Pages Functions, Workers KV and Hyperdrive. Read more about the [Free plan limits](/workers/platform/limits/#worker-limits). -The Workers Paid plan includes Workers, Pages Functions, Workers KV, and Durable Objects usage for a minimum charge of $5 USD per month for an account. The plan includes increased initial usage allotments, with clear charges for usage that exceeds the base plan. +The Workers Paid plan includes Workers, Pages Functions, Workers KV, Hyperdrive, and Durable Objects usage for a minimum charge of $5 USD per month for an account. The plan includes increased initial usage allotments, with clear charges for usage that exceeds the base plan. All included usage is on a monthly basis. @@ -150,6 +150,16 @@ To learn more about KV, refer to the [KV documentation](/kv/). ::: +## Hyperdrive + + + +:::note[KV documentation] + +To learn more about Hyperdrive, refer to the [Hyperdrive documentation](/hyperdrive/). + +::: + ## Queues diff --git a/src/content/partials/workers/hyperdrive_pricing.mdx b/src/content/partials/workers/hyperdrive_pricing.mdx new file mode 100644 index 000000000000000..b2d8ec6b549fcd7 --- /dev/null +++ b/src/content/partials/workers/hyperdrive_pricing.mdx @@ -0,0 +1,19 @@ +--- +{} +--- + +import { Markdown } from "~/components"; + +Hyperdrive is included in both the Free and Paid [Workers plans](/workers/platform/pricing/). + +| | Free plan1 | Paid plan | +| ---------------------------- | --------------------- | --------- | +| Database queries2 | 100,000 / day | Unlimited | + +1 The Workers Free plan includes limited Hyperdrive usage. All limits +reset daily at 00:00 UTC. If you exceed any one of these limits, further +operations of that type will fail with an error. + +2 Database queries refers to any database statement made via +Hyperdrive, whether a query (`SELECT`), a modification (`INSERT`,`UPDATE`, or +`DELETE`) or a schema change (`CREATE`, `ALTER`, `DROP`). From 403c1af604d74043a9cebe3180066cc0393ca1a1 Mon Sep 17 00:00:00 2001 From: Jun Lee Date: Thu, 3 Apr 2025 17:54:53 +0100 Subject: [PATCH 2/2] Making footnotes better, correcting note title from KV -> Hyperdrive --- src/content/docs/workers/platform/pricing.mdx | 2 +- .../partials/workers/hyperdrive_pricing.mdx | 20 ++++++++++--------- 2 files changed, 12 insertions(+), 10 deletions(-) diff --git a/src/content/docs/workers/platform/pricing.mdx b/src/content/docs/workers/platform/pricing.mdx index 18f0ae1dfa4f15d..7a5fdf92d5cb3bc 100644 --- a/src/content/docs/workers/platform/pricing.mdx +++ b/src/content/docs/workers/platform/pricing.mdx @@ -154,7 +154,7 @@ To learn more about KV, refer to the [KV documentation](/kv/). -:::note[KV documentation] +:::note[Hyperdrive documentation] To learn more about Hyperdrive, refer to the [Hyperdrive documentation](/hyperdrive/). diff --git a/src/content/partials/workers/hyperdrive_pricing.mdx b/src/content/partials/workers/hyperdrive_pricing.mdx index b2d8ec6b549fcd7..88a6049b1869806 100644 --- a/src/content/partials/workers/hyperdrive_pricing.mdx +++ b/src/content/partials/workers/hyperdrive_pricing.mdx @@ -2,18 +2,20 @@ {} --- -import { Markdown } from "~/components"; +import { Markdown, Details } from "~/components"; Hyperdrive is included in both the Free and Paid [Workers plans](/workers/platform/pricing/). -| | Free plan1 | Paid plan | +| | Free plan[^1] | Paid plan | | ---------------------------- | --------------------- | --------- | -| Database queries2 | 100,000 / day | Unlimited | +| Database queries[^2] | 100,000 / day | Unlimited | -1 The Workers Free plan includes limited Hyperdrive usage. All limits -reset daily at 00:00 UTC. If you exceed any one of these limits, further -operations of that type will fail with an error. +[^1]: The Workers Free plan includes limited Hyperdrive usage. All limits reset daily at 00:00 UTC. If you exceed any one of these limits, further operations of that type will fail with an error. -2 Database queries refers to any database statement made via -Hyperdrive, whether a query (`SELECT`), a modification (`INSERT`,`UPDATE`, or -`DELETE`) or a schema change (`CREATE`, `ALTER`, `DROP`). +[^2]: Database queries refers to any database statement made via Hyperdrive, whether a query (`SELECT`), a modification (`INSERT`,`UPDATE`, or `DELETE`) or a schema change (`CREATE`, `ALTER`, `DROP`). + +
+1: The Workers Free plan includes limited Hyperdrive usage. All limits reset daily at 00:00 UTC. If you exceed any one of these limits, further operations of that type will fail with an error. + +2: Database queries refers to any database statement made via Hyperdrive, whether a query (`SELECT`), a modification (`INSERT`,`UPDATE`, or `DELETE`) or a schema change (`CREATE`, `ALTER`, `DROP`). +