Skip to content

Commit 1cc078e

Browse files
committed
June 2025 Arc SQL Server release
1 parent a77652e commit 1cc078e

13 files changed

+260
-447
lines changed

docs/sql-server/azure-arc/backup-local.md

Lines changed: 34 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,21 @@
11
---
2-
title: Manage automated backups
2+
title: Manage Automated Backups
33
description: Describes how to configure automated backups to local storage for SQL Server enabled by Azure Arc
44
author: AbdullahMSFT
5-
ms.author: amamun
5+
ms.author: amamun
66
ms.reviewer: mikeray, randolphwest
7-
ms.date: 07/30/2024
7+
ms.date: 06/30/2025
88
ms.topic: how-to
9-
ms.custom: ignite-2023, devx-track-azurecli
9+
ms.custom:
10+
- ignite-2023
11+
- devx-track-azurecli
1012
---
1113

1214
# Manage automated backups (preview) | SQL Server enabled by Azure Arc
1315

1416
[!INCLUDE [sqlserver](../../includes/applies-to-version/sqlserver.md)]
1517

16-
The Azure extension for [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] can perform backups automatically to local storage or network shares. Backups are written to the [default backup location](../../relational-databases/backup-restore/backup-devices-sql-server.md#BackupFileDiskPath) for the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] enabled by Azure Arc instance.
18+
The Azure extension for [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] can perform backups automatically to local storage or network shares. Backups are written to the [default backup location](../../relational-databases/backup-restore/backup-devices-sql-server.md#BackupFileDiskPath) for the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] enabled by Azure Arc instance.
1719

1820
This article explains how you can:
1921

@@ -52,20 +54,20 @@ You can also run backups on a **default** schedule:
5254

5355
The following lists the levels of support for backup schedules:
5456

55-
- Instance level backups with a default schedule (available starting with [extension version 1.1.2284.7](release-notes.md#april-10-2023))
56-
- Instance level backups with support for custom schedule (available starting with [extension version 1.1.2504.99](release-notes.md#november-14-2023))
57-
- Database level backups with support for custom schedule (available starting with [extension version 1.1.2594.118](release-notes.md#march-12-2024))
57+
- Instance level backups with a default schedule
58+
- Instance level backups with support for custom schedule
59+
- Database level backups with support for custom schedule
5860

5961
If both database and instance level backup schedule is set, database level schedule takes precedence over the instance level backup schedule. If you delete the database level backup schedule, the instance level backup schedule applies.
6062

6163
## Assign permissions
6264

6365
The backup service within the Azure extension for Arc-enabled SQL Server uses [NT AUTHORITY\SYSTEM] account to perform the backups. If you're [operating SQL Server enabled by Arc with least privilege](configure-least-privilege.md), A local Windows account - [NT Service\SQLServerExtension] - performs the backup.
6466

65-
> [!NOTE]
67+
> [!NOTE]
6668
> [!INCLUDE [least-privilege-default](includes/least-privilege-default.md)]
6769
68-
If you use Azure extension for SQL Server [version 1.1.2504.99](release-notes.md#november-14-2023) or later, the necessary permissions are granted to [NT AUTHORITY\SYSTEM] automatically. You don't need to assign permissions manually.
70+
If you use Azure extension for SQL Server version 1.1.2504.99 or later, the necessary permissions are granted to [NT AUTHORITY\SYSTEM] automatically. You don't need to assign permissions manually.
6971

7072
**For earlier extensions only**, follow the below steps to assign permission to [NT AUTHORITY\SYSTEM] account.
7173

@@ -102,7 +104,7 @@ Automated backups are disabled by default.
102104

103105
After you assigned permissions, you can schedule automated backups. After the automated backups are configured, the Azure Extension for SQL Server initiates a backup to the default backup location.
104106

105-
The backups are native SQL Server backups, so all backup history is available in the backup related tables in themsdbdatabase.
107+
The backups are native SQL Server backups, so all backup history is available in the backup related tables in the `msdb` database.
106108

107109
### Instance level
108110

@@ -137,10 +139,10 @@ To enable automated backups using `az` CLI:
137139
**Default schedule**
138140

139141
```azurecli
140-
az sql server-arc backups-policy set --name <arc-server-name> --resource-group <resourcegroup> --default-policy
142+
az sql server-arc backups-policy set --name <arc-server-name> --resource-group <resourcegroup> --default-policy
141143
```
142144
143-
> [!NOTE]
145+
> [!NOTE]
144146
> Examples in this article use `<arc-server-name>` to identify the server name, as follows:
145147
>
146148
> - Default instance, replace: `<arc-server-name>` with the server name.
@@ -164,7 +166,7 @@ To enable automated backups using `az` CLI:
164166
az sql server-arc backups-policy set --name MyArcServer_SQLServerPROD --resource-group MyResourceGroup --retention-days 24 --full-backup-days 7 --diff-backup-hours 24 --tlog-backup-mins 30
165167
```
166168
167-
> [!NOTE]
169+
> [!NOTE]
168170
> If the backup retention day is set to 0, automated backup is disabled and no backups are taken.
169171
170172
---
@@ -192,30 +194,30 @@ Set retention period and frequency to meet business requirements. The retention
192194
To enable automated backups on a database level using az CLI:
193195
194196
1. Disable any existing backup routines.
195-
2. If necessary, add the arcdata extension:
197+
1. If necessary, add the arcdata extension:
196198
197199
```azurecli
198-
az extension add --name arcdata
200+
az extension add --name arcdata
199201
```
200202

201-
1. Configure either the default schedule or a custom schedule:
203+
1. Configure either the default schedule or a custom schedule:
202204

203205
**Default schedule**
204206

205207
```azurecli
206-
az sql db-arc backups-policy set --name <sql-database-name> --server <arc-server-name> --resource-group <resourcegroup> --default-policy
208+
az sql db-arc backups-policy set --name <sql-database-name> --server <arc-server-name> --resource-group <resourcegroup> --default-policy
207209
```
208210
209211
Example:
210212
211213
```azurecli
212-
az sql db-arc backups-policy set --name MyDatabaseName--server MyArcServer_SQLServerPROD --resource-group MyResourceGroup --default-policy
214+
az sql db-arc backups-policy set --name MyDatabaseName--server MyArcServer_SQLServerPROD --resource-group MyResourceGroup --default-policy
213215
```
214216
215217
**Custom schedule**
216218
217219
```azurecli
218-
az sql db-arc backups-policy set --name <sql-database-name> --server <arc-server-name> --resource-group <resourcegroup> --retention-days <number of days> --full-backup-days <num of days> --diff-backup-hours <12 or 24 hours> --tlog-backup-mins <number of minutes>
220+
az sql db-arc backups-policy set --name <sql-database-name> --server <arc-server-name> --resource-group <resourcegroup> --retention-days <number of days> --full-backup-days <num of days> --diff-backup-hours <12 or 24 hours> --tlog-backup-mins <number of minutes>
219221
```
220222
221223
Example:
@@ -226,40 +228,40 @@ To enable automated backups on a database level using az CLI:
226228
227229
---
228230
229-
## Disable automated backup
231+
## Disable automated backup
230232
231-
If the backup retention day is set to 0, automated backup is disabled and no backups are taken, even though backup policy is retained. Setting the backup retention to a nonzero value enables the policy again.
233+
If the backup retention day is set to 0, automated backup is disabled and no backups are taken, even though backup policy is retained. Setting the backup retention to a nonzero value enables the policy again.
232234
233-
This setting applies to both database and instance level backup. If database level backup schedule is disabled, no backups are taken for the database even if instance level backup is scheduled.
235+
This setting applies to both database and instance level backup. If database level backup schedule is disabled, no backups are taken for the database even if instance level backup is scheduled.
234236
235-
## Delete automated backup
237+
## Delete automated backup
236238
237239
From the portal for individual database level backup scheduling page, select **Revert backup policy to instance level** to delete the database level backup policy.
238240
239-
To delete instance level backup schedule, you can do it through CLI. Once deleted, no backup is taken either in instance level or database level. You must configure a new backup schedule to take the backup again.
241+
To delete instance level backup schedule, you can do it through CLI. Once deleted, no backup is taken either in instance level or database level. You must configure a new backup schedule to take the backup again.
240242
241243
### Delete Instance Level Policy
242244
243245
```azurecli
244-
az sql server-arc backups-policy delete --name <arc-server-name> --resource-group <resourcegroup>
246+
az sql server-arc backups-policy delete --name <arc-server-name> --resource-group <resourcegroup>
245247
```
246248

247249
Example:
248250

249251
```azurecli
250-
az sql server-arc backups-policy delete --name MyArcServer_SQLServerPROD --resource-group MyResourceGroup
252+
az sql server-arc backups-policy delete --name MyArcServer_SQLServerPROD --resource-group MyResourceGroup
251253
```
252254

253255
### Delete Database Level Policy
254256

255257
```azurecli
256-
az sql db-arc backups-policy delete --name <sql-database-name> --server <arc-server-name> --resource-group <resourcegroup>
258+
az sql db-arc backups-policy delete --name <sql-database-name> --server <arc-server-name> --resource-group <resourcegroup>
257259
```
258260

259261
Example:
260262

261263
```azurecli
262-
az sql db-arc backups-policy delete --name MyDatabaseName --server MyArcServer_SQLServerPROD --resource-group MyResourceGroup
264+
az sql db-arc backups-policy delete --name MyDatabaseName --server MyArcServer_SQLServerPROD --resource-group MyResourceGroup
263265
```
264266

265267
## View current backup policy
@@ -316,7 +318,7 @@ When the built-in automated backups are enabled on an instance of [!INCLUDE [ssn
316318

317319
## Limitations
318320

319-
- Automatic backup to URL is not currently available.
321+
- Automatic backup to URL isn't currently available.
320322
- The user databases need to be in full recovery model for the backups to be performed. Databases that aren't in full recovery model aren't automatically backed up.
321323
- Automated backups are currently not supported for Always On failover cluster instances (FCI).
322324
- Automated backups aren't supported on any instance that hosts an availability group (AG) replica.
@@ -325,5 +327,5 @@ When the built-in automated backups are enabled on an instance of [!INCLUDE [ssn
325327
## Related tasks
326328

327329
- [Restore to a point-in-time](point-in-time-restore.md)
328-
- [View SQL Azure Arc inventory](view-inventory.md)
329-
- [Recovery Models (SQL Server)](../../relational-databases/backup-restore/recovery-models-sql-server.md)
330+
- [Manage inventory of SQL Server resources with Azure Arc](view-inventory.md)
331+
- [Recovery models (SQL Server)](../../relational-databases/backup-restore/recovery-models-sql-server.md)
-133 KB
Loading
72.2 KB
Loading
-46.4 KB
Loading
-31.5 KB
Loading
-67.6 KB
Loading
-128 KB
Loading
-25.7 KB
Loading
-41.8 KB
Loading

0 commit comments

Comments
 (0)