docs: add pooling and troubleshooting sections to the Postgres guide - #157
Open
mandarini wants to merge 1 commit into
Open
docs: add pooling and troubleshooting sections to the Postgres guide#157mandarini wants to merge 1 commit into
mandarini wants to merge 1 commit into
Conversation
commit: |
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
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.
Adds the operational half of the Postgres guide, so a user can diagnose the common failures without opening a ticket.
docs/postgres.mdgains a "Connection pooling" subsection (4 connections per process, no wait limit, five round trips per scoped query), a "Which connection string to use" subsection (the Edge Functions default is the direct connection; use the transaction-mode pooler string for many isolates, passed asconnectionStringsinceSUPABASE_secret names are reserved), a Denoimport 'pg'note under Runtime support, a "Troubleshooting" table with ten symptoms and short sections for zero rows, saturation, the wrong-password circuit breaker, dropped connections, and roles in pooler logs, plus a "No pool tuning" bullet under Limits. The README docs index gets one row pointing at the troubleshooting anchor; the other rows only re-aligned. Every fact describes the pool as it is onmain.