Skip to content

docs: Warn that session settings carry over on the pooled Cloud database - #861

Open
Zfinix wants to merge 2 commits into
mainfrom
fix/cloud-db-pooled-session-settings
Open

Zfinix wants to merge 2 commits into
mainfrom
fix/cloud-db-pooled-session-settings

Conversation

@Zfinix

@Zfinix Zfinix commented Sep 24, 2026 •

Copy link
Copy Markdown
Contributor

On the pooled endpoint, a session-level SET carries over into later connections as the same user. After a pg_restore, which sets search_path to empty, new psql sessions fail with relation "..." does not exist until the pooled connection is recycled. Reproduction in serverpod/serverpod#5769.

This adds a warning at the end of "Access the database directly", where readers connect with psql or a GUI client, and recommends SET LOCAL, which ends with the transaction.

It doesn't fix the pooler, so the issue stays open. The self-hosted migration guide (#853) covers the pg_restore case in its troubleshooting section.

Related: serverpod/serverpod#5769

@Zfinix Zfinix self-assigned this Sep 24, 2026
@Zfinix Zfinix added the documentation Improvements or additions to documentation label Sep 24, 2026
@Zfinix
Zfinix force-pushed the fix/cloud-db-pooled-session-settings branch from d162937 to 57dd6cf Compare September 24, 2026 13:41
Comment thread cloud_docs/concepts/database.md Outdated
Co-authored-by: Jamiu Okanlawon <50176100+developerjamiu@users.noreply.github.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants