managed_backup.sp_backup_config_basic (Transact-SQL)managed_backup.sp_backup_config_basic (Transact-SQL)

QUESTO ARGOMENTO SI APPLICA A:sìSQL Server (a partire dalla versione 2016)noDatabase SQL di AzurenoAzure SQL Data WarehousenoParallel Data WarehouseTHIS TOPIC APPLIES TO: yesSQL Server (starting with 2016)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Configura il Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure le impostazioni di base per un database specifico o per un'istanza di SQL ServerSQL Server.Configures the Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure basic settings for a specific database or for an instance of SQL ServerSQL Server.

Nota

Questa procedura può essere chiamata su una proprio per creare una configurazione di backup gestita di base.This procedure can be called on its own to create a basic managed backup configuration. Tuttavia, se si prevede di aggiungere funzionalità avanzate o una pianificazione personalizzata, prima di tutto configurare tali impostazioni mediante managed_backup. sp_backup_config_advanced (Transact-SQL) e managed_backup.sp_ backup_config_schedule (Transact-SQL) prima di abilitare il backup gestito con questa procedura.However, if you plan to add advanced features or a custom schedule, first configure those settings using managed_backup.sp_backup_config_advanced (Transact-SQL) and managed_backup.sp_backup_config_schedule (Transact-SQL) before enabling managed backup with this procedure.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintassiSyntax

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'  

ArgomentiArguments

@enable_backup
Abilitare o disabilitare il Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure per il database specificato.Enable or disable Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure for the specified database. Il @enable_backup è BIT.The @enable_backup is BIT. Parametro obbligatorio quando si configura Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure per la prima istanza di SQL ServerSQL Server.Required parameter when configuring Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure for the first instance of SQL ServerSQL Server. Se si modifica un'esistente Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure configurazione, questo parametro è facoltativo.If you are changing an existing Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure configuration, this parameter is optional. In tal caso, i valori di configurazione specificati non mantengono i valori esistenti.In that case, any configuration values not specified retain their existing values.

@database_name
Il nome del database per l'attivazione di backup gestito in un database specifico.The database name for enabling managed backup on a specific database.

@container_url
Un URL che indica la posizione del backup.A URL that indicates the location of the backup. Quando @credential_name è NULL, questo URL è un URL di firma di accesso condiviso a un contenitore blob in archiviazione di Azure e i backup di usare la nuova funzionalità di backup in blocco blob.When @credential_name is NULL, this URL is a shared access signature (SAS) URL to a blob container in Azure Storage, and the backups use the new backup to block blob functionality. Per ulteriori informazioni, vedere SAS comprensione.For more information, please review Understanding SAS. Quando @credential_name viene specificato, si tratta di un URL di account di archiviazione e i backup utilizzano il backup deprecato funzionalità di blob di pagina.When @credential_name is specified, then this is a storage account URL, and the backups use the deprecated backup to page blob functionality.

Nota

In questo momento, solo un URL SAS è supportato per questo parametro.Only a SAS URL is supported for this parameter at this time.

@retention_days
Periodo di conservazione dei file di backup espresso in giorni.The retention period for the backup files in days. Il @storage_url è INT.The @storage_url is INT. Si tratta di un parametro obbligatorio quando si configura Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure per la prima volta nell'istanza di SQL ServerSQL Server.This is a required parameter when configuring Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure for the first time on the instance of SQL ServerSQL Server. Durante la modifica di Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure configurazione, questo parametro è facoltativo.While changing the Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure configuration, this parameter is optional. Se non specificato, vengono mantenuti i valori di configurazione esistenti.If not specified then the existing configuration values are retained.

@credential_name
Nome delle credenziali SQL utilizzate per l'autenticazione per l'account di archiviazione di Windows Azure.The name of the SQL Credential used to authenticate to the Windows Azure storage account. @credentail_name viene SYSNAME.@credentail_name is SYSNAME. Quando specificato, il backup viene archiviato in un blob di pagine.When specified, the backup is stored to a page blob. Se questo parametro è NULL, il backup verrà archiviato come blob in blocchi.If this parameter is NULL, the backup will be stored as a block blob. Backup in blob di pagine è deprecato, pertanto è preferibile utilizzare la nuova funzionalità backup di blob di blocco.Backup to page blob is deprecated, so it is preferred to use the new block blob backup functionality. Quando utilizzato per modificare la configurazione di Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure, questo parametro è facoltativo.When used to change the Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure configuration, this parameter is optional. Se non specificato, vengono mantenuti i valori di configurazione esistente.If not specified, then the existing configuration values are retained.

Avviso

Il @credential_name parametro non è supportato in questo momento.The @credential_name parameter is not supported at this time. È supportato solo backup per bloccare i blob, che richiede questo parametro deve essere NULL.Only backup to block blob is supported, which requires this parameter to be NULL.

Valore del codice restituitoReturn Code Value

0 (esito positivo) o 1 (esito negativo)0 (success) or 1 (failure)

SicurezzaSecurity

AutorizzazioniPermissions

È richiesta l'appartenenza db_backupoperator ruolo del database con ALTER ANY CREDENTIAL , autorizzazioni e EXECUTE le autorizzazioni per sp_delete _ BackupHistory stored procedure.Requires membership in db_backupoperator database role, with ALTER ANY CREDENTIAL permissions, and EXECUTE permissions on sp_delete_backuphistory stored procedure.

EsempiExamples

Tramite i comandi di PowerShell di Azure più recenti, è possibile creare il contenitore di account di archiviazione sia l'URL di firma di accesso condiviso.You can create both the storage account container and the SAS URL by using the latest Azure PowerShell commands. Nell'esempio seguente crea un nuovo contenitore, mycontainer, nell'account di archiviazione mystorageaccount e quindi Ottiene un URL SAS per tale con le autorizzazioni complete.The following example creates a new container, mycontainer, in the mystorageaccount storage account and then obtains a SAS URL for it with full permissions.

$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  

L'esempio seguente abilita Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure per l'istanza di SQL Server viene eseguito, imposta i criteri di conservazione su 30 giorni, imposta la destinazione in un contenitore denominato 'mycontainer' in un account di archiviazione denominato 'mystorageaccount'.The following example enables Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure for the instance of SQL Server it is executed on, sets the retention policy to 30 days, sets the destination to a container named 'mycontainer' in a storage account named '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  

Nell'esempio seguente viene disabilitato Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure per l'istanza di SQL Server sui cui è in esecuzione.The following example disables Backup gestito di SQL Server in Microsoft AzureSQL Server Managed Backup to Microsoft Azure for the instance of SQL Server it is executed on.

Use msdb;  
Go  
EXEC managed_backup.sp_backup_config_basic  
                @enable_backup=0;  
GO  

Vedere ancheSee Also

managed_backup.sp_backup_config_advanced (Transact-SQL) managed_backup.sp_backup_config_advanced (Transact-SQL)
managed_backup.sp_backup_config_schedule (Transact-SQL)managed_backup.sp_backup_config_schedule (Transact-SQL)