managed_backup.sp_backup_on_demand (Transact-SQL)

  • 發行項

適用於：SQL Server 2016 (13.x) 和更新版本

要求 SQL Server 受控備份至 Microsoft Azure，以執行指定資料庫的備份。

使用此預存程式，針對使用 SQL Server 受控備份設定的資料庫執行臨機操作備份至 Microsoft Azure。 這可防止備份鏈結和 SQL Server 受控備份至 Microsoft Azure 進程有任何中斷，而且備份會儲存在相同的 Azure Blob 記憶體容器中。

成功完成備份後，會傳回完整備份文件路徑。 這包括備份作業所產生的新備份檔名稱和位置。

如果 SQL Server 受控備份至 Microsoft Azure 正在針對指定的資料庫執行指定類型的備份，就會傳回錯誤。 在此情況下，傳回的錯誤訊息包含上傳目前備份所在的完整備份文件路徑。

Transact-SQL 語法慣例

語法

EXEC managed_backup.sp_backup_on_demand
    [ @database_name = ] 'database name'
    , [ @type = ] { 'Database' | 'Log' }
[ ; ]

引數

[ @database_name = ] 'database name'

要執行備份的資料庫名稱。 @database_name是 sysname。

[ @type = ] { 'Database' |'Log' }

要執行的備份類型：資料庫或記錄檔。 參數 @type 為 nvarchar（32）。

傳回碼值

0 (成功) 或 1 (失敗)。

權限

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

範例

下列範例會提出資料庫 的資料庫 TestDB備份要求。 此資料庫已啟用 SQL Server 受控備份至 Microsoft Azure。

USE msdb;
GO

EXEC managed_backup.sp_backup_on_demand
    @database_name = 'TestDB',
    @type = 'Database';
GO