sp_changepublication_snapshot (T-SQL)

Berlaku untuk:SQL ServerAzure SQL Managed Instance

Mengubah properti Agen Rekam Jepret untuk publikasi yang ditentukan. Prosedur tersimpan ini dijalankan di Publisher pada database publikasi.

Penting

Saat mengonfigurasi Penerbit dengan Distributor jarak jauh, nilai yang disediakan untuk semua parameter, termasuk job_login dan job_password, dikirim ke Distributor sebagai teks biasa. Anda harus mengenkripsi koneksi antara Publisher dan Distributor jarak jauhnya sebelum menjalankan prosedur tersimpan ini. Untuk informasi selengkapnya, lihat Mengaktifkan Koneksi terenkripsi ke Mesin Database (Pengelola Konfigurasi SQL Server).

Konvensi sintaks transact-SQL

Sintaks

  
sp_changepublication_snapshot [ @publication= ] 'publication'  
    [ , [ @frequency_type= ] frequency_type ]  
    [ , [ @frequency_interval= ] frequency_interval ]  
    [ , [ @frequency_subday= ] frequency_subday ]  
    [ , [ @frequency_subday_interval= ] frequency_subday_interval ]  
    [ , [ @frequency_relative_interval= ] frequency_relative_interval ]  
    [ , [ @frequency_recurrence_factor= ] frequency_recurrence_factor ]  
    [ , [ @active_start_date= ] active_start_date ]  
    [ , [ @active_end_date= ] active_end_date ]  
    [ , [ @active_start_time_of_day= ] active_start_time_of_day ]  
    [ , [ @active_end_time_of_day= ] active_end_time_of_day ]  
    [ , [ @snapshot_job_name = ] 'snapshot_agent_name' ]  
    [ , [ @publisher_security_mode = ] publisher_security_mode ]  
    [ , [ @publisher_login = ] 'publisher_login' ]  
    [ , [ @publisher_password = ] 'publisher_password' ]   
    [ , [ @job_login = ] 'job_login' ]  
    [ , [ @job_password = ] 'job_password' ]  
    [ , [ @publisher = ] 'publisher' ]  

Argumen

[ @publication = ] 'publication' Adalah nama publikasi. publikasi adalah sysname, tanpa default.

[ @frequency_type = ] frequency_type Adalah frekuensi untuk menjadwalkan agen. frequency_type int, dan bisa menjadi salah satu nilai berikut.

Nilai Description
1 Satu kali
2 Sesuai permintaan
4 Harian
8 Mingguan
16 Bulanan
32 Relatif bulanan
64 Autostart
128 Berulang
NULL (default)

[ @frequency_interval = ] frequency_interval Menentukan hari yang dijalankan agen. frequency_interval int, dan bisa menjadi salah satu nilai berikut.

Nilai Description
1 Hari Minggu
2 Senin
3 Selasa
4 Rabu
5 Kamis
6 Jumat
7 Sabtu
8 Hari
9 Hari kerja
10 Hari akhir pekan
NULL (default)

[ @frequency_subday = ] frequency_subday Apakah unit untuk freq_subday_interval. frequency_subday int, dan bisa menjadi salah satu nilai ini.

Nilai Description
1 Satu kali
2 Second
4 Minute
8 Hour
NULL (default)

[ @frequency_subday_interval = ] frequency_subday_interval Adalah interval untuk frequency_subday. frequency_subday_interval int, dengan default NULL.

[ @frequency_relative_interval = ] frequency_relative_interval Apakah tanggal Agen Rekam Jepret berjalan. frequency_relative_interval int, dengan default NULL.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor Adalah faktor pengulangan yang digunakan oleh frequency_type. frequency_recurrence_factor int, dengan default NULL.

[ @active_start_date = ] active_start_date Adalah tanggal ketika Agen Rekam Jepret pertama kali dijadwalkan, diformat sebagai yyyyMMdd. active_start_date int, dengan default NULL.

[ @active_end_date = ] active_end_date Adalah tanggal ketika Agen Rekam Jepret berhenti dijadwalkan, diformat sebagai yyyyMMdd. active_end_date int, dengan default NULL.

[ @active_start_time_of_day = ] active_start_time_of_day Adalah waktu hari ketika Agen Rekam Jepret pertama kali dijadwalkan, diformat sebagai HHmmss. active_start_time_of_day int, dengan default NULL.

[ @active_end_time_of_day = ] active_end_time_of_day Adalah waktu hari ketika Agen Rekam Jepret berhenti dijadwalkan, diformat sebagai HHmmss. active_end_time_of_day int, dengan default NULL.

[ @snapshot_job_name = ] 'snapshot_agent_name' Adalah nama nama pekerjaan Agen Rekam Jepret yang ada jika pekerjaan yang ada sedang digunakan. snapshot_agent_name adalah nvarchar(100) dengan nilai default NULL.

[ @publisher_security_mode = ] publisher_security_mode Adalah mode keamanan yang digunakan oleh agen saat menyambungkan ke Publisher. publisher_security_mode kecil, dengan default NULL. 0 menentukan Autentikasi SQL Server, dan 1 menentukan Autentikasi Windows. Nilai 0 harus ditentukan untuk Penerbit non-SQL Server.

Penting

Jika memungkinkan, gunakan autentikasi Windows.

[ @publisher_login = ] 'publisher_login' Apakah login digunakan saat menyambungkan ke Publisher. publisher_login adalah sysname, dengan default NULL. publisher_login harus ditentukan ketika publisher_security_mode adalah 0. Jika publisher_login NULL dan publisher_security_mode adalah 1, maka akun Windows yang ditentukan dalam job_login digunakan saat menyambungkan ke Publisher.

[ @publisher_password = ] 'publisher_password' Apakah kata sandi digunakan saat menyambungkan ke Publisher. publisher_password adalah sysname, dengan default NULL.

Penting

Jangan gunakan kata sandi kosong. Gunakan kata sandi yang kuat. Jika memungkinkan, minta pengguna untuk memasukkan kredensial keamanan saat runtime. Jika Anda harus menyimpan kredensial dalam file skrip, Anda harus mengamankan file untuk mencegah akses yang tidak sah.

[ @job_login = ] 'job_login' Adalah login untuk akun Windows tempat agen berjalan. job_login adalah nvarchar(257), dengan default NULL. Akun Windows ini selalu digunakan untuk koneksi agen ke Distributor. Anda harus menyediakan parameter ini saat membuat pekerjaan Agen Rekam Jepret baru. Ini tidak dapat diubah untuk penerbit non-SQL Server.

[ @job_password = ] 'job_password' Adalah kata sandi untuk akun Windows tempat agen berjalan. job_password adalah sysname, dengan default NULL. Anda harus menyediakan parameter ini saat membuat pekerjaan Agen Rekam Jepret baru.

Penting

Jika memungkinkan, minta pengguna untuk memasukkan kredensial keamanan saat runtime. Jika Anda harus menyimpan kredensial dalam file skrip, Anda harus mengamankan file untuk mencegah akses yang tidak sah.

[ @publisher = ] 'publisher' Menentukan penerbit non-SQL Server. publisher adalah sysname, dengan default NULL.

Catatan

penerbit tidak boleh digunakan saat membuat Agen Rekam Jepret di Penerbit SQL Server.

Mengembalikan Nilai Kode

0 (berhasil) atau 1 (kegagalan)

Keterangan

sp_changepublication_snapshot digunakan dalam replikasi rekam jepret, replikasi transaksional, dan replikasi penggabungan.

Izin

Hanya anggota peran server tetap sysadmin atau peran database tetap db_owner yang dapat menjalankan sp_changepublication_snapshot.

Lihat Juga

Menampilkan dan Mengubah Properti Publikasi
Mengubah Properti Publikasi dan Artikel
sp_addpublication_snapshot (T-SQL)
Prosedur Tersimpan Sistem (Transact-SQL)