From b382cddeb56d1b903c964ac0923b779117039bb4 Mon Sep 17 00:00:00 2001 From: Shane Neubauer Date: Wed, 21 Oct 2026 16:13:34 +1100 Subject: [PATCH 1/2] docs(postgres): answer support gaps from the 2026-10-20 ticket audit Add FAQ answers for deleting a Vercel-created database and for custom roles, say what happens after the Free-plan grace period ends, explain Accelerate error 1102 in the switch guide, and point the account-deletion page at the Vercel uninstall path. --- .../content/docs/console/more/support.mdx | 2 +- .../database/switch-from-accelerate.mdx | 2 ++ apps/docs/content/docs/postgres/faq.mdx | 29 ++++++++++++++++++- 3 files changed, 31 insertions(+), 2 deletions(-) diff --git a/apps/docs/content/docs/console/more/support.mdx b/apps/docs/content/docs/console/more/support.mdx index 3af9035c77b..e0d72d52fc3 100644 --- a/apps/docs/content/docs/console/more/support.mdx +++ b/apps/docs/content/docs/console/more/support.mdx @@ -63,7 +63,7 @@ To open a workspace's settings, switch to that workspace with the workspace swit How to clear each cause: -- **Integration-managed workspace.** Console can't delete a workspace that is managed through an integration. If you can't transfer or remove it from the integration side, email [support@prisma.io](mailto:support@prisma.io) with the workspace name. +- **Integration-managed workspace.** Console can't delete a workspace that is managed through an integration. For a workspace created from the Prisma integration in Vercel, uninstall the integration in Vercel. This deletes the Prisma workspace the integration created and all its databases, so export any data you want to keep first. [How do I delete a Prisma Postgres database I created through Vercel?](/postgres/faq#how-do-i-delete-a-prisma-postgres-database-i-created-through-vercel) has the uninstall steps and covers deleting a single database. If you can't transfer or remove it from the integration side, email [support@prisma.io](mailto:support@prisma.io) with the workspace name. - **Billing email.** You can't change the billing email of an integration-managed workspace in Console. Email [support@prisma.io](mailto:support@prisma.io) with the workspace name. - **Paid plan.** Go to **Workspace Settings > Billing > Manage subscription**, choose **Free**, and click **Schedule cancellation**. The downgrade takes effect at the end of the current billing period, so you can't delete your account until then. When the **Subscription** card on the Billing page says "Your workspace is on the Free plan", the downgrade is done. See [Cancel a paid plan](/console/more/billing#cancel-a-paid-plan). - **Unpaid invoices.** Click **Pay your outstanding balance** in the banner at the top of the Console to open the unpaid invoice and pay it, or go to **Workspace Settings > Billing** and click **View Invoices**. See [If a payment fails](/console/more/billing#if-a-payment-fails). diff --git a/apps/docs/content/docs/postgres/database/switch-from-accelerate.mdx b/apps/docs/content/docs/postgres/database/switch-from-accelerate.mdx index c9527b7ca6d..e3527d9e9c9 100644 --- a/apps/docs/content/docs/postgres/database/switch-from-accelerate.mdx +++ b/apps/docs/content/docs/postgres/database/switch-from-accelerate.mdx @@ -10,6 +10,8 @@ This guide is for existing Prisma Postgres applications that connect through a h The hosted Accelerate connection will be retired on December 1, 2026. This guide does not apply to [Local Postgres](/local-development/postgres) URLs such as `prisma+postgres://localhost:51213`. +If your application gets `P6000` errors with the message "Worker exceeded resource limits" (Cloudflare error 1102), switching to one of the connection methods in this guide fixes them. Accelerate returns this error when one request is too big for it to process, usually because the query or its result is large. Until you switch, lower `take` to fetch fewer rows per query, and remove relations you don't need from `include`. + :::warning[Query caching is not replaced] Both replacement paths retain Prisma Postgres connection pooling. Neither path retains Accelerate query caching. Prisma Postgres does not currently provide replacement query caching, so remove every Accelerate caching API before you switch. diff --git a/apps/docs/content/docs/postgres/faq.mdx b/apps/docs/content/docs/postgres/faq.mdx index b8552366e5b..026b87718ed 100644 --- a/apps/docs/content/docs/postgres/faq.mdx +++ b/apps/docs/content/docs/postgres/faq.mdx @@ -28,6 +28,16 @@ Yes, on [Prisma Compute](/compute), which runs TypeScript apps built for Node.js In three steps: create a Prisma Postgres database, `pg_dump` the local database, and `pg_restore` the dump over the direct connection, whose host is `db.prisma.io`. The copy is a snapshot, so stop writing to the local database before the final dump, and resume writes only on Prisma Postgres, after you have verified the restored database and pointed the app at it. [Migrate a local Postgres database to the cloud](/postgres/import-from-existing-database) has the commands and the checks to run first: PostgreSQL 17 tools, extensions, and the roles that row-level security policies name. +### Can I create my own database roles? + +Prisma Postgres doesn't support custom roles. The database user in your connection string can't create roles, so `CREATE ROLE` fails with this error: + +```text +ERROR: restricted superuser cannot create roles +``` + +If you wanted a role to give one part of your application read-only access, check in your own code which queries that part may run before it sends them. + ### How do I switch from GitHub login to email and password login? If you previously signed up using GitHub and want to switch to email and password login, follow these steps: @@ -77,7 +87,7 @@ Prisma Postgres bills based on _operations_ and _storage_ consumed. It does not When you use all the queries included in your Free plan, your Prisma Postgres database stops accepting read and write requests. You can upgrade to a [paid plan](https://www.prisma.io/pricing) to restore access, usually within a minute, or wait until your query allowance resets at the start of the next calendar month. -If you need to export your data or need more time before upgrading, you can activate a grace period for 24 hours. In the [Prisma Console](https://console.prisma.io/), open the workspace that groups your projects and databases, then select **Restore access for 24 hours** in the warning about your query limit. This lifts the query limit for all Prisma Postgres databases in the workspace. The grace period is available only once per workspace and does not renew each month. +If you need to export your data or need more time before upgrading, you can activate a grace period for 24 hours. In the [Prisma Console](https://console.prisma.io/), open the workspace that groups your projects and databases, then select **Restore access for 24 hours** in the warning about your query limit. This lifts the query limit for all Prisma Postgres databases in the workspace. The grace period is available only once per workspace and does not renew each month. When the 24 hours end, queries are blocked again until you upgrade or your included queries reset at the start of the next month. The warning won't offer to restore access again. While queries are blocked, your data is not deleted. ### What is an operation? @@ -256,6 +266,23 @@ If you installed Prisma Postgres through the [Vercel Marketplace integration](/g - Under Current Installation Plan Level, click **Change Plan**. - Select the plan you want to upgrade to. +### How do I delete a Prisma Postgres database I created through Vercel? + +Delete it in your Vercel dashboard. The Prisma Console has no delete option for databases created through Vercel, and deleting the Vercel project that was connected to the database leaves the database in place. + +Deleting a database is permanent, so before you start, [export any data you want to keep with `pg_dump`](/postgres/database/backups#manually-creating-a-backup-file-via-pg_dump). + +1. Open your [Vercel](https://vercel.com/) Dashboard and select the team that owns the database. +2. Open **Storage** in the sidebar and select the database. +3. Open its **Settings** and choose the option to delete the database, then confirm. + +Usage charges for the database stop when you delete it. Usage from before that still appears on your Vercel invoice. + +Deleting a database doesn't cancel a paid plan, so you keep paying the monthly plan fee until you either change the plan or uninstall the integration: + +- Follow the steps in the previous answer and select the Free plan. The change takes effect at the end of the current billing period. +- Uninstall the integration: in **Integrations**, click **Manage** on the Prisma integration, then click **Uninstall Integration** at the bottom of the page. This deletes the Prisma workspace the integration created and all its databases, so export first. A final Vercel invoice covers the usage up to that point. + ## Caching ### Does Prisma Postgres cache query results? From ad6f80631fe320eed9dbb3761026806ef34dd6ad Mon Sep 17 00:00:00 2001 From: Shane Neubauer Date: Wed, 21 Oct 2026 16:27:54 +1100 Subject: [PATCH 2/2] docs(postgres): address review on Accelerate 1102, Vercel delete steps, custom roles --- .../content/docs/postgres/database/switch-from-accelerate.mdx | 2 +- apps/docs/content/docs/postgres/faq.mdx | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/apps/docs/content/docs/postgres/database/switch-from-accelerate.mdx b/apps/docs/content/docs/postgres/database/switch-from-accelerate.mdx index e3527d9e9c9..90d30890e85 100644 --- a/apps/docs/content/docs/postgres/database/switch-from-accelerate.mdx +++ b/apps/docs/content/docs/postgres/database/switch-from-accelerate.mdx @@ -10,7 +10,7 @@ This guide is for existing Prisma Postgres applications that connect through a h The hosted Accelerate connection will be retired on December 1, 2026. This guide does not apply to [Local Postgres](/local-development/postgres) URLs such as `prisma+postgres://localhost:51213`. -If your application gets `P6000` errors with the message "Worker exceeded resource limits" (Cloudflare error 1102), switching to one of the connection methods in this guide fixes them. Accelerate returns this error when one request is too big for it to process, usually because the query or its result is large. Until you switch, lower `take` to fetch fewer rows per query, and remove relations you don't need from `include`. +If your application gets `P6000` errors with the message "Worker exceeded resource limits" (Cloudflare error 1102), the limit was hit inside Accelerate, not in your own code, so switching to one of the connection methods in this guide fixes them. Larger queries and results make the error more likely. Until you switch, fetch fewer rows per query with a lower `take`, and remove relations you don't need from `include`. :::warning[Query caching is not replaced] diff --git a/apps/docs/content/docs/postgres/faq.mdx b/apps/docs/content/docs/postgres/faq.mdx index 026b87718ed..a89b5bc7abd 100644 --- a/apps/docs/content/docs/postgres/faq.mdx +++ b/apps/docs/content/docs/postgres/faq.mdx @@ -36,7 +36,7 @@ Prisma Postgres doesn't support custom roles. The database user in your connecti ERROR: restricted superuser cannot create roles ``` -If you wanted a role to give one part of your application read-only access, check in your own code which queries that part may run before it sends them. +If you wanted a role to give one part of your application read-only access, enforce that in your application instead. When that part sends its queries through Prisma ORM 8, a [middleware can refuse any query that isn't a read](/orm/middleware/how-middleware-works#beforequery-and-beforeexecute-validate-or-block) before it reaches the database. ### How do I switch from GitHub login to email and password login? @@ -274,7 +274,7 @@ Deleting a database is permanent, so before you start, [export any data you want 1. Open your [Vercel](https://vercel.com/) Dashboard and select the team that owns the database. 2. Open **Storage** in the sidebar and select the database. -3. Open its **Settings** and choose the option to delete the database, then confirm. +3. In the database's **Settings**, choose the option to delete the database, then confirm. Usage charges for the database stop when you delete it. Usage from before that still appears on your Vercel invoice.