You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/postgresql/flexible-server/concepts-major-version-upgrade.md
+18-17Lines changed: 18 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,6 +7,7 @@ ms.reviewer: rajsell
7
7
ms.date: 02/08/2023
8
8
ms.service: postgresql
9
9
ms.subservice: flexible-server
10
+
ms.custom: references_regions
10
11
ms.topic: conceptual
11
12
---
12
13
@@ -25,42 +26,42 @@ Azure Database for PostgreSQL Flexible Server Postgres has now introduced in-pla
25
26
26
27
Here are some of the important considerations with in-place major version upgrade.
27
28
28
-
• During in-place major version upgrade process, Flexible Server runs a pre-check procedure to identify any potential issues that might cause the upgrade to fail. If the pre-check finds any incompatibilities, it creates a log event showing that the upgrade pre-check failed, along with an error message.
29
+
-During in-place major version upgrade process, Flexible Server runs a pre-check procedure to identify any potential issues that might cause the upgrade to fail. If the pre-check finds any incompatibilities, it creates a log event showing that the upgrade pre-check failed, along with an error message.
29
30
30
-
• If the pre-check is successful, then Flexible Server stops the service and takes an implicit backup just before starting the upgrade. This backup can be used to restore the database instance to its previous version if there's an upgrade error.
31
+
-If the pre-check is successful, then Flexible Server stops the service and takes an implicit backup just before starting the upgrade. This backup can be used to restore the database instance to its previous version if there's an upgrade error.
31
32
32
-
• Flexible Server uses **pg_upgrade** utility to perform in-place major version upgrades and provides the flexibility to skip versions and upgrade directly to higher versions.
33
+
-Flexible Server uses **pg_upgrade** utility to perform in-place major version upgrades and provides the flexibility to skip versions and upgrade directly to higher versions.
33
34
34
-
• During an in-place major version upgrade of a High Availability (HA) enabled server, the service disables HA, performs the upgrade on the primary server, and then re-enables HA after the upgrade is complete.
35
+
- During an in-place major version upgrade of a High Availability (HA) enabled server, the service disables HA, performs the upgrade on the primary server, and then re-enables HA after the upgrade is complete.
35
36
36
-
• Most extensions are automatically upgraded to higher versions during an in-place major version upgrade, with some exceptions. Refer **limitations** section for more details.
37
+
- Most extensions are automatically upgraded to higher versions during an in-place major version upgrade, with some exceptions. Refer **limitations** section for more details.
37
38
38
-
• In-place major version upgrade process for Flexible server automatically deploys the latest supported minor version.
39
+
- In-place major version upgrade process for Flexible server automatically deploys the latest supported minor version.
39
40
40
-
• In-place major version upgrade process is an offline operation and it involves a short downtime.
41
+
- In-place major version upgrade process is an offline operation and it involves a short downtime.
41
42
42
-
• Long-running transactions or high workload before the upgrade might increase the time taken to shut down the database and increase upgrade time.
43
+
- Long-running transactions or high workload before the upgrade might increase the time taken to shut down the database and increase upgrade time.
43
44
44
-
• If an in-place major version upgrade fails, the service restores the server to its previous state using a backup taken as part of step 2.
45
+
- If an in-place major version upgrade fails, the service restores the server to its previous state using a backup taken as part of step 2.
45
46
46
-
• Once the in-place major version upgrade is successful, there are no automated ways to revert to the earlier version. However, you can perform a Point-In-Time Recovery (PITR) to a time prior to the upgrade to restore the previous version of the database instance.
47
+
- Once the in-place major version upgrade is successful, there are no automated ways to revert to the earlier version. However, you can perform a Point-In-Time Recovery (PITR) to a time prior to the upgrade to restore the previous version of the database instance.
47
48
48
49
## Limitations:
49
50
50
51
During preview, if in-place major version upgrade pre-check operations fail then it aborts with a detailed error message for all the below limitations.
51
52
52
-
• In-place major version upgrade currently doesn't support read replicas, so if you have a read replica enabled server, you need to delete the replica before performing the upgrade on the primary server. After the upgrade, you can recreate the replica.
53
+
-In-place major version upgrade currently doesn't support read replicas, so if you have a read replica enabled server, you need to delete the replica before performing the upgrade on the primary server. After the upgrade, you can recreate the replica.
53
54
54
-
• In-place major version upgrade doesn't support certain extensions and there are some limitations to upgrading certain extensions. The extensions **Timescaledb**, **pgaudit**, **dblink**, and **postgres_fdw** are unsupported for all PostgreSQL versions during preview.
55
+
-In-place major version upgrade doesn't support certain extensions and there are some limitations to upgrading certain extensions. The extensions **Timescaledb**, **pgaudit**, **dblink**, and **postgres_fdw** are unsupported for all PostgreSQL versions during preview.
55
56
56
-
• Upgrading the **PostGIS** extension is currently unsupported from PostgreSQL 12, while upgrading the **orafce** extension is unsupported from PostgreSQL 11. All other versions of these extensions are supported for in-place major version upgrade.
57
+
- Upgrading the **PostGIS** extension is currently unsupported from PostgreSQL 12, while upgrading the **orafce** extension is unsupported from PostgreSQL 11. All other versions of these extensions are supported for in-place major version upgrade.
57
58
58
-
• During preview, in-place major version upgrade is currently available in the following regions.
59
+
- During preview, in-place major version upgrade is currently available in the following regions.
59
60
Australia East / Australia Southeast/ Canada East/ China North 3/China East 3/ East Asia / East US / France South / India Central / India South /Japan East /Jio India West /Korea Central / Norway East/ North Europe/South Central US /Sweden Central /Switzerland North /Switzerland West /UAE north /West Central US/ West US / West US3/ Qatar Central
60
61
61
-
• Servers configured with logical replication slots aren't supported.
62
+
- Servers configured with logical replication slots aren't supported.
62
63
63
-
• MVU is currently not supported for PgBouncer enabled servers.
64
+
- MVU is currently not supported for PgBouncer enabled servers.
64
65
65
66
66
67
## How to Perform in-place major version upgrade:
@@ -132,7 +133,7 @@ Run the **ANALYZE** operation to refresh the pg_statistic table. You should do t
132
133
ANALYZE VERBOSE
133
134
```
134
135
> [!NOTE]
135
-
136
+
>
136
137
> The VERBOSE flag is optional, but using it shows you the progress.
0 commit comments