Skip to content

Commit df3405b

Browse files
markingmynamemarkingmyname
committed
changes made
1 parent 625cbef commit df3405b

File tree

1 file changed

+26
-26
lines changed

1 file changed

+26
-26
lines changed

‎articles/postgresql/migrate/migration-service/troubleshoot-error-codes-premigration.md

Lines changed: 26 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -17,35 +17,35 @@ This article contains error message numbers and their description for premigrati
1717

1818
The following tables provide a comprehensive list of error codes for the migration service feature in Azure Database for PostgreSQL. These error codes help you troubleshoot and resolve issues during the migration process. Each error code has an error message and other details that provide further context and guidance for resolving the issue.
1919

20-
| Error Code | Error message | Details | Resolution |
21-
| --- | --- | --- | --- |
22-
| 603000 | Connection failed. | Connection to the server `{0}` was unsuccessful. Ensure that the source server is reachable from the target or runtime server. | Refer to https://aka.ms/postgres-migrations-networking-faq for debugging connectivity issues. |
23-
| 603001 | SSL Configuration Error | The server `{0}` doesn't support SSL.Check SSL settings. Set SSL mode to *prefer* and retry the migration. | Refer to https://aka.ms/postgres-migrations-networking-faq for debugging connectivity issues. |
24-
| 603100 | Authentication failed. | The password for server `{0}` is incorrect. Enter the correct password and retry the migration. | N/A |
25-
| 603101 | Database exists in target | Database `{0}` exists on the target server. Ensure the target server doesn't have the database and retry the migration. | |
26-
| 603102 | Source Database Missing | Database `{0}` doesn't exist on the source server. Provide a valid database and retry the migration. | |
27-
| 603103 | Missing Microsoft Entra role. | Microsoft Entra role `{0}` is missing on the target server. Create the Entra role and retry the migration. | |
28-
| 603104 | Missing Replication Role. | User `{0}` doesn't have the replication role on server `{1}`. Grant the replication role before retrying migration. | |
29-
| 603105 | GUC Settings Error | Insufficient replication slots on the source server for migration. Increase the 'max_replication_slots' GUC parameter to `{0}` or higher. | Use this query `SELECT * FROM pg_replication_slots WHERE active = false AND slot_type = 'logical';` to get the list of inactive replication slots and drop them using `SELECT pg_drop_replication_slot('slot_name');` before initiating the migration. Alternatively, set the 'max_replication_slots' server parameter to `{0}` or higher. Ensure that the 'max_wal_senders' parameter is also changed to be greater than or equal to the 'max_replication_slots' parameter. |
30-
| 603106 | GUC Settings Error | The 'max_wal_senders' GUC parameter is set to `{0}`. Ensure it matches or exceeds the 'max_replication_slots' value. | |
31-
| 603107 | GUC Settings Error | Source server WAL level parameter is set to `{0}`. Set GUC parameter WAL level to be 'logical'. | |
32-
| 603108 | Extensions allowlist required. | Extensions `{0}` couldn't be installed on the target server because they're not allowlisted. Allowlist the extensions and retry the migration. | |
33-
| 603109 | Shared preload libraries configuration error. | Add allowlisted extensions `{0}` to 'shared_preload_libraries' on the target server and retry the migration. | change triggers a restart of the server. |
34-
| 603400 | Unsupported source version | Migration of PostgreSQL versions below `{0}` is unsupported. | https://aka.ms/DumpandRestore |
35-
| 603401 | Collation mismatch. | Collation `{0}` in database `{1}` isn't present on target server. | |
36-
| 603402 | Collation mismatch. | Collation `{0}` for table `{1}` in column `{2}` isn't present on target server. | Contact Microsoft support to add the necessary collations. |
37-
| 603403 | Collation mismatch. | Source database contains user-defined collations. Drop these collations and retry the migration. | |
38-
| 603404 | Unsupported OIDs Detected | Tables with 'WITH OIDs' detected in database `{0}`. They aren't supported in PostgreSQL version 12 and later. | For more details, refer to this link: https://www.postgresql.org/docs/release/12.0. |
39-
| 603405 | Unsupported Extensions | The migration service doesn't support the migration of databases with `{0}` extensions on the target server. | |
40-
| 603406 | Unsupported Extensions | Target PostgreSQL `{0}` supports POSTGIS version 3.2.3, which is incompatible with source's `{1}`. | Recommend target server upgrade to version 11.For more information on the breaking changes, visit this link: https://git.osgeo.org/gitea/postgis/postgis/raw/tag/3.4.1/NEWS. |
41-
| 603407 | Extension Schema Error | Extensions `{0}` located in the system schema on the source server are unsupported on the target server. Drop and recreate the extensions in a nonsystem schema, then retry the migration. | |
42-
| 603408 | Unsupported Extensions | Target server version 16 doesn't support `{0}` extensions. Migrate to version 15 or lower, then upgrade once the extensions are supported. | |
43-
| 603409 | User-defined casts present. | Source database `{0}` contains user-defined casts that can't be migrated to the target server. | |
44-
| 603410 | System table permission error. | Users have access to system tables like pg_authid and pg_shadow that can't be migrated to the target. Revoke these permissions and retry the migration. | Validates for default permissions given to pg_catalog tables/views(pg_authid, pg_shadow etc.) which aren't allowed to be given on target. Refer to the following link for potential workarounds: https://aka.ms/troubleshooting-user-roles-permission-ownerships-issues. User `{1}` has `{2}` permissions, and user `{3}` has `{4}` permissions. |
20+
| Error Code | Error message | Resolution |
21+
| --- | --- | --- |
22+
| 603000 | Connection failed. Connection to the server `{serverName}` was unsuccessful. Ensure that the source server is reachable from the target or runtime server. | Refer to [Network guide](how-to-network-setup-migration-service.md) for debugging connectivity issues. |
23+
| 603001 | SSL Configuration Error. The server `{serverName}` doesn't support SSL. Check SSL settings. Set SSL mode to *prefer* and retry the migration. | Refer to [Network guide](how-to-network-setup-migration-service.md) for debugging connectivity issues. |
24+
| 603100 | Authentication failed. The password for server `{serverName}` is incorrect. Enter the correct password and retry the migration. | N/A |
25+
| 603101 | Database exists in target. Database `{dbName}` exists on the target server. Ensure the target server doesn't have the database and retry the migration. | N/A |
26+
| 603102 | Source Database Missing. Database `{dbName}` doesn't exist on the source server. Provide a valid database and retry the migration. | N/A |
27+
| 603103 | Missing Microsoft Entra role. Microsoft Entra role `{roleNames}` is missing on the target server. Create the Entra role and retry the migration. | N/A |
28+
| 603104 | Missing Replication Role. User `{0}` doesn't have the replication role on server `{1}`. Grant the replication role before retrying migration. | Use `ALTER ROLE {0} WITH REPLICATION;` to grant the required permission. |
29+
| 603105 | GUC Settings Error. Insufficient replication slots on the source server for migration. Increase the `max_replication_slots` GUC parameter to `{0}` or higher. | Source server doesn't have sufficient replication slots available to perform online migration. Use this query `SELECT * FROM pg_replication_slots WHERE active = false AND slot_type = 'logical';` to get the list of inactive replication slots and drop them using `SELECT pg_drop_replication_slot('slot_name');` before initiating the migration. Alternatively, set the 'max_replication_slots' server parameter to `{0}` or higher. Ensure that the `max_wal_senders` parameter is also changed to be greater than or equal to the `max_replication_slots' parameter`. |
30+
| 603106 | GUC Settings Error. The `max_wal_senders` GUC parameter is set to `{0}`. Ensure it matches or exceeds the 'max_replication_slots' value. | N/A |
31+
| 603107 | GUC Settings Error. Source server WAL level parameter is set to `{0}`. Set GUC parameter WAL level to be 'logical'. | N/A |
32+
| 603108 | Extensions allowlist required. Extensions `{0}` couldn't be installed on the target server because they're not allowlisted. Allowlist the extensions and retry the migration. | Set the allowlist by following the steps mentioned in [PostgreSQL extensions](https://aka.ms/allowlist-extensions). |
33+
| 603109 | Shared preload libraries configuration error. Add allowlisted extensions `{0}` to 'shared_preload_libraries' on the target server and retry the migration. | Set the shared preload libraries by following the steps mentioned in [PostgreSQL extensions](https://aka.ms/allowlist-extensions). This requires a server restart. |
34+
| 603400 | Unsupported source version. Migration of PostgreSQL versions below `{0}` is unsupported. | You must use another migration method. |
35+
| 603401 | Collation mismatch. Collation `{0}` in database `{1}` isn't present on target server. | N/A |
36+
| 603402 | Collation mismatch. Collation `{0}` for table `{1}` in column `{2}` isn't present on target server. | [Contact Microsoft support](https://support.microsoft.com/contactus) to add the necessary collations. |
37+
| 603403 | Collation mismatch. Source database contains user-defined collations. Drop these collations and retry the migration. | N/A |
38+
| 603404 | Unsupported OIDs Detected. Tables with 'WITH OIDs' detected in database `{0}`. They aren't supported in PostgreSQL version 12 and later. | Visit [PostgreSQL release notes](https://www.postgresql.org/docs/release/12.0). |
39+
| 603405 | Unsupported Extensions. The migration service doesn't support the migration of databases with `{0}` extensions on the target server. | N/A |
40+
| 603406 | Unsupported Extensions. Target PostgreSQL `{0}` supports POSTGIS version 3.2.3, which is incompatible with source's `{1}`. | Recommend target server upgrade to version 11. Visit [PostGIS breaking changes](https://git.osgeo.org/gitea/postgis/postgis/raw/tag/3.4.1/NEWS). |
41+
| 603407 | Extension Schema Error. Extensions `{0}` located in the system schema on the source server are unsupported on the target server. Drop and recreate the extensions in a nonsystem schema, then retry the migration. | Visit [PostgreSQL extensions](../../flexible-server/concepts-extensions.md). |
42+
| 603408 | Unsupported Extensions. Target server version 16 doesn't support `{0}` extensions. Migrate to version 15 or lower, then upgrade once the extensions are supported. | N/A |
43+
| 603409 | User-defined casts present. Source database `{0}` contains user-defined casts that can't be migrated to the target server. | N/A |
44+
| 603410 | System table permission error. Users have access to system tables like pg_authid and pg_shadow that can't be migrated to the target. Revoke these permissions and retry the migration. | Validating the default permissions granted to `pg_catalog` tables/views (such as `pg_authid` and `pg_shadow`) is essential. However, these permissions can't be assigned to the target. Specifically, User `{1}` possesses `{2}` permissions, while User `{3}` holds `{4}` permissions. For a workaround, visit https://aka.ms/troubleshooting-user-roles-permission-ownerships-issues. |
4545

4646
## Related content
4747

48-
- [Troubleshoot the migration service for Azure Database for PostgreSQL](https://aka.ms/postgres-migrations-networking-faq)
48+
- [Troubleshoot the migration service for Azure Database for PostgreSQL](how-to-network-setup-migration-service.md))
4949
- [Best practices for seamless migration into Azure Database for PostgreSQL](best-practices-migration-service-postgresql.md)
5050
- [Networking](how-to-network-setup-migration-service.md)
5151
- [Known issues and limitations](concepts-known-issues-migration-service.md)

0 commit comments

Comments
 (0)