Skip to content

Commit 51e396f

Browse files
Merge pull request #4649 from hariramt/task/MigrationUpdate-1stApril2026
Online migration update for pgoutput
2 parents e9e39ef + 89763bf commit 51e396f

6 files changed

+34
-39
lines changed

articles/postgresql/migrate/migration-service/includes/alloy-db/prerequisites-migration-service-postgresql-online-alloy-db.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,6 @@ ms.topic: include
1212
Before starting the migration with the Azure Database for PostgreSQL migration service, it's important to fulfill the following prerequisites, specifically designed for online migration scenarios.
1313

1414
- [Verify the source version](#verify-the-source-version)
15-
- [Install test_decoding - Source Setup](#install-test_decoding---source-setup)
1615
- [Configure target setup](#configure-target-setup)
1716
- [Enable CDC as a source](#enable-cdc-as-a-source)
1817
- [Configure network setup](#configure-network-setup)
@@ -29,11 +28,11 @@ If the source PostgreSQL version is less than 9.5, upgrade it to 9.5 or higher b
2928
> [!NOTE]
3029
> The migration service in Azure Database for PostgreSQL supports connections using the IP address for source Google AlloyDB for PostgreSQL. The format `myproject:myregion:myinstance` isn't supported.
3130
32-
### Install test_decoding - source setup
33-
34-
- **test_decoding** receives WAL through the logical decoding mechanism and decodes it into text representations of the operations performed.
35-
- In Google AlloyDB for PostgreSQL, the test_decoding plugin is preinstalled and ready for logical replication. This allows you to easily set up logical replication slots and stream WAL changes, facilitating use cases such as change data capture (CDC) or replication to external systems.
36-
- For more information about the test-decoding plugin, see the [PostgreSQL documentation](https://www.postgresql.org/docs/16/test-decoding.html)
31+
> [!NOTE]
32+
> - [PgOutput](../../concepts-required-user-permissions.md#online-migration-using-pgoutput---required-publication-permissions) is the default logical decoding plugin used for Online migration. If source PostgreSQL version <10, **test_decoding** plugin is used.
33+
> - **test_decoding** receives WAL through the logical decoding mechanism and decodes it into text representations of the operations performed.
34+
> - In Google AlloyDB for PostgreSQL, the test_decoding plugin is preinstalled and ready for logical replication. This allows you to easily set up logical replication slots and stream WAL changes, facilitating use cases such as change data capture (CDC) or replication to external systems.
35+
> - For more information about the test-decoding plugin, see the [PostgreSQL documentation](https://www.postgresql.org/docs/16/test-decoding.html)
3736
3837
### Configure target setup
3938

@@ -43,7 +42,7 @@ If the source PostgreSQL version is less than 9.5, upgrade it to 9.5 or higher b
4342

4443
### Enable CDC as a source
4544

46-
- `test_decoding` logical decoding plugin captures the changed records from the source.
45+
- Logical decoding plugin captures the changed records from the source.
4746
- To ensure the migration user has the necessary replication privileges, execute the following SQL command:
4847

4948
```sql

articles/postgresql/migrate/migration-service/includes/aurora/prerequisites-migration-service-postgresql-online-aurora.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,6 @@ ms.topic: include
1212
Before you start a migration by using the migration service in Azure Database for PostgreSQL, it's important to complete the following prerequisites. These prerequisites are specifically designed for online migration scenarios.
1313

1414
- [Verify the source version](#verify-the-source-version)
15-
- [Install test_decoding for source setup](#install-test_decoding-for-source-setup)
1615
- [Configure the target setup](#configure-the-target-setup)
1716
- [Enable CDC as a source](#enable-cdc-as-a-source)
1817
- [Configure the network setup](#configure-the-network-setup)
@@ -24,10 +23,11 @@ Before you start a migration by using the migration service in Azure Database fo
2423

2524
The source PostgreSQL server version must be 9.5 or later. If the source PostgreSQL version is earlier than 9.5, upgrade the version to 9.5 or later before you start the migration.
2625

27-
### Install test_decoding for source setup
28-
29-
- The test_decoding plugin receives Write-Ahead Logging (WAL) through the logical decoding mechanism. The plugin decodes WAL into text representations of the operations that are performed.
30-
- In Amazon RDS for PostgreSQL, the test_decoding plugin is preinstalled and ready for logical replication. You can easily set up logical replication slots and stream WAL changes, for example, for change data capture (CDC) or for replication to external systems.
26+
> [!NOTE]
27+
> - [PgOutput](../../concepts-required-user-permissions.md#online-migration-using-pgoutput---required-publication-permissions) is the default logical decoding plugin used for Online migration. If source PostgreSQL version <10, **test_decoding** plugin is used.
28+
> - **test_decoding** receives WAL through the logical decoding mechanism and decodes it into text representations of the operations performed.
29+
> - In Amazon RDS for PostgreSQL, the test_decoding plugin is preinstalled and ready for logical replication. You can easily set up logical replication slots and stream WAL changes, for example, for change data capture (CDC) or for replication to external systems.
30+
> - For more information about the test-decoding plugin, see the [PostgreSQL documentation](https://www.postgresql.org/docs/16/test-decoding.html)
3131
3232
For more information about the test_decoding plugin, see the [PostgreSQL documentation](https://www.postgresql.org/docs/16/test-decoding.html).
3333

@@ -39,7 +39,7 @@ For more information, see [Create an Azure Database for PostgreSQL flexible serv
3939

4040
### Enable CDC as a source
4141

42-
- The test_decoding logical decoding plugin captures the changed records from the source.
42+
- Logical decoding plugin captures the changed records from the source.
4343
- To allow the migration user to access replication permissions, execute the following command:
4444

4545
```bash

articles/postgresql/migrate/migration-service/includes/cloud-sql/prerequisites-migration-service-postgresql-online-cloud-sql.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,6 @@ ms.topic: include
1212
Before starting the migration with the Azure Database for PostgreSQL migration service, it's important to fulfill the following prerequisites, specifically designed for online migration scenarios.
1313

1414
- [Verify the source version](#verify-the-source-version)
15-
- [Install test_decoding - Source Setup](#install-test_decoding---source-setup)
1615
- [Configure target setup](#configure-target-setup)
1716
- [Enable CDC as a source](#enable-cdc-as-a-source)
1817
- [Configure network setup](#configure-network-setup)
@@ -29,11 +28,11 @@ If the source PostgreSQL version is less than 9.5, upgrade it to 9.5 or higher b
2928
> [!NOTE]
3029
> The migration service in Azure Database for PostgreSQL supports connections using the IP address for source Google Cloud SQL for PostgreSQL. The format `myproject:myregion:myinstance` isn't supported.
3130
32-
### Install test_decoding - source setup
33-
34-
- **test_decoding** receives WAL through the logical decoding mechanism and decodes it into text representations of the operations performed.
35-
- In Google Cloud SQL for PostgreSQL, the test_decoding plugin is preinstalled and ready for logical replication. This allows you to easily set up logical replication slots and stream WAL changes, facilitating use cases such as change data capture (CDC) or replication to external systems.
36-
- For more information about the test-decoding plugin, see the [PostgreSQL documentation](https://www.postgresql.org/docs/16/test-decoding.html)
31+
> [!NOTE]
32+
> - [PgOutput](../../concepts-required-user-permissions.md#online-migration-using-pgoutput---required-publication-permissions) is the default logical decoding plugin used for Online migration. If source PostgreSQL version <10, **test_decoding** plugin is used.
33+
> - **test_decoding** receives WAL through the logical decoding mechanism and decodes it into text representations of the operations performed.
34+
> - In Google Cloud SQL for PostgreSQL, the test_decoding plugin is preinstalled and ready for logical replication. This allows you to easily set up logical replication slots and stream WAL changes, facilitating use cases such as change data capture (CDC) or replication to external systems.
35+
> - For more information about the test-decoding plugin, see the [PostgreSQL documentation](https://www.postgresql.org/docs/16/test-decoding.html)
3736
3837
### Configure target setup
3938

@@ -43,7 +42,7 @@ If the source PostgreSQL version is less than 9.5, upgrade it to 9.5 or higher b
4342

4443
### Enable CDC as a source
4544

46-
- `test_decoding` logical decoding plugin captures the changed records from the source.
45+
- Logical decoding plugin captures the changed records from the source.
4746
- To ensure the migration user has the necessary replication privileges, execute the following SQL command:
4847

4948
```sql

articles/postgresql/migrate/migration-service/includes/enterprise-db/prerequisites-migration-service-postgresql-online-enterprise-db-extended-server.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,6 @@ ms.topic: include
1212
Before starting the migration with the Azure Database for PostgreSQL migration service, it's important to fulfill the following prerequisites, specifically designed for online migration scenarios.
1313

1414
- [Verify the source version](#verify-the-source-version)
15-
- [Install test_decoding - Source Setup](#install-test_decoding---source-setup)
1615
- [Configure target setup](#configure-target-setup)
1716
- [Enable CDC as a source](#enable-cdc-as-a-source)
1817
- [Configure network setup](#configure-network-setup)
@@ -26,11 +25,11 @@ The source PostgreSQL server version must be 9.5 or later.
2625

2726
If the source PostgreSQL version is less than 9.5, upgrade it to 9.5 or higher before you start the migration.
2827

29-
### Install test_decoding - source setup
30-
31-
- **test_decoding** receives WAL through the logical decoding mechanism and decodes it into text representations of the operations performed.
32-
- In EDB Extended server, the test_decoding plugin is preinstalled and ready for logical replication. This allows you to easily set up logical replication slots and stream WAL changes, facilitating use cases such as change data capture (CDC) or replication to external systems.
33-
- For more information about the test-decoding plugin, see the [PostgreSQL documentation](https://www.postgresql.org/docs/16/test-decoding.html)
28+
> [!NOTE]
29+
> - [PgOutput](../../concepts-required-user-permissions.md#online-migration-using-pgoutput---required-publication-permissions) is the default logical decoding plugin used for Online migration. If source PostgreSQL version <10, **test_decoding** plugin is used.
30+
> - **test_decoding** receives WAL through the logical decoding mechanism and decodes it into text representations of the operations performed.
31+
> - In EDB Extended server, the test_decoding plugin is preinstalled and ready for logical replication. This allows you to easily set up logical replication slots and stream WAL changes, facilitating use cases such as change data capture (CDC) or replication to external systems.
32+
> - For more information about the test-decoding plugin, see the [PostgreSQL documentation](https://www.postgresql.org/docs/16/test-decoding.html)
3433
3534
### Configure target setup
3635

@@ -40,7 +39,7 @@ If the source PostgreSQL version is less than 9.5, upgrade it to 9.5 or higher b
4039

4140
### Enable CDC as a source
4241

43-
- `test_decoding` logical decoding plugin captures the changed records from the source.
42+
- Logical decoding plugin captures the changed records from the source.
4443
- To ensure the migration user has the necessary replication privileges, execute the following SQL command:
4544

4645
```sql

articles/postgresql/migrate/migration-service/includes/iaas/prerequisites-migration-service-postgresql-online-iaas.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,6 @@ ms.topic: include
1212
Before starting the migration with the Azure Database for PostgreSQL migration service, it's important to fulfill the following prerequisites, specifically designed for online migration scenarios.
1313

1414
- [Verify the source version](#verify-the-source-version)
15-
- [Install test_decoding - Source Setup](#install-test_decoding---source-setup)
1615
- [Configure target setup](#configure-target-setup)
1716
- [Enable CDC as a source](#enable-cdc-as-a-source)
1817
- [Configure network setup](#configure-network-setup)
@@ -27,9 +26,9 @@ The source PostgreSQL server version must be 9.5 or later.
2726

2827
If the source PostgreSQL version is less than 9.5, upgrade it to 9.5 or higher before you start the migration.
2928

30-
### Install test_decoding - Source Setup
31-
32-
- **test_decoding** receives WAL through the logical decoding mechanism and decodes it into text representations of the operations performed.
29+
> [!NOTE]
30+
> - [PgOutput](../../concepts-required-user-permissions.md#online-migration-using-pgoutput---required-publication-permissions) is the default logical decoding plugin used for Online migration. If source PostgreSQL version <10, **test_decoding** plugin is used.
31+
> - **test_decoding** receives WAL through the logical decoding mechanism and decodes it into text representations of the operations performed.
3332
3433
- For more information about the test-decoding plugin, see the [PostgreSQL documentation](https://www.postgresql.org/docs/16/test-decoding.html).
3534

@@ -43,7 +42,7 @@ When migrating across PostgreSQL versions (major or minor), ensure compatibility
4342

4443
### Enable CDC as a source
4544

46-
- `test_decoding` logical decoding plugin captures the changed records from the source.
45+
- Logical decoding plugin captures the changed records from the source.
4746
- In the source PostgreSQL instance, set the following parameters and values in the postgresql.conf configuration file:
4847
- Set `wal_level` to `logical`.
4948
- Set `max_replication_slots` to a value greater than 1. Should be greater than the number of databases selected for migration.

articles/postgresql/migrate/migration-service/includes/rds/prerequisites-migration-service-postgresql-online-rds.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,6 @@ ms.topic: include
1212
Before starting the migration with the Azure Database for PostgreSQL migration service, it is important to fulfill the following prerequisites, specifically designed for online migration scenarios.
1313

1414
- [Verify the source version](#verify-the-source-version)
15-
- [Install test_decoding - Source Setup](#install-test_decoding---source-setup)
1615
- [Configure target setup](#configure-target-setup)
1716
- [Enable CDC as a source](#enable-cdc-as-a-source)
1817
- [Configure network setup](#configure-network-setup)
@@ -26,11 +25,11 @@ The source PostgreSQL server version must be 9.5 or later.
2625

2726
If the source PostgreSQL version is less than 9.5, upgrade it to 9.5 or higher before you start the migration.
2827

29-
### Install test_decoding - Source Setup
30-
31-
- **test_decoding** receives WAL through the logical decoding mechanism and decodes it into text representations of the operations performed.
32-
- In Amazon RDS for PostgreSQL, the test_decoding plugin is preinstalled and ready for logical replication. This allows you to easily set up logical replication slots and stream WAL changes, facilitating use cases such as change data capture (CDC) or replication to external systems.
33-
- For more information about the test-decoding plugin, see the [PostgreSQL documentation](https://www.postgresql.org/docs/16/test-decoding.html)
28+
> [!NOTE]
29+
> - [PgOutput](../../concepts-required-user-permissions.md#online-migration-using-pgoutput---required-publication-permissions) is the default logical decoding plugin used for Online migration. If source PostgreSQL version <10, **test_decoding** plugin is used.
30+
> - **test_decoding** receives WAL through the logical decoding mechanism and decodes it into text representations of the operations performed.
31+
> - In Amazon RDS for PostgreSQL, the test_decoding plugin is preinstalled and ready for logical replication. This allows you to easily set up logical replication slots and stream WAL changes, facilitating use cases such as change data capture (CDC) or replication to external systems.
32+
> - For more information about the test-decoding plugin, see the [PostgreSQL documentation](https://www.postgresql.org/docs/16/test-decoding.html)
3433
3534
### Configure target setup
3635

@@ -40,7 +39,7 @@ If the source PostgreSQL version is less than 9.5, upgrade it to 9.5 or higher b
4039

4140
### Enable CDC as a source
4241

43-
- `test_decoding` logical decoding plugin captures the changed records from the source.
42+
- Logical decoding plugin captures the changed records from the source.
4443
- To allow the migration user to access replication privileges, execute the following command:
4544

4645
```bash

0 commit comments

Comments
 (0)