sys.sp_rda_set_query_mode (T-SQL)

  • Artikel

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

Menentukan apakah kueri terhadap database yang diaktifkan Stretch saat ini dan tabelnya mengembalikan data lokal dan jarak jauh (default), atau data lokal saja.

Penting

Stretch Database tidak digunakan lagi di SQL Server 2022 (16.x) dan Azure SQL Database. Fitur ini akan dihapus dalam versi Mesin Database di masa mendatang. Hindari menggunakan fitur ini dalam pekerjaan pengembangan baru, dan rencanakan untuk memodifikasi aplikasi yang saat ini menggunakan fitur ini.

Konvensi sintaks transact-SQL

Sintaks

sp_rda_set_query_mode
    [ @mode = ] @mode
    [ , [ @force = ] @force ]
[ ; ]

Argumen

[ @mode = ] @mode

Salah satu dari nilai berikut:

  • DISABLED Semua kueri terhadap tabel yang diaktifkan Stretch gagal.

  • LOCAL_ONLY Kueri terhadap tabel yang diaktifkan Stretch hanya mengembalikan data lokal.

  • LOCAL_AND_REMOTE Kueri terhadap tabel yang diaktifkan Stretch mengembalikan data lokal dan jarak jauh. Ini adalah perilaku default.

[ @force = ] @force

Nilai bit opsional yang bisa Anda atur ke 1 jika Anda ingin mengubah mode kueri tanpa validasi.

Mengembalikan nilai kode

0 (berhasil) atau > 0 (kegagalan).

Izin

Memerlukan izin db_owner.

Keterangan

Prosedur tersimpan yang diperluas berikut ini juga mengatur mode kueri untuk database dengan dukungan Stretch.

  • sp_rda_deauthorize_db:

    Setelah Anda menjalankan sp_rda_deauthorize_db , semua kueri terhadap database dan tabel yang diaktifkan Stretch gagal. Artinya, mode kueri diatur ke DISABLED. Untuk keluar dari mode ini, lakukan salah satu hal berikut.

    • Jalankan sys.sp_rda_reauthorize_db (Transact-SQL) untuk menyambungkan kembali ke database Azure jarak jauh. Operasi ini secara otomatis mengatur ulang mode kueri ke LOCAL_AND_REMOTE, yang merupakan perilaku default untuk Stretch Database. Artinya, kueri mengembalikan hasil dari data lokal dan jarak jauh.

    • Jalankan sys.sp_rda_set_query_mode dengan LOCAL_ONLY argumen untuk membiarkan kueri terus berjalan terhadap data lokal saja.

  • sp_rda_reauthorize_db:

    Saat Anda menjalankan sys.sp_rda_reauthorize_db (Transact-SQL) untuk menyambungkan kembali ke database Azure jarak jauh, operasi ini secara otomatis mengatur ulang mode kueri ke LOCAL_AND_REMOTE, yang merupakan perilaku default untuk Stretch Database. Artinya, kueri mengembalikan hasil dari data lokal dan jarak jauh.

Konten terkait