-
Notifications
You must be signed in to change notification settings - Fork 856
docs(): update for the 6.19 release #7232
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
Closed
Closed
Changes from 5 commits
Commits
Show all changes
7 commits
Select commit
Hold shift + click to select a range
48504a1
docs(): update for the 6.19 release
mhartington f2baf0f
Apply suggestion from @coderabbitai[bot]
mhartington 4811bf7
Apply suggestion from @coderabbitai[bot]
mhartington ef2433c
Apply suggestion from @coderabbitai[bot]
mhartington 9441072
Apply suggestion from @coderabbitai[bot]
mhartington 7f97163
docs(): update with feedback
mhartington adf0ee1
docs(): update with feedback
mhartington File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -8,7 +8,7 @@ toc: true | |
|
|
||
| ## Overview | ||
|
|
||
| Prisma Postgres is the perfect choice for your applications, whether you connect to it via [Prisma ORM](/orm) or any other ORM, database library / tool of your choice. If you use it with Prisma ORM, Prisma Postgres comes with built-in connection pooling and an integrated caching layer (powered by [Prisma Accelerate](/accelerate/)). | ||
| Prisma Postgres is the perfect choice for your applications, whether you connect to it via [Prisma ORM](/orm) or any other ORM, database library / tool of your choice. If you use it with Prisma ORM, Prisma Postgres comes with built-in connection pooling, and an integrated caching layer (powered by [Prisma Accelerate](/accelerate/)). | ||
|
|
||
| If you connect to it via another tool, you can do so with a [direct connection string](#connection-string) following the conventional PostgreSQL format. | ||
|
|
||
|
|
@@ -18,10 +18,10 @@ In order to get a direct connection string, you need to: | |
|
|
||
| 1. Open a project in your [Prisma Console](https://console.prisma.io) account (or create a new one) | ||
| 1. Navigate to your active Prisma Postgres instance. | ||
| 1. Click the **API Keys** tab in the project's sidenav. | ||
| 1. Click the **Create API key** button. | ||
| 1. In the popup, provide a **Name** for the API key and click **Create**. | ||
| 1. Copy the connection string starting with `postgres://`, this is your direct connection string. | ||
| 1. Click the **Connect to your database** button in your dashboard. | ||
| 1. Click the **Generate new connection string** button. | ||
| 1. If enabling connection pooling, click the toggle button | ||
| 1. Copy the connection string starting that is generated below. | ||
|
|
||
| ## Connection string | ||
|
|
||
|
|
@@ -43,6 +43,14 @@ DATABASE_URL="postgres://2f9881cc7eef46f094ac913df34c1fb441502fe66cbe28cc48998d4 | |
|
|
||
| SSL mode is required when connecting to Prisma Postgres via direct TCP, so you need to append `sslmode=require` to your TCP connection string. | ||
|
|
||
| ### Pooling connections | ||
|
|
||
| If you want to enable connection pooling, you can append `pool=true` to your TCP connection string | ||
|
|
||
| ```bash | ||
| DATABASE_URL="postgres://USER:[email protected]:5432/?pool=true" | ||
| ``` | ||
|
|
||
| ## Billing | ||
|
|
||
| When using direct TCP to connect to a Prisma Postgres instance, every SQL query is counted as a [billable operation](/postgres/introduction/overview#usage-based-pricing). Learn more on our [pricing page](https://www.prisma.io/pricing). | ||
|
|
@@ -55,20 +63,16 @@ Prisma Postgres closes idle connections after an extended period of time. If tha | |
|
|
||
| ### Connection limit | ||
|
|
||
| While direct connections are in Early Access, the following connection limits apply: | ||
|
|
||
| | | Free | Starter | Pro | Business | | ||
| | ------------------------------------ | ---------------- | ---------------- | ---------------- | ---------------- | | ||
| | **Connection limit** | Max 10 | Max 10 | Max 50 | Max 100 | | ||
| | **Connection limit** | Max 10 | Max 10 | Max 50 | Max 100 | | ||
|
|
||
| ### Query and transaction timeouts | ||
|
|
||
| While direct connections are in Early Access, the following timeouts apply: | ||
|
|
||
| | | Free | Starter | Pro | Business | | ||
| | ------------------------------------ | ---------------- | ---------------- | ---------------- | ---------------- | | ||
| | **Query timeout** | Up to 10 seconds | Up to 10 seconds | Up to 10 seconds | Up to 10 seconds | | ||
| | **Interactive transactions timeout** | Up to 15 seconds | Up to 15 seconds | Up to 15 seconds | Up to 15 seconds | | ||
| | **Query timeout** | Up to 10 seconds | Up to 10 seconds | Up to 10 seconds | Up to 10 seconds | | ||
| | **Interactive transactions timeout** | Up to 15 seconds | Up to 15 seconds | Up to 15 seconds | Up to 15 seconds | | ||
|
|
||
| ### Limited user permissions | ||
|
|
||
|
|
@@ -78,13 +82,6 @@ User permissions are limited to read, write and schema changes. It is not possib | |
|
|
||
| Prisma Postgres can be accessed securely via a TCP tunnel using the [`@prisma/ppg-tunnel`](https://www.npmjs.com/package/@prisma/ppg-tunnel) package, an authentication proxy designed for local database workflows. This package establishes a secure connection to Prisma Postgres through a local TCP server, enabling secure access while automatically handling traffic routing and authentication. | ||
|
|
||
| :::note | ||
|
|
||
| This is a [Early Access](/platform/maturity-levels#early-access) feature of Prisma Postgres. It is not recommended for production use and is not intended for application-level access. | ||
|
|
||
| While in Early Access, usage of the TCP tunnel will be free of charge. | ||
|
|
||
| ::: | ||
|
|
||
| ### Prerequisites | ||
|
|
||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.