Skip to content

Commit 9bac6fc

Browse files
Merge pull request #6006 from EnterpriseDB/release/2024-08-29a
Release/2024-08-29a
2 parents 8abb45f + 27fc779 commit 9bac6fc

File tree

9 files changed

+40
-29
lines changed

9 files changed

+40
-29
lines changed

advocacy_docs/pg_extensions/extensionrefs.json

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -122,5 +122,8 @@
122122
"sql_profiler":"https://www.enterprisedb.com/docs/pem/latest/profiling_workloads/using_sql_profiler/",
123123
"pg_squeeze":"https://www.enterprisedb.com/docs/pg_extensions/pg_squeeze/",
124124
"wal2json":"https://www.enterprisedb.com/docs/pg_extensions/wal2json/",
125-
"system_stats":"https://www.enterprisedb.com/docs/pg_extensions/system_stats/"
125+
"system_stats":"https://www.enterprisedb.com/docs/pg_extensions/system_stats/",
126+
"orafce":"https://github.com/orafce/orafce",
127+
"plv8":"https://github.com/plv8/plv8",
128+
"bluefin":"https://www.enterprisedb.com/docs/pg_extensions/advanced_storage_pack/"
126129
}

advocacy_docs/pg_extensions/index.mdx

Lines changed: 4 additions & 1 deletion
Large diffs are not rendered by default.

product_docs/docs/eprs/7/eprs_rel_notes/eprs_rel_notes_7.9.0.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,13 +12,13 @@ New features, enhancements, bug fixes, and other changes in Replication Server 7
1212
| Enhancement | EDB Postgres Replication Server now supports batch replication for Oracle CLOB and BLOB types in Synchronize mode. This significantly reduces the time required to replicate a large number of row changes containing CLOB/BLOB type columns. | #102185 <br/> #35513 |
1313
| Enhancement | The transaction commit timestamp from the origin node is now preserved when replicating to a target node. This is required to process the timestamp-based UPDATE conflicts when EDB Postgres Replication Server is used in a hybrid cluster where the EPRS Publication node is shared with EDB Postgres Distributed (PGD). | |
1414
| Bug&nbsp;fix | Fixed a corner case issue where the synchronization from the target MMR node failed to resume. | #102604 <br/> #35539 |
15-
| Bug&nbsp;fix | Fixed an issue where some of the processed entries in the `rrep_tx_monitor` table were not cleaned up. | |
15+
| Bug&nbsp;fix | Fixed an issue where some of the processed entries in the `rrep_tx_monitor` table weren't cleaned up. | |
1616

1717
## End-of-support notice
1818

1919
Replication Server 6.2 is no longer a supported version.
2020

21-
To ensure that your usage of Replication Server is supported, please upgrade any installations with version 6.2 to version 7. See the end-of-support notes that follow:
21+
To ensure that your usage of Replication Server is supported, upgrade any installations with version 6.2 to version 7. See the end-of-support notes that follow:
2222

2323
**Software:** Replication Server
2424

product_docs/docs/pem/9/monitoring_performance/probes.mdx

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -165,13 +165,18 @@ Use the **General** tab to modify the definition of an existing probe or to spec
165165

166166
To invoke a script on a Windows system, set the registry entry for `AllowBatchJobSteps` to `true` and restart the PEM agent.
167167

168-
- Use the **Target Type** list to select the object type for the probe to monitor. **Target Type** is disabled if **Collection method** is WMI. Configure the **Target Type** in probes to ensure that the collected metrics are relevant and accurate for the intended level of the system hierarchy. With the **Target Type**, you can effectively monitor various components, ranging from individual database objects like tables and indexes, up to server-wide monitoring.
168+
- Use the **Target Type** list to select the object type for the probe to monitor. **Target Type** is disabled if **Collection method** is WMI. Configure **Target Type** in probes to ensure that the collected metrics are relevant and accurate for the intended level of the system hierarchy. By setting the target type, you can effectively monitor various components, ranging from individual database objects like tables and indexes to server-wide monitoring.
169169

170-
<details><summary>Target Type configuration matrix</summary>
170+
<details><summary>Target type configuration matrix</summary>
171171

172-
The following table provides an overview of **Target Type** configurations, their monitoring scope, and the mandatory fields you must provide when configuring them.
172+
The following table provides an overview of the target type configurations, their monitoring scope, and the mandatory fields for configuring them.
173173

174-
In this table, the target type column determines the object you want to monitor with the probe. The execution level column determines if the monitoring probes executes once per-database, per-server, per-agent, or per-extension level. The mandatory column indicates the coloumns you must configure in the probe query to ensure the required data is collected. Finally, the probe examples column provides some existing probes you can explore to better understand how probes are used in practice.
174+
In this table:
175+
176+
- The **Target type** column determines the object you want to monitor with the probe.
177+
- The **Execution level** column determines if the monitoring probes execute once per database, per server, per agent, or per extension level.
178+
- The **Mandatory columns** column indicates the coloumns you must configure in the probe query to ensure the required data is collected.
179+
- The **Probe examples** column provides some existing probes you can explore to better understand how probes are used in practice.
175180

176181
| Target type | Execution level | Mandatory columns | Probe examples |
177182
|-------------|-----------------|------------------------------------------------------|----------------|
@@ -187,8 +192,8 @@ Use the **General** tab to modify the definition of an existing probe or to spec
187192
| Extension | Extension | None | Extension |
188193

189194
!!!note
190-
- The custom probes set to a database or larger **Target Type** (including schema, table, index, view, sequence, and functions) collects the information at database level.
191-
- The system probes set to a schema or larger **Target Type** collects the information up to schema level.
195+
- The custom probes set to a database or larger target type (including schema, table, index, view, sequence, and functions) collect the information at the database level.
196+
- The system probes set to a schema or larger target type collect the information up to the schema level.
192197
!!!
193198

194199
</details>
@@ -211,7 +216,7 @@ Use the **General** tab to modify the definition of an existing probe or to spec
211216

212217
Use the **Columns** tab to define the columns in which to store the probe data. To define a new column:
213218
1. Navigate to the **Columns** tab and select **Add** in the upper-right corner.
214-
2. Provide a column name in the **Name** field.
219+
2. In the **Name** field, provide a column name.
215220
3. Select **Edit** (to the left of the new column name) to provide information about the column:
216221

217222
- Provide a descriptive name for the column in the **Name** field.

product_docs/docs/pgd/5/monitoring/sql.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -534,7 +534,7 @@ bdrdb=# SELECT * FROM bdr.monitor_group_versions();
534534
## Monitoring Raft consensus
535535

536536
Raft consensus must be working cluster-wide at all times. The impact
537-
of running a EDB Postgres Distributed cluster without Raft consensus working might be as
537+
of running an EDB Postgres Distributed cluster without Raft consensus working might be as
538538
follows:
539539

540540
- The replication of PGD data changes might still work correctly.

product_docs/docs/pgd/5/node_management/heterogeneous_clusters.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@ title: Joining a heterogeneous cluster
33
---
44

55

6-
A PGD 4.0 node can join a EDB Postgres Distributed cluster running 3.7.x at a specific
6+
A PGD 4.0 node can join an EDB Postgres Distributed cluster running 3.7.x at a specific
77
minimum maintenance release (such as 3.7.6) or a mix of 3.7 and 4.0 nodes.
88
This procedure is useful when you want to upgrade not just the PGD
99
major version but also the underlying PostgreSQL major
1010
version. You can achieve this by joining a 3.7 node running on
11-
PostgreSQL 12 or 13 to a EDB Postgres Distributed cluster running 3.6.x on
11+
PostgreSQL 12 or 13 to an EDB Postgres Distributed cluster running 3.6.x on
1212
PostgreSQL 11. The new node can also
1313
run on the same PostgreSQL major release as all of the nodes in the
1414
existing cluster.

product_docs/docs/pgd/5/testingandtuning.mdx

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ description: Learn how to test and tune EDB Postgres Distributed clusters.
77
You can test PGD applications using the following approaches:
88

99
- [Trusted Postgres Architect](#trusted-postgres-architect)
10-
- [pgd_bench with CAMO/Failover options](#pgd_bench)
10+
- [pgd_bench with CAMO/failover options](#pgd_bench)
1111

1212

1313
### Trusted Postgres Architect
@@ -37,7 +37,7 @@ extended in PGD 5.0 in the form of a new application: pgd_bench.
3737
directory. The utility is based on the PostgreSQL pgbench tool but
3838
supports benchmarking CAMO transactions and PGD-specific workloads.
3939

40-
Functionality of pgd_bench is a superset of those of pgbench but
40+
Functionality of pgd_bench is a superset of pgbench functionality but
4141
requires the BDR extension to be installed to work properly.
4242

4343
Key differences include:
@@ -46,7 +46,7 @@ Key differences include:
4646
pgbench scenario to prevent global lock timeouts in certain cases.
4747
- `VACUUM` command in the standard scenario is executed on all nodes.
4848
- pgd_bench releases are tied to the releases of the BDR extension
49-
and are built against the corresponding Postgres distribution. This is
49+
and are built against the corresponding Postgres distribution. This information is
5050
reflected in the output of the `--version` flag.
5151

5252
The current version allows you to run failover tests while using CAMO or
@@ -60,7 +60,7 @@ mode in which pgbench should run (default: regular)
6060
```
6161

6262
- Use `-m camo` or `-m failover` to specify the mode for pgd_bench.
63-
You can use The `-m failover` specification to test failover in
63+
You can use the `-m failover` specification to test failover in
6464
regular PGD deployments.
6565

6666
```
@@ -89,7 +89,7 @@ to get the status of in-flight transactions. Aborted and in-flight transactions
8989
are retried in CAMO mode.
9090

9191
In failover mode, if you specify `--retry`, then in-flight transactions are
92-
retried. In this scenario there's no way to find the status of in-flight
92+
retried. In this scenario, there's no way to find the status of in-flight
9393
transactions.
9494

9595
### Notes on pgd_bench usage
@@ -126,7 +126,7 @@ Complex applications require some thought to maintain scalability.
126126

127127
If you think you're having performance problems, develop performance tests using
128128
the benchmarking tools. pgd_bench allows you to write custom test scripts specific
129-
to your use case so you can understand the overheads of your SQL and measure the
129+
to your use case so you can understand the overhead of your SQL and measure the
130130
impact of concurrent execution.
131131

132132
If PGD is running slow, then we suggest the following:

product_docs/docs/pgd/5/transaction-streaming.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ limitations:
3131
- If the transaction aborts, the work (changes received by each subscriber
3232
and the associated storage I/O) is wasted.
3333

34-
However, starting with version 3.7, PGD supports parallel apply, enabling multiple writer
34+
However, starting with version 3.7, PGD supports Parallel Apply, enabling multiple writer
3535
processes on each subscriber. This capability is leveraged to provide the following enhancements:
3636

3737
- Decoded transactions can be streamed directly to a writer on the subscriber.
@@ -41,7 +41,7 @@ processes on each subscriber. This capability is leveraged to provide the follow
4141

4242
### Caveats
4343

44-
- You must enable parallel apply.
44+
- You must enable Parallel Apply.
4545
- Workloads consisting of many small and conflicting transactions can lead to
4646
frequent deadlocks between writers.
4747

@@ -108,16 +108,16 @@ streaming, the subscriber requests transaction streaming.
108108
If the publisher can provide transaction streaming, it
109109
streams transactions whenever the transaction size exceeds the threshold set in
110110
`logical_decoding_work_mem`. The publisher usually has no control over whether
111-
the transactions is streamed to a file or to a writer. Except for some
111+
the transactions are streamed to a file or to a writer. Except for some
112112
situations (such as COPY), it might hint for the subscriber to stream the
113113
transaction to a writer (if possible).
114114

115115
The subscriber can stream transactions received from the publisher to
116116
either a writer or a file. The decision is based on several factors:
117117

118-
- If parallel apply is off (`num_writers = 1`), then it's streamed to a file.
118+
- If Parallel Apply is off (`num_writers = 1`), then it's streamed to a file.
119119
(writer 0 is always reserved for non-streamed transactions.)
120-
- If parallel apply is on but all writers are already busy handling streamed
120+
- If Parallel Apply is on but all writers are already busy handling streamed
121121
transactions, then the new transaction is streamed to a file. See
122122
[Monitoring PGD writers](monitoring/sql#monitoring-pgd-writers) to check PGD
123123
writer status.

product_docs/docs/pgd/5/twophase.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ redirects:
88
---
99

1010
!!!Note
11-
Two-phase commit is not available with Group Commit or CAMO. See [Durability limitations](durability/limitations).
11+
Two-phase commit isn't available with Group Commit or CAMO. See [Durability limitations](durability/limitations).
1212
!!!
1313

1414
An application can explicitly opt to use two-phase commit with PGD. See
@@ -19,14 +19,14 @@ software components:
1919

2020
- An application program (AP) that defines transaction boundaries and specifies
2121
actions that constitute a transaction
22-
- Resource managers (RMs, such as databases or file-access systems) that provide
22+
- Resource managers (RMs), such as databases or file-access systems, that provide
2323
access to shared resources
2424
- A separate component called a transaction manager (TM) that assigns identifiers
2525
to transactions, monitors their progress, and takes responsibility for
2626
transaction completion and for failure recovery
2727

2828
PGD supports explicit external 2PC using the `PREPARE TRANSACTION` and
29-
`COMMIT PREPARED`/`ROLLBACK PREPARED` commands. Externally, a EDB Postgres Distributed cluster
29+
`COMMIT PREPARED`/`ROLLBACK PREPARED` commands. Externally, an EDB Postgres Distributed cluster
3030
appears to be a single resource manager to the transaction manager for a
3131
single session.
3232

@@ -44,7 +44,7 @@ or the global commit scope. Future releases might enable this combination.
4444
## Use
4545

4646
Two-phase commits with a local commit scope work exactly like standard
47-
PostgreSQL. Use the local commit scope and disable CAMO.
47+
PostgreSQL. Use the local commit scope and disable CAMO:
4848

4949
```sql
5050
BEGIN;

0 commit comments

Comments
 (0)