Troubleshoot PostgreSQL
Resolve connection, account, import, and operation problems.
A private endpoint is unreachable
Verify that the database is running and the client is on the same server and project network. A workstation outside that network must use an enabled external endpoint. Confirm the selected account's credentials and database name.
An external TLS connection fails
Use the external hostname and displayed port. The client must support PostgreSQL TLS and SNI. Check certificate trust and hostname verification settings. If external access was disabled, enable it before retrying a new connection.
An application account cannot access an object
Check object ownership and grants in PostgreSQL. Application accounts are not server administrators and do not automatically own objects created by another application account. Use an appropriately privileged account to grant the required access.
Credentials fail after rotation
Reload connection details, update the application secret, and create a new connection. An existing open session does not prove that the old password works. For interrupted rotation, inspect operation status before requesting another update.
Import or backup fails
For imports, verify source reachability, supported versions, destination emptiness, permissions, extensions, and size limits. Inspect destination data before retrying. For backups, check whether the environment enables backups and inspect the attempt's failure details.
An operation remains pending
Refresh the detail page and avoid repeated conflicting requests. Contact support with the resource ID, operation type, timestamps, and error text. Exclude passwords and complete credential-bearing URIs.