Skip to content
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

Clarify different variants of "multi-database support" #6156

Draft
wants to merge 1 commit into
base: develop
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 16 additions & 12 deletions product_docs/docs/pgd/5.6/planning/limitations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,18 +24,22 @@ into account when planning your deployment.

## Multiple databases on single instances

Support for using PGD for multiple databases on the same Postgres instance is
**deprecated** beginning with PGD 5 and will no longer be supported with PGD 6. As
we extend the capabilities of the product, the added complexity introduced
operationally and functionally is no longer viable in a multi-database design.

It's best practice and we recommend that you configure only one database per PGD instance.

The deployment automation with TPA and the tooling such as the CLI
and PGD Proxy already codify that recommendation.

While it's still possible to host up to 10 databases in a single instance,
doing so incurs many immediate risks and current limitations:
Support for running multiple instances of PGD on the same Postgres node is
**deprecated** beginning with PGD 5, as the operational complexity of this
approach is no longer viable.

Future versions of PGD will eventually disallow running multiple instances of
PGD. Instead, support for a single PGD installation hosting multiple databases
is being planned.

It's best practice and we recommend that you configure only one database per
PGD instance. The deployment automation with TPA and the tooling such as the
CLI and PGD Proxy already codify that recommendation. To separate tables into
modules, the use of schemas is recommended in combination with PGD 5.

While it's still possible to host up to 10 PGD enabled databases in a single
Postgres instance, doing so incurs many immediate risks and current
limitations:

- If PGD configuration changes are needed, you must execute administrative commands
for each database. Doing so increases the risk for potential
Expand Down
24 changes: 14 additions & 10 deletions product_docs/docs/pgd/5/planning/limitations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -23,20 +23,24 @@ into account when planning your deployment.
details](architectures/#architecture-details).


## Multiple databases on single instances
## Multiple PGD instances per Postgres node

Support for using PGD for multiple databases on the same Postgres instance is
**deprecated** beginning with PGD 5 and will no longer be supported with PGD 6. As
we extend the capabilities of the product, the added complexity introduced
operationally and functionally is no longer viable in a multi-database design.
Support for running multiple instances of PGD on the same Postgres node is
**deprecated** beginning with PGD 5, as the operational complexity of this
approach is no longer viable.

It's best practice and we recommend that you configure only one database per PGD instance.
Future versions of PGD will eventually disallow running multiple instances of
PGD. Instead, support for a single PGD installation hosting multiple databases
is being planned.

The deployment automation with TPA and the tooling such as the CLI
and PGD Proxy already codify that recommendation.
It's best practice and we recommend that you configure only one database per
PGD instance. The deployment automation with TPA and the tooling such as the
CLI and PGD Proxy already codify that recommendation. To separate tables into
modules, the use of schemas is recommended in combination with PGD 5.

While it's still possible to host up to 10 databases in a single instance,
doing so incurs many immediate risks and current limitations:
While it's still possible to host up to 10 PGD enabled databases in a single
Postgres instance, doing so incurs many immediate risks and current
limitations:

- If PGD configuration changes are needed, you must execute administrative commands
for each database. Doing so increases the risk for potential
Expand Down
Loading