managed_backup.sp_backup_on_demand (Transact-SQL)

  • [アーティクル]

適用対象: SQL Server 2016 (13.x) 以降のバージョン

指定したデータベースのバックアップを実行するために、SQL Server マネージド バックアップを Microsoft Azure に要求します。

このストアド プロシージャを使用して、MICROSOFT Azure への SQL Server マネージド バックアップで構成されたデータベースのアドホック バックアップを実行します。 これにより、バックアップ チェーンの中断が防止され、Microsoft Azure プロセスへの SQL Server マネージド バックアップが認識され、バックアップは同じ Azure Blob Storage コンテナーに格納されます。

バックアップが正常に完了すると、完全なバックアップ ファイル パスが返されます。 これには、バックアップ操作の結果として得られる新しいバックアップ ファイルの名前と場所が含まれます。

Microsoft Azure への SQL Server マネージド バックアップが、指定されたデータベースに対して特定の種類のバックアップを実行中の場合、エラーが返されます。 この場合、返されるエラー メッセージには、現在のバックアップのアップロード先となるバックアップ ファイルの完全なパスが含まれます。

Transact-SQL 構文表記規則

構文

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

引数

[ @database_name = ] 'database name'

バックアップを実行するデータベースの名前。 sysname @database_name です。

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

実行するバックアップの種類: Database または Log。 パラメーターは @typenvarchar(32)です。

リターン コードの値

0 (成功) または 1 (失敗)。

アクセス許可

ALTER ANY CREDENTIAL アクセス許可とストアド プロシージャに 対する EXECUTE アクセス許可を持つ、db_backupoperatorデータベース ロールのメンバーシップが sp_delete_backuphistory 必要です。

例

次の例では、データベースのデータベース バックアップ要求を行 TestDBいます。 このデータベースでは、Microsoft Azure への SQL Server マネージド バックアップが有効になっています。

USE msdb;
GO

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