Upgrade Azure Arc-enabled data services
This article describes the paths and options to upgrade Azure Arc-enabled data controller and data services.
Supported versions
Each release contains an image tag. Use the image tag to identify when Microsoft released the component. Microsoft supports the component for one full year after the release.
Identify your current version by image tag. The image tag version scheme is:
<Major>.<Minor>.<optional:revision>_<date>
.<date>
identifies the year, month, and day of the release. The pattern is: YYYY-MM-DD.
For example, a complete image tag for the release in June 2022 is: v1.8.0_2022-06-06
.
The example image released on June 6, 2022.
Microsoft supports this release through June 5, 2023.
Note
The latest current branch version is always in the Full Support servicing phase. This support statement means that if you encounter a code defect that warrants a critical update, you must have the latest current branch version installed in order to receive a fix.
Upgrade path
Upgrades are limited to the next incremental minor or major version. For example:
- Supported version upgrades:
- 1.1 -> 1.2
- 1.3 -> 2.0
- Unsupported version upgrades:
- 1.1 -> 1.4 Not supported because one or more minor versions are skipped.
Upgrade order
Upgrade the data controller before you upgrade any data service. SQL Managed Instance enabled by Azure Arc is an example of a data service.
A data controller may be up to one version ahead of a data service. A data service major version may not be one version ahead, or more than one version behind a data controller.
The following list displays supported and unsupported configurations, based on image tag.
Supported configurations.
- Data controller and data service at same version:
- Data controller:
v1.9.0_2022-07-12
- Data service:
v1.9.0_2022-07-12
- Data controller:
- Data controller ahead of data service by one version:
- Data controller:
v1.9.0_2022-07-12
- Data service:
v1.8.0_2022-06-14
- Data controller:
- Data controller and data service at same version:
Unsupported configurations:
- Data controller behind data service:
- Data controller:
v1.8.0_2022-06-14
- Data service:
v1.9.0_2022-07-12
- Data controller:
- Data controller ahead of data service by more than one version:
- Data controller:
v1.9.0_2022-07-12
- Data service:
v1.6.0_2022-05-02
- Data controller:
- Data controller behind data service:
Schedule maintenance
The upgrade will cause a service interruption (downtime).
The amount of time to upgrade the data service depends on the service tier.
The data controller upgrade does not cause application downtime.
- General Purpose: A single replica is not available during the upgrade.
- Business Critical: A SQL managed instance incurs a brief service interruption (downtime) once during an upgrade. After the data controller upgrades a secondary replica, the service fails over to an upgraded replica. The controller then upgrades the previous primary replica.
Tip
Upgrade the data services during scheduled maintenance time.
Automatic upgrades
When a SQL managed instance desiredVersion
is set to auto
, the data controller will automatically upgrade the managed instance.