managed_backup.sp_backup_config_basic (Transact-SQL)

適用于:SQL Server 2016 (13.x) 和更新版本

針對特定資料庫或SQL Server實例,設定SQL Server受控備份至 Microsoft Azure 的基本設定。

注意

您可以自行呼叫此程式,以建立基本的受控備份組態。 不過,如果您打算新增進階功能或自訂排程,請先使用 managed_backup.sp_backup_config_advanced (Transact-SQL ) 和 managed_backup.sp_backup_config_schedule (Transact-SQL) ,再使用此程式啟用受控備份。

主題連結圖示Transact-SQL 語法慣例

語法

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'  

引數

@enable_backup
針對指定的資料庫啟用或停用SQL Server受控備份至 Microsoft Azure。 @enable_backup為BIT。 針對第一個 SQL Server 實例設定SQL Server受控備份至 Microsoft Azure 時的必要參數。 如果您要將現有的SQL Server受控備份變更為 Microsoft Azure 組態,則此參數是選擇性的。 在此情況下,未指定的任何組態值都會保留其現有值。

@database_name
在特定資料庫上啟用受控備份的資料庫名稱。

@container_url
表示備份位置的 URL。 當 為 Null 時 @credential_name ,此 URL 是 AZURE 儲存體中 Blob 容器的共用存取簽章 (SAS) URL,而備份會使用新的備份來封鎖 Blob 功能。 如需詳細資訊,請檢閱 瞭解 SAS。 指定時 @credential_name ,這是儲存體帳戶 URL,而備份會使用已淘汰的備份來分頁 Blob 功能。

注意

目前僅支援此參數的 SAS URL。

@retention_days
備份檔案的保留期限,以天數為單位。 @storage_url為 INT。 這是第一次在 SQL Server 實例上設定SQL Server受控備份至 Microsoft Azure 時的必要參數。 將SQL Server受控備份變更為 Microsoft Azure 組態時,此參數是選擇性的。 如果未指定,則會保留現有的組態值。

@credential_name
用來向 Azure 儲存體帳戶進行驗證的 SQL 認證名稱。 @credentail_name 為 SYSNAME。 指定時,備份會儲存至分頁 Blob。 如果此參數為 Null,備份將會儲存為區塊 Blob。 備份至分頁 Blob 已被取代,因此最好使用新的區塊 Blob 備份功能。 當用來將SQL Server受控備份變更為 Microsoft Azure 組態時,此參數是選擇性的。 如果未指定,則會保留現有的組態值。

警告

目前不支援 @credential_name 參數。 僅支援備份至區塊 Blob,這需要此參數為 Null。

傳回碼值

0 (成功) 或 1 (失敗)

安全性

權限

需要db_backupoperator資料庫角色的成員資格,且具有ALTER ANY CREDENTIAL許可權,以及sp_delete_backuphistory預存程式的EXECUTE許可權。

範例

您可以使用最新的Azure PowerShell命令來建立儲存體帳戶容器和 SAS URL。 下列範例會在 mystorageaccount 儲存體帳戶中建立新的容器 mycontainer,然後取得具有完整許可權的新容器 SAS URL。

$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  

下列範例會啟用SQL Server受控備份至 Microsoft Azure,以取得執行時SQL Server的實例、將保留原則設定為 30 天、將目的地設定為名為 'mycontainer' 的儲存體帳戶中名為 'mycontainer' 的容器。

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  
  

下列範例會針對執行SQL Server的實例停用SQL Server受控備份至 Microsoft Azure。

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

另請參閱

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