Bagikan melalui


sp_MSchange_snapshot_agent_properties (T-SQL)

Berlaku untuk: SQL Server

Mengubah properti pekerjaan Agen Rekam Jepret yang berjalan di SQL Server 2005 (9.x) atau distributor versi yang lebih baru. Prosedur tersimpan ini digunakan untuk mengubah properti saat Publisher berjalan pada instans SQL Server 2000 (8.x). Prosedur tersimpan ini dijalankan di Distributor pada database distribusi.

Konvensi sintaks transact-SQL

Sintaks

sp_MSchange_snapshot_agent_properties
    [ @publisher = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'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 = ] N'snapshot_job_name'
    , [ @publisher_security_mode = ] publisher_security_mode
    , [ @publisher_login = ] N'publisher_login'
    , [ @publisher_password = ] N'publisher_password'
    , [ @job_login = ] N'job_login'
    , [ @job_password = ] N'job_password'
    , [ @publisher_type = ] N'publisher_type'
[ ; ]

Argumen

[ @publisher = ] N'publisher'

Nama Publisher. @publisher adalah sysname, tanpa default.

[ @publisher_db = ] N'publisher_db'

Nama database publikasi. @publisher_db adalah sysname, tanpa default.

[ @publication = ] N'publikasi'

Nama publikasi. @publication adalah sysname, tanpa default.

[ @frequency_type = ] frequency_type

Menentukan frekuensi di mana Agen Rekam Jepret dijalankan. @frequency_type int, dan bisa menjadi salah satu nilai ini.

Nilai Deskripsi
1 Satu kali
2 Sesuai permintaan
4 Harian
8 Mingguan
10 Bulanan
20 Bulanan, relatif terhadap interval frekuensi
40 Ketika SQL Server Agent dimulai

[ @frequency_interval = ] frequency_interval

Nilai yang akan diterapkan ke frekuensi yang ditetapkan oleh @frequency_type. @frequency_interval int, tanpa default.

[ @frequency_subday = ] frequency_subday

Unit untuk @frequency_subday_interval. @frequency_subday int, dan bisa menjadi salah satu nilai ini.

Nilai Deskripsi
1 Satu kali
2 Detik
4 Menit
8 Jam

[ @frequency_subday_interval = ] frequency_subday_interval

Interval untuk @frequency_subday. @frequency_subday_interval int, tanpa default.

[ @frequency_relative_interval = ] frequency_relative_interval

Tanggal Agen Rekam Jepret berjalan. @frequency_relative_interval int, tanpa default.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

Faktor pengulangan yang digunakan oleh @frequency_type. @frequency_recurrence_factor int, tanpa default.

[ @active_start_date = ] active_start_date

Tanggal ketika Agen Rekam Jepret pertama kali dijadwalkan, diformat sebagai yyyyMMdd. @active_start_date int, tanpa default.

[ @active_end_date = ] active_end_date

Tanggal ketika Agen Rekam Jepret berhenti dijadwalkan, diformat sebagai yyyyMMdd. @active_end_date int, tanpa default.

[ @active_start_time_of_day = ] active_start_time_of_day

Waktu hari ketika Agen Rekam Jepret pertama kali dijadwalkan, diformat sebagai HHmmss. @active_start_time_of_day int, tanpa default.

[ @active_end_time_of_day = ] active_end_time_of_day

Waktu hari ketika Agen Rekam Jepret berhenti dijadwalkan, diformat sebagai HHmmss. @active_end_time_of_day int, tanpa default.

[ @snapshot_job_name = ] N'snapshot_job_name'

Nama nama pekerjaan Agen Rekam Jepret yang ada jika pekerjaan yang ada sedang digunakan. @snapshot_job_name adalah nvarchar(100), tanpa default.

[ @publisher_security_mode = ] publisher_security_mode

Mode keamanan yang digunakan oleh agen saat menyambungkan ke Publisher. @publisher_security_mode int, tanpa default. Nilai 0 harus ditentukan untuk Penerbit non-SQL Server.

  • 0 menentukan autentikasi SQL Server
  • 1 menentukan autentikasi Windows

Jika memungkinkan, gunakan autentikasi Windows.

[ @publisher_login = ] N'publisher_login'

Login yang digunakan saat menyambungkan ke Publisher. @publisher_login adalah sysname, tanpa default. @publisher_login harus ditentukan ketika @publisher_security_mode adalah 0. Jika @publisher_login adalah NULL dan @publisher_security_mode adalah 1, maka akun Windows yang ditentukan dalam @job_login digunakan saat menyambungkan ke Publisher.

[ @publisher_password = ] N'publisher_password'

Kata sandi yang digunakan saat menyambungkan ke Publisher. @publisher_password adalah nvarchar(524), tanpa default.

Penting

Jangan simpan informasi autentikasi dalam file skrip. Untuk membantu meningkatkan keamanan, kami sarankan Anda memberikan nama login dan kata sandi pada waktu proses.

[ @job_login = ] N'job_login'

Login untuk akun Windows tempat agen berjalan. @job_login adalah nvarchar(257), tanpa default. Akun Windows ini selalu digunakan untuk koneksi agen ke Distributor. Anda harus menyediakan parameter ini saat membuat pekerjaan Agen Rekam Jepret baru. Properti ini tidak dapat diubah untuk Penerbit non-SQL Server.

[ @job_password = ] N'job_password'

Kata sandi untuk akun Windows tempat agen berjalan. @job_password adalah sysname, tanpa default. Anda harus menyediakan parameter ini saat membuat pekerjaan Agen Rekam Jepret baru.

Penting

Jangan simpan informasi autentikasi dalam file skrip. Untuk membantu meningkatkan keamanan, kami sarankan Anda memberikan nama login dan kata sandi pada waktu proses.

[ @publisher_type = ] N'publisher_type'

Menentukan jenis Publisher saat Publisher tidak berjalan dalam instans SQL Server. @publisher_type adalah sysname, dan bisa menjadi salah satu nilai berikut.

Nilai Deskripsi
MSSQLSERVER Menentukan Penerbit SQL Server.
ORACLE Menentukan Penerbit Oracle standar.
ORACLE GATEWAY Menentukan Penerbit Gateway Oracle.

Untuk informasi selengkapnya tentang perbedaan antara Penerbit Oracle dan Penerbit Gateway Oracle, lihat Gambaran Umum Penerbitan Oracle.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

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

Anda harus menentukan semua parameter saat menjalankan sp_MSchange_snapshot_agent_properties. Jalankan sp_helppublication_snapshot untuk mengembalikan properti pekerjaan Agen Rekam Jepret saat ini.

Anda dapat menggunakan sp_changepublication_snapshot di Publisher untuk mengubah properti pekerjaan Agen Rekam Jepret.

Izin

Hanya anggota peran server tetap sysadmin di Distributor yang dapat menjalankan sp_MSchange_snapshot_agent_properties.