Bagikan melalui


sys.fn_hadr_backup_is_preferred_replica (T-SQL)

Berlaku untuk: SQL Server

Digunakan untuk menentukan apakah replika saat ini adalah replika cadangan pilihan.

Konvensi sintaks transact-SQL

Sintaks

sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )

Argumen

'dbname'

Nama database yang akan dicadangkan. dbname adalah jenis sysname.

Mengembalikan

Mengembalikan jenis data bit: 1 jika database pada instans saat ini ada di replika pilihan, jika tidak 0.

Untuk database yang bukan bagian dari grup ketersediaan, fungsi ini selalu mengembalikan 1.

Keterangan

Gunakan fungsi ini dalam skrip cadangan untuk menentukan apakah database saat ini ada di replika yang lebih disukai untuk cadangan. Anda dapat menjalankan skrip pada setiap replika ketersediaan. Masing-masing pekerjaan ini melihat data yang sama untuk menentukan pekerjaan mana yang harus dijalankan, sehingga hanya salah satu pekerjaan terjadwal yang benar-benar berlanjut ke tahap pencadangan. Kode sampel bisa mirip dengan yang berikut ini.

IF sys.fn_hadr_backup_is_preferred_replica(@dbname) <> 1
    BEGIN
-- If this is not the preferred replica, exit (probably without error).
        SELECT 'This is not the preferred replica, exiting with success';
    END
-- If this is the preferred replica, continue to do the backup.
/* actual backup command goes here */

Contoh

J. Gunakan sys.fn_hadr_backup_is_preferred_replica

Contoh berikut mengembalikan 1 jika database saat ini adalah replika cadangan pilihan.

SELECT sys.fn_hadr_backup_is_preferred_replica('TestDB');
GO