managed_backup.sp_backup_on_demand (TRANSACT-SQL)managed_backup.sp_backup_on_demand (Transact-SQL)

適用対象: ○SQL Server (2016 以降) XAzure SQL Database XAzure SQL Data Warehouse XParallel Data WarehouseAPPLIES TO: yesSQL Server (starting with 2016) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

指定されたデータベースのバックアップを実行するように Microsoft Azure への SQL Server マネージ バックアップSQL Server Managed Backup to Microsoft Azureに要求します。Requests Microsoft Azure への SQL Server マネージ バックアップSQL Server Managed Backup to Microsoft Azure to perform a backup of the specified database.

このストアド プロシージャを使用すると、Microsoft Azure への SQL Server マネージ バックアップSQL Server Managed Backup to Microsoft Azureで構成されるデータベースに対してアドホック バックアップを実行できます。Use this stored procedure to perform ad hoc backups for a database configured with Microsoft Azure への SQL Server マネージ バックアップSQL Server Managed Backup to Microsoft Azure. これにより、バックアップ チェーンが中断されることはなくなるため、Microsoft Azure への SQL Server マネージ バックアップSQL Server Managed Backup to Microsoft Azure プロセスは認識し、バックアップは同じ Windows Azure BLOB ストレージ コンテナーに格納されます。This prevents any break in the backup chain and Microsoft Azure への SQL Server マネージ バックアップSQL Server Managed Backup to Microsoft Azure processes are aware and the backup is stored in the same Windows Azure Blob storage container.

バックアップが正常に完了すると、バックアップ ファイルの完全なパスが返されます。Upon successful completion of the backup the full backup file path is returned. これには、バックアップ操作の結果として作成された新しいバックアップ ファイルの名前と場所が含まれます。This includes the name and location of the new backup file resulting from the backup operation.

Microsoft Azure への SQL Server マネージ バックアップSQL Server Managed Backup to Microsoft Azureが特定の種類の指定されたデータベースのバックアップを実行中の場合は、エラーが返されます。An error is returned if Microsoft Azure への SQL Server マネージ バックアップSQL Server Managed Backup to Microsoft Azure is in the process of executing a backup of given type for the specified database. この場合、返されるエラー メッセージには、現在のバックアップのアップロード先となるバックアップ ファイルの完全なパスが含まれます。In this case, the error message returned includes the full backup file path where the current backup is being uploaded to.

トピック リンク アイコン Transact-SQL 構文表記規則Topic link icon Transact-SQL Syntax Conventions

構文Syntax

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

引数Arguments

@database_name
バックアップの実行対象となるデータベースの名前。The name of the database on which the backup is to be performed. @database_nameは SYSNAME します。The @database_name is SYSNAME.

@type
実行するバックアップの種類:データベースまたはログ。The type of backup to be performed: Database or Log. @typeパラメーターが**nvarchar (32)** します。The @type parameter is NVARCHAR(32).

リターン コード値Return Code Value

0 (成功) または 1 (失敗)0 (success) or 1 (failure)

セキュリティSecurity

アクセス許可Permissions

メンバーシップが必要ですdb_backupoperatorデータベース ロール、 ALTER ANY CREDENTIALアクセス許可、およびEXECUTEに対するsp_deletebackuphistoryストアド プロシージャ。Requires membership in db_backupoperator database role, with ALTER ANY CREDENTIAL permissions, and EXECUTE permissions on sp_delete_backuphistorystored procedure.

使用例Examples

次の例で、データベース"TestDB"のデータベース バックアップを要求します。The following example makes a database backup request for the database 'TestDB'. このデータベースでは、Microsoft Azure への SQL Server マネージ バックアップSQL Server Managed Backup to Microsoft Azureが有効になっています。This database has Microsoft Azure への SQL Server マネージ バックアップSQL Server Managed Backup to Microsoft Azure enabled.

Use MSDB  
Go  
EXEC managed_backup.sp_backup_on_demand  
 @database_name = 'TestDB'  
,@type = 'Database'  
  

各コードでは、言語属性フィールドで "tsql" を選択します。For each code snippet, select 'tsql' in the language attribute field.