managed_backup.sp_backup_config_basic (Transact-SQL)
Si applica a: 
SQL Server 2016 (13.x) e versioni successive
Configura le impostazioni di base del backup gestito di SQL Server in Microsoft Azure per un database specifico o per un'istanza di SQL Server.
Nota
Questa procedura può essere chiamata autonomamente per creare una configurazione di backup gestita di base. Tuttavia, se si prevede di aggiungere funzionalità avanzate o una pianificazione personalizzata, configurare tali impostazioni usando managed_backup.sp_backup_config_advanced e managed_backup.sp_backup_config_schedule, prima di abilitare il backup gestito con questa procedura.
Convenzioni relative alla sintassi Transact-SQL
Sintassi
EXEC managed_backup.sp_backup_config_basic
[ @enable_backup = ] { 0 | 1 }
, [ @database_name = ] 'database_name'
, [ @container_url = ] 'Azure_Storage_blob_container'
, [ @retention_days = ] retention_period_in_days
, [ @credential_name = ] 'sql_credential_name'
[ ; ]
Argomenti
[ @enable_backup = ] { 0 | 1 }
Abilitare o disabilitare il backup gestito di SQL Server in Microsoft Azure per il database specificato. @enable_backup è bit.
Parametro obbligatorio durante la configurazione del backup gestito di SQL Server in Microsoft Azure per la prima istanza di SQL Server. Se si modifica un backup gestito di SQL Server esistente nella configurazione di Microsoft Azure, questo parametro è facoltativo. In tal caso, tutti i valori di configurazione non specificati mantengono i valori esistenti.
Per altre informazioni, vedere Abilitare il backup gestito di SQL Server in Azure.
[ @database_name = ] 'database_name'
Nome del database per l'abilitazione del backup gestito in un database specifico.
Se @database_name è impostato su , le impostazioni sono a NULLlivello di istanza (si applica a tutti i nuovi database creati nell'istanza).
[ @container_url = ] 'Azure_Storage_blob_container'
URL che indica il percorso del backup. Quando @credential_name è NULL, questo URL è un URL di firma di accesso condiviso (SAS) a un contenitore BLOB in Archiviazione di Azure e i backup usano il nuovo backup per bloccare la funzionalità BLOB. Per altre informazioni, vedere Concedere l'accesso limitato alle risorse Archiviazione di Azure usando firme di accesso condiviso. Quando si specifica @credential_name , si tratta di un URL dell'account di archiviazione e i backup usano il backup deprecato nella funzionalità BLOB di pagine.
Se l'URL della firma di accesso condiviso include il token di firma di accesso condiviso, è necessario separarlo dal token di firma di accesso condiviso nel punto interrogativo e non includere il punto interrogativo.
Ad esempio, https://managedbackupstorage.blob.core.windows.net/backupcontainer?sv=2014-02-14&sr=c&sig=xM2LXVo1Erqp7LxQ%9BxqK9QC6%5Qabcd%9LKjHGnnmQWEsDf%5Q%se=2015-05-14T14%3B93%4V20X&sp=rwdl vengono restituiti i due valori seguenti:
| Type | Output |
|---|---|
| URL del contenitore | https://managedbackupstorage.blob.core.windows.net/backupcontainer |
| Token della firma di accesso condiviso | sv=2014-02-14&sr=c&sig=xM2LXVo1Erqp7LxQ%9BxqK9QC6%5Qabcd%9LKjHGnnmQWEsDf%5Q%se=2015-05-14T14%3B93%4V20X&sp=rwdl |
Nota
Per questo parametro è supportato solo un URL di firma di accesso condiviso.
[ @retention_days = ] retention_period_in_days
Periodo di conservazione dei file di backup espresso in giorni. @retention_days è int. Si tratta di un parametro obbligatorio quando si configura il backup gestito di SQL Server in Microsoft Azure per la prima volta nell'istanza di SQL Server. Quando si modifica il backup gestito di SQL Server in configurazione di Microsoft Azure, questo parametro è facoltativo. Se non specificato, vengono mantenuti i valori di configurazione esistenti.
[ @credential_name = ] 'sql_credential_name'
Nome delle credenziali SQL usate per l'autenticazione nell'account di archiviazione di Azure. @credential_name è sysname. Se specificato, il backup viene archiviato in un BLOB di pagine. Se questo parametro è NULL, il backup viene archiviato come BLOB in blocchi. Il backup nel BLOB di pagine è deprecato, quindi è preferibile usare la nuova funzionalità di backup BLOB in blocchi. Se usato per modificare il backup gestito di SQL Server in configurazione di Microsoft Azure, questo parametro è facoltativo. Se non specificato, i valori di configurazione esistenti vengono mantenuti.
Avviso
Il parametro @credential_name non è attualmente supportato. È supportato solo il backup nel BLOB in blocchi, che richiede che questo parametro sia NULL.
Valori del codice restituito
0 (esito positivo) o 1 (errore).
Autorizzazioni
Richiede l'appartenenza al ruolo del database db_backupoperator , con autorizzazioni ALTER ANY CREDENTIAL e autorizzazioni EXECUTE per la sp_delete_backuphistory stored procedure.
Esempi
R. Creare un contenitore di account di archiviazione e un URL di firma di accesso condiviso
È possibile creare sia il contenitore dell'account di archiviazione che l'URL della firma di accesso condiviso usando i comandi più recenti di Azure PowerShell. Nell'esempio seguente viene creato un nuovo contenitore myContainer nell'account mystorageaccount di archiviazione e quindi viene ottenuto un URL di firma di accesso condiviso con autorizzazioni complete.
Per altre informazioni sulle firme di accesso condiviso, vedere Concedere accesso limitato alle risorse di archiviazione di Azure tramite firme di accesso condiviso. Per un esempio di script di PowerShell, vedere Creare una firma di accesso condiviso.
$context = New-AzureStorageContext -StorageAccountName mystorageaccount -StorageAccountKey (Get-AzureStorageKey -StorageAccountName mystorageaccount).Primary
New-AzureStorageContainer -Name myContainer -Context $context
New-AzureStorageContainerSASToken -Name myContainer -Permission rwdl -FullUri -Context $context
B. Abilitare il backup gestito di SQL Server in Azure
L'esempio seguente abilita il backup gestito di SQL Server in Microsoft Azure per l'istanza di SQL Server in cui viene eseguito, imposta i criteri di conservazione su 30 giorni e imposta la destinazione su un contenitore denominato myContainer in un account di archiviazione denominato mystorageaccount.
USE msdb;
GO
EXEC managed_backup.sp_backup_config_basic @enable_backup = 1,
@container_url = 'https://mystorageaccount.blob.core.windows.net/myContainer',
@retention_days = 30;
GO
C. Disabilitare il backup gestito di SQL Server in Azure
Nell'esempio seguente viene disabilitato il backup gestito di SQL Server in Microsoft Azure per l'istanza di SQL Server in cui viene eseguito.
USE msdb;
GO
EXEC managed_backup.sp_backup_config_basic @enable_backup = 0;
GO