Skip to content

Commit 0502159

Browse files
mwannergvasquezvargas
authored andcommitted
Clarify different variants of "multi-database support"
1 parent 90c3542 commit 0502159

File tree

2 files changed

+30
-22
lines changed

2 files changed

+30
-22
lines changed

product_docs/docs/pgd/5.6/planning/limitations.mdx

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -24,18 +24,22 @@ into account when planning your deployment.
2424

2525
## Multiple databases on single instances
2626

27-
Support for using PGD for multiple databases on the same Postgres instance is
28-
**deprecated** beginning with PGD 5 and will no longer be supported with PGD 6. As
29-
we extend the capabilities of the product, the added complexity introduced
30-
operationally and functionally is no longer viable in a multi-database design.
31-
32-
It's best practice and we recommend that you configure only one database per PGD instance.
33-
34-
The deployment automation with TPA and the tooling such as the CLI
35-
and PGD Proxy already codify that recommendation.
36-
37-
While it's still possible to host up to 10 databases in a single instance,
38-
doing so incurs many immediate risks and current limitations:
27+
Support for running multiple instances of PGD on the same Postgres node is
28+
**deprecated** beginning with PGD 5, as the operational complexity of this
29+
approach is no longer viable.
30+
31+
Future versions of PGD will eventually disallow running multiple instances of
32+
PGD. Instead, support for a single PGD installation hosting multiple databases
33+
is being planned.
34+
35+
It's best practice and we recommend that you configure only one database per
36+
PGD instance. The deployment automation with TPA and the tooling such as the
37+
CLI and PGD Proxy already codify that recommendation. To separate tables into
38+
modules, the use of schemas is recommended in combination with PGD 5.
39+
40+
While it's still possible to host up to 10 PGD enabled databases in a single
41+
Postgres instance, doing so incurs many immediate risks and current
42+
limitations:
3943

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

product_docs/docs/pgd/5/planning/limitations.mdx

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -23,20 +23,24 @@ into account when planning your deployment.
2323
details](architectures/#architecture-details).
2424

2525

26-
## Multiple databases on single instances
26+
## Multiple PGD instances per Postgres node
2727

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

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

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

38-
While it's still possible to host up to 10 databases in a single instance,
39-
doing so incurs many immediate risks and current limitations:
41+
While it's still possible to host up to 10 PGD enabled databases in a single
42+
Postgres instance, doing so incurs many immediate risks and current
43+
limitations:
4044

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

0 commit comments

Comments
 (0)