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
| BACKUP |Y| BLOCKSIZE and MAXTRANSFERSIZE are supported for block blobs. They aren't supported for page blobs. | BACKUP to a block blob requires a Shared Access Signature saved in a SQL Server credential. BACKUP to page blob requires the storage account key saved in a [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential, and requires the WITH CREDENTIAL argument to be specified. |
181
-
| RESTORE |Y|| Requires a [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential to be defined, and requires the WITH CREDENTIAL argument to be specified if the [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential is defined using the storage account key as the secret |
182
-
| RESTORE FILELISTONLY |Y|| Requires a [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential to be defined, and requires the WITH CREDENTIAL argument to be specified if the [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential is defined using the storage account key as the secret |
183
-
| RESTORE HEADERONLY |Y|| Requires a [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential to be defined, and requires the WITH CREDENTIAL argument to be specified if the [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential is defined using the storage account key as the secret |
184
-
| RESTORE LABELONLY |Y|| Requires a [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential to be defined, and requires the WITH CREDENTIAL argument to be specified if the [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential is defined using the storage account key as the secret |
185
-
| RESTORE VERIFYONLY |Y|| Requires a [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential to be defined, and requires the WITH CREDENTIAL argument to be specified if the [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential is defined using the storage account key as the secret |
186
-
| RESTORE REWINDONLY |-|||
180
+
| BACKUP |Yes| BLOCKSIZE and MAXTRANSFERSIZE are supported for block blobs. They aren't supported for page blobs. | BACKUP to a block blob requires a Shared Access Signature saved in a SQL Server credential. BACKUP to page blob requires the storage account key saved in a [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential, and requires the WITH CREDENTIAL argument to be specified. |
181
+
| RESTORE |Yes|| Requires a [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential to be defined, and requires the WITH CREDENTIAL argument to be specified if the [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential is defined using the storage account key as the secret |
182
+
| RESTORE FILELISTONLY |Yes|| Requires a [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential to be defined, and requires the WITH CREDENTIAL argument to be specified if the [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential is defined using the storage account key as the secret |
183
+
| RESTORE HEADERONLY |Yes|| Requires a [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential to be defined, and requires the WITH CREDENTIAL argument to be specified if the [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential is defined using the storage account key as the secret |
184
+
| RESTORE LABELONLY |Yes|| Requires a [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential to be defined, and requires the WITH CREDENTIAL argument to be specified if the [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential is defined using the storage account key as the secret |
185
+
| RESTORE VERIFYONLY |Yes|| Requires a [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential to be defined, and requires the WITH CREDENTIAL argument to be specified if the [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential is defined using the storage account key as the secret |
186
+
| RESTORE REWINDONLY |No|||
187
187
188
188
For syntax and general information about backup statements, see [BACKUP](../../t-sql/statements/backup-transact-sql.md).
189
189
@@ -193,72 +193,72 @@ For syntax and general information about restore statements, see [RESTORE Statem
193
193
194
194
| Argument | Supported | Exception | Comments |
195
195
| --- | --- | --- | --- |
196
-
| DATABASE |Y|||
197
-
| LOG |Y|||
196
+
| DATABASE |Yes|||
197
+
| LOG |Yes|||
198
198
||
199
-
| TO (URL) |Y| Unlike DISK and TAPE, URL doesn't support specifying or creating a logical name. | This argument is used to specify the URL path for the backup file. |
200
-
| MIRROR TO |Y|||
199
+
| TO (URL) |Yes| Unlike DISK and TAPE, URL doesn't support specifying or creating a logical name. | This argument is used to specify the URL path for the backup file. |
200
+
| MIRROR TO |Yes|||
201
201
|**`WITH` options:**||||
202
-
| CREDENTIAL |Y|| WITH CREDENTIAL is only supported when using BACKUP TO URL option to back up to Azure Blob Storage and only if the [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential is defined using the storage account key as the secret |
203
-
| FILE_SNAPSHOT |Y|||
204
-
| ENCRYPTION |Y|| When the `WITH ENCRYPTION` argument is specified, [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] File-Snapshot Backup ensures that the entire database was TDE-encrypted before taking the backup and, if so, encrypts the file-snapshot backup file itself using the algorithm specified for TDE on the database. If all data in the database in the entire database isn't encrypted, the backup fails (for example, the encryption process isn't yet complete). |
205
-
| DIFFERENTIAL |Y|||
206
-
| COPY_ONLY |Y|||
207
-
| COMPRESSION|NO_COMPRESSION |Y| Not supported for file-snapshot backup ||
208
-
| DESCRIPTION |Y|||
209
-
| NAME |Y|||
210
-
| EXPIREDATE | RETAINDAYS |-|||
211
-
| NOINIT | INIT |-|| Appending to blobs isn't possible. To overwrite a backup, use the `WITH FORMAT` argument. However, when using file-snapshot backups (using the `WITH FILE_SNAPSHOT` argument), the `WITH FORMAT` argument isn't permitted to avoid leaving orphaned file-snapshots that were created with the original backup. |
212
-
| NOSKIP | SKIP |-|||
213
-
| NOFORMAT | FORMAT |Y|| A backup taken to an existing blob fails unless `WITH FORMAT` is specified. The existing blob is overwritten when `WITH FORMAT` is specified. However, when using file-snapshot backups (using the `WITH FILE_SNAPSHOT` argument), the FORMAT argument isn't permitted to avoid leaving orphaned file-snapshots that were created with the original file-snapshot backup. However, when using file-snapshot backups (using the `WITH FILE_SNAPSHOT` argument), the `WITH FORMAT` argument isn't permitted to avoid leaving orphaned file-snapshots that were created with the original backup. |
214
-
| MEDIADESCRIPTION |Y|||
215
-
| MEDIANAME |Y|||
216
-
| BLOCKSIZE |Y| Not supported for page blob. Supported for block blob. | Recommend BLOCKSIZE=65536 to optimize use of the 50,000 blocks allowed in a block blob. |
217
-
| BUFFERCOUNT |Y|||
218
-
| MAXTRANSFERSIZE |Y| Not supported for page blob. Supported for block blob. | Default is 1048576. The value can range up to 4 MB in increments of 65536 bytes.<br />Recommend MAXTRANSFERSIZE=4194304 to optimize use of the 50,000 blocks allowed in a block blob. |
219
-
| NO_CHECKSUM | CHECKSUM |Y|||
220
-
| STOP_ON_ERROR | CONTINUE_AFTER_ERROR |Y|||
221
-
| STATS |Y|||
222
-
| REWIND | NOREWIND |-|||
223
-
| UNLOAD | NOUNLOAD |-|||
224
-
| NORECOVERY | STANDBY |Y|||
225
-
| NO_TRUNCATE |Y|||
202
+
| CREDENTIAL |Yes|| WITH CREDENTIAL is only supported when using BACKUP TO URL option to back up to Azure Blob Storage and only if the [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] credential is defined using the storage account key as the secret |
203
+
| FILE_SNAPSHOT |Yes|||
204
+
| ENCRYPTION |Yes|| When the `WITH ENCRYPTION` argument is specified, [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] File-Snapshot Backup ensures that the entire database was TDE-encrypted before taking the backup and, if so, encrypts the file-snapshot backup file itself using the algorithm specified for TDE on the database. If all data in the database in the entire database isn't encrypted, the backup fails (for example, the encryption process isn't yet complete). |
205
+
| DIFFERENTIAL |Yes|||
206
+
| COPY_ONLY |Yes|||
207
+
| COMPRESSION|NO_COMPRESSION |Yes| Not supported for file-snapshot backup ||
208
+
| DESCRIPTION |Yes|||
209
+
| NAME |Yes|||
210
+
| EXPIREDATE | RETAINDAYS |No|||
211
+
| NOINIT | INIT |No|| Appending to blobs isn't possible. To overwrite a backup, use the `WITH FORMAT` argument. However, when using file-snapshot backups (using the `WITH FILE_SNAPSHOT` argument), the `WITH FORMAT` argument isn't permitted to avoid leaving orphaned file-snapshots that were created with the original backup. |
212
+
| NOSKIP | SKIP |No|||
213
+
| NOFORMAT | FORMAT |Yes|| A backup taken to an existing blob fails unless `WITH FORMAT` is specified. The existing blob is overwritten when `WITH FORMAT` is specified. However, when using file-snapshot backups (using the `WITH FILE_SNAPSHOT` argument), the FORMAT argument isn't permitted to avoid leaving orphaned file-snapshots that were created with the original file-snapshot backup. However, when using file-snapshot backups (using the `WITH FILE_SNAPSHOT` argument), the `WITH FORMAT` argument isn't permitted to avoid leaving orphaned file-snapshots that were created with the original backup. |
214
+
| MEDIADESCRIPTION |Yes|||
215
+
| MEDIANAME |Yes|||
216
+
| BLOCKSIZE |Yes| Not supported for page blob. Supported for block blob. | Recommend BLOCKSIZE=65536 to optimize use of the 50,000 blocks allowed in a block blob. |
217
+
| BUFFERCOUNT |Yes|||
218
+
| MAXTRANSFERSIZE |Yes| Not supported for page blob. Supported for block blob. | Default is 1048576. The value can range up to 4 MB in increments of 65536 bytes.<br />Recommend MAXTRANSFERSIZE=4194304 to optimize use of the 50,000 blocks allowed in a block blob. |
For more information about Restore arguments, see [RESTORE Statements - Arguments](../../t-sql/statements/restore-statements-arguments-transact-sql.md).
0 commit comments