managed_backup.sp_backup_on_demand (Transact-SQL)

Artikel
04/20/2024

Berlaku untuk: SQL Server 2016 (13.x) dan versi yang lebih baru

Meminta pencadangan terkelola SQL Server ke Microsoft Azure untuk melakukan pencadangan database yang ditentukan.

Gunakan prosedur tersimpan ini untuk melakukan pencadangan ad hoc untuk database yang dikonfigurasi dengan cadangan terkelola SQL Server ke Microsoft Azure. Ini mencegah kerusakan dalam rantai cadangan dan pencadangan terkelola SQL Server ke proses Microsoft Azure menyadari dan cadangan disimpan dalam kontainer penyimpanan Azure Blob yang sama.

Setelah berhasil menyelesaikan pencadangan, jalur file cadangan lengkap dikembalikan. Ini termasuk nama dan lokasi file cadangan baru yang dihasilkan dari operasi pencadangan.

Kesalahan dikembalikan jika cadangan terkelola SQL Server ke Microsoft Azure sedang dalam proses menjalankan pencadangan jenis tertentu untuk database yang ditentukan. Dalam hal ini, pesan kesalahan yang dikembalikan menyertakan jalur file cadangan lengkap tempat cadangan saat ini sedang diunggah.

Konvensi sintaks transact-SQL

Sintaks

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

Argumen

[ @database_name = ] 'nama database'

Nama database tempat pencadangan akan dilakukan. @database_name adalah sysname.

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

Jenis cadangan yang akan dilakukan: Database atau Log. Parameternya @type adalah nvarchar(32).

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Izin

Memerlukan keanggotaan dalam peran database db_backupoperator , dengan izin ALTER ANY CREDENTIAL, dan izin EXECUTE pada sp_delete_backuphistory prosedur tersimpan.

Contoh

Contoh berikut membuat permintaan pencadangan database untuk database TestDB. Database ini mengaktifkan pencadangan terkelola SQL Server ke Microsoft Azure.

USE msdb;
GO

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

Share via