sp_addsubscriber (T-SQL)
Berlaku untuk: SQL ServerAzure SQL Database
Menambahkan Pelanggan baru ke Penerbit, memungkinkannya menerima publikasi. Prosedur tersimpan ini dijalankan di Penerbit pada database publikasi untuk rekam jepret dan publikasi transaksional; dan untuk penggabungan publikasi menggunakan Distributor jarak jauh, prosedur tersimpan ini dijalankan di Distributor.
Penting
Prosedur tersimpan ini sudah tidak digunakan lagi. Anda tidak lagi diharuskan mendaftarkan Pelanggan secara eksplisit di Penerbit.
Sintaks
sp_addsubscriber
[ @subscriber = ] N'subscriber'
[ , [ @type = ] type ]
[ , [ @login = ] N'login' ]
[ , [ @password = ] N'password' ]
[ , [ @commit_batch_size = ] commit_batch_size ]
[ , [ @status_batch_size = ] status_batch_size ]
[ , [ @flush_frequency = ] flush_frequency ]
[ , [ @frequency_type = ] frequency_type ]
[ , [ @frequency_interval = ] frequency_interval ]
[ , [ @frequency_relative_interval = ] frequency_relative_interval ]
[ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]
[ , [ @frequency_subday = ] frequency_subday ]
[ , [ @frequency_subday_interval = ] frequency_subday_interval ]
[ , [ @active_start_time_of_day = ] active_start_time_of_day ]
[ , [ @active_end_time_of_day = ] active_end_time_of_day ]
[ , [ @active_start_date = ] active_start_date ]
[ , [ @active_end_date = ] active_end_date ]
[ , [ @description = ] N'description' ]
[ , [ @security_mode = ] security_mode ]
[ , [ @encrypted_password = ] encrypted_password ]
[ , [ @publisher = ] N'publisher' ]
[ ; ]
Argumen
[ @subscriber = ] N'pelanggan'
Nama server yang akan ditambahkan sebagai Pelanggan yang valid ke publikasi di server ini. @subscriber adalah sysname, tanpa default.
[ @type = ] jenis
Jenis Pelanggan. @type kecil, dan bisa menjadi salah satu nilai ini.
Nilai | Deskripsi |
---|---|
0 (default) |
Pelanggan SQL Server |
1 |
Server sumber data ODBC |
2 |
Database Microsoft Jet |
3 |
Penyedia OLE DB |
[ @login = ] N'login'
ID masuk untuk Autentikasi SQL Server. @login adalah sysname, dengan default NULL
.
Catatan
Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur. Properti sekarang ditentukan berdasarkan per langganan saat menjalankan sp_addsubscription. Saat nilai ditentukan, nilai tersebut digunakan sebagai default saat membuat langganan di Pelanggan ini dan pesan peringatan dikembalikan.
[ @password = ] N'password'
Kata sandi untuk Autentikasi SQL Server. @password adalah nvarchar(524), dengan default NULL
.
Jangan gunakan kata sandi kosong. Gunakan kata sandi yang kuat.
Catatan
Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur. Properti sekarang ditentukan berdasarkan per langganan saat menjalankan sp_addsubscription. Saat nilai ditentukan, nilai tersebut digunakan sebagai default saat membuat langganan di Pelanggan ini dan pesan peringatan dikembalikan.
[ @commit_batch_size = ] commit_batch_size
Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur.
Saat nilai ditentukan, nilai tersebut digunakan sebagai default saat membuat langganan di Pelanggan ini dan pesan peringatan dikembalikan.
[ @status_batch_size = ] status_batch_size
Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur.
Saat nilai ditentukan, nilai tersebut digunakan sebagai default saat membuat langganan di Pelanggan ini dan pesan peringatan dikembalikan.
[ @flush_frequency = ] flush_frequency
Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur.
Saat nilai ditentukan, nilai tersebut digunakan sebagai default saat membuat langganan di Pelanggan ini dan pesan peringatan dikembalikan.
[ @frequency_type = ] frequency_type
Menentukan frekuensi untuk menjadwalkan agen replikasi. @frequency_type int, dan bisa menjadi salah satu nilai ini.
Nilai | Deskripsi |
---|---|
1 |
Satu kali |
2 |
Sesuai permintaan |
4 |
Harian |
8 |
Mingguan |
16 |
Bulanan |
32 |
Relatif bulanan |
64 (default) |
Mulai Otomatis |
128 |
Berulang |
Catatan
Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur. Properti sekarang ditentukan berdasarkan per langganan saat menjalankan sp_addsubscription. Saat nilai ditentukan, nilai tersebut digunakan sebagai default saat membuat langganan di Pelanggan ini dan pesan peringatan dikembalikan.
[ @frequency_interval = ] frequency_interval
Nilai yang diterapkan ke frekuensi yang ditetapkan oleh @frequency_type. @frequency_interval int, dengan default 1
.
Catatan
Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur. Properti sekarang ditentukan berdasarkan per langganan saat menjalankan sp_addsubscription. Saat nilai ditentukan, nilai tersebut digunakan sebagai default saat membuat langganan di Pelanggan ini dan pesan peringatan dikembalikan.
[ @frequency_relative_interval = ] frequency_relative_interval
Tanggal agen replikasi. Parameter ini digunakan ketika @frequency_type diatur ke 32
(relatif bulanan). @frequency_relative_interval int, dan bisa menjadi salah satu nilai ini.
Nilai | Deskripsi |
---|---|
1 (default) |
First |
2 |
Detik |
4 |
Ketiga |
8 |
Keempat |
16 |
Last |
Catatan
Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur. Properti sekarang ditentukan berdasarkan per langganan saat menjalankan sp_addsubscription. Saat nilai ditentukan, nilai tersebut digunakan sebagai default saat membuat langganan di Pelanggan ini dan pesan peringatan dikembalikan.
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Faktor pengulangan yang digunakan oleh @frequency_type. @frequency_recurrence_factor int, dengan default 0
.
Catatan
Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur. Properti sekarang ditentukan berdasarkan per langganan saat menjalankan sp_addsubscription. Saat nilai ditentukan, nilai tersebut digunakan sebagai default saat membuat langganan di Pelanggan ini dan pesan peringatan dikembalikan.
[ @frequency_subday = ] frequency_subday
Seberapa sering untuk menjadwalkan ulang selama periode yang ditentukan. @frequency_subday int, dan bisa menjadi salah satu nilai ini.
Nilai | Deskripsi |
---|---|
1 |
Satu kali |
2 |
Detik |
4 (default) |
Menit |
8 |
Jam |
Catatan
Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur. Properti sekarang ditentukan berdasarkan per langganan saat menjalankan sp_addsubscription. Saat nilai ditentukan, nilai tersebut digunakan sebagai default saat membuat langganan di Pelanggan ini dan pesan peringatan dikembalikan.
[ @frequency_subday_interval = ] frequency_subday_interval
Interval untuk frequency_subday. @frequency_subday_interval int, dengan default 5
.
Catatan
Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur. Properti sekarang ditentukan berdasarkan per langganan saat menjalankan sp_addsubscription. Saat nilai ditentukan, nilai tersebut digunakan sebagai default saat membuat langganan di Pelanggan ini dan pesan peringatan dikembalikan.
[ @active_start_time_of_day = ] active_start_time_of_day
Waktu hari ketika agen replikasi pertama kali dijadwalkan, diformat sebagai HHmmss
. @active_start_time_of_day int, dengan default 0
.
Catatan
Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur. Properti sekarang ditentukan berdasarkan per langganan saat menjalankan sp_addsubscription. Saat nilai ditentukan, nilai tersebut digunakan sebagai default saat membuat langganan di Pelanggan ini dan pesan peringatan dikembalikan.
[ @active_end_time_of_day = ] active_end_time_of_day
Waktu hari ketika agen replikasi berhenti dijadwalkan, diformat sebagai HHmmss
. @active_end_time_of_day int, dengan default 235959
, yang berarti 11:59:59 P.M. sebagaimana diukur pada jam 24 jam.
Catatan
Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur. Properti sekarang ditentukan berdasarkan per langganan saat menjalankan sp_addsubscription. Saat nilai ditentukan, nilai tersebut digunakan sebagai default saat membuat langganan di Pelanggan ini dan pesan peringatan dikembalikan.
[ @active_start_date = ] active_start_date
Tanggal ketika agen replikasi pertama kali dijadwalkan, diformat sebagai yyyyMMdd
. @active_start_date int, dengan default 0
.
Catatan
Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur. Properti sekarang ditentukan berdasarkan per langganan saat menjalankan sp_addsubscription. Saat nilai ditentukan, nilai tersebut digunakan sebagai default saat membuat langganan di Pelanggan ini dan pesan peringatan dikembalikan.
[ @active_end_date = ] active_end_date
Tanggal ketika agen replikasi berhenti dijadwalkan, diformat sebagai yyyyMMdd
. @active_end_date int, dengan default 99991231
, yang berarti 31 Desember 9999.
Catatan
Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur. Properti sekarang ditentukan berdasarkan per langganan saat menjalankan sp_addsubscription. Saat nilai ditentukan, nilai tersebut digunakan sebagai default saat membuat langganan di Pelanggan ini dan pesan peringatan dikembalikan.
[ @description = ] N'description'
Deskripsi teks Pelanggan. @description adalah nvarchar(255), dengan default NULL
.
[ @security_mode = ] security_mode
Mode keamanan yang diterapkan. @security_mode int, dengan default 1
.
0
menentukan autentikasi SQL Server.1
menentukan autentikasi Windows.
Catatan
Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur. Properti sekarang ditentukan berdasarkan per langganan saat menjalankan sp_addsubscription. Saat nilai ditentukan, nilai tersebut digunakan sebagai default saat membuat langganan di Pelanggan ini dan pesan peringatan dikembalikan.
[ @encrypted_password = ] encrypted_password
Parameter ini tidak digunakan lagi dan disediakan hanya untuk kompatibilitas mundur. Mengatur @encrypted_password ke nilai apa pun tetapi 0
menghasilkan kesalahan.
[ @publisher = ] N'publisher'
Menentukan Penerbit Non-SQL Server. @publisher adalah sysname, dengan default NULL
.
@publisher tidak boleh digunakan saat menerbitkan dari Penerbit SQL Server.
Mengembalikan nilai kode
0
(berhasil) atau 1
(kegagalan).
Keterangan
sp_addsubscriber
digunakan dalam replikasi rekam jepret, replikasi transaksional, dan replikasi penggabungan.
sp_addsubscriber
tidak diperlukan ketika Pelanggan hanya memiliki langganan anonim untuk menggabungkan publikasi.
sp_addsubscriber
menulis ke tabel MSsubscriber_info dalam database distribusi .
Izin
Hanya anggota peran server tetap sysadmin yang dapat menjalankan sp_addsubscriber
.