sp_register_custom_scripting (T-SQL)

Artikel
05/23/2023

Berlaku untuk: SQL Server

Replikasi memungkinkan prosedur tersimpan kustom yang ditentukan pengguna untuk menggantikan satu atau beberapa prosedur default yang digunakan dalam replikasi transaksional. Ketika perubahan skema dilakukan pada tabel yang direplikasi, prosedur tersimpan ini dibuat ulang. sp_register_custom_scripting mendaftarkan prosedur tersimpan atau file skrip Transact-SQL yang dijalankan ketika perubahan skema terjadi pada skrip definisi untuk prosedur tersimpan kustom baru yang ditentukan pengguna. Prosedur tersimpan kustom baru yang ditentukan pengguna ini harus mencerminkan skema baru untuk tabel. sp_register_custom_scripting dijalankan di Publisher pada database publikasi, dan file skrip terdaftar atau prosedur tersimpan dijalankan di Pelanggan ketika perubahan skema terjadi.

Konvensi sintaks transact-SQL

Sintaks

  
sp_register_custom_scripting [ @type  = ] 'type'  
    [ @value = ] 'value'   
    [ , [ @publication = ] 'publication' ]  
    [ , [ @article = ] 'article' ]

Argumen

[ @type = ] 'type' Adalah jenis prosedur atau skrip tersimpan kustom yang didaftarkan. jenisnya adalah varchar(16), tanpa default, dan bisa menjadi salah satu nilai berikut.

Nilai	Deskripsi
memasukkan	Prosedur tersimpan kustom terdaftar dijalankan ketika pernyataan INSERT direplikasi.
memperbarui	Prosedur tersimpan kustom terdaftar dijalankan ketika pernyataan UPDATE direplikasi.
hapus	Prosedur tersimpan kustom terdaftar dijalankan ketika pernyataan DELETE direplikasi.
custom_script	Skrip dijalankan di akhir pemicu bahasa definisi data (DDL).

[ @value = ] 'value' Nama prosedur atau nama tersimpan dan jalur yang sepenuhnya memenuhi syarat ke file skrip Transact-SQL yang sedang didaftarkan. nilainya adalah nvarchar(1024), tanpa default.

Catatan

Menentukan NULL untuk parameter nilaiakan membatalkan pendaftaran skrip yang terdaftar sebelumnya, yang sama dengan menjalankan sp_unregister_custom_scripting.

Ketika nilai jenis custom_script, nama dan jalur lengkap file skrip Transact-SQL diharapkan. Jika tidak, nilai harus berupa nama prosedur tersimpan terdaftar.

[ @publication = ] 'publication' Nama publikasi tempat prosedur atau skrip tersimpan kustom sedang didaftarkan. publikasi adalah sysname, dengan default NULL.

[ @article = ] 'article' Nama artikel tempat prosedur atau skrip tersimpan kustom sedang didaftarkan. artikel adalah sysname, dengan default NULL.

Mengembalikan Nilai Kode

0 (berhasil) atau 1 (kegagalan)

Keterangan

sp_register_custom_scripting digunakan dalam rekam jepret dan replikasi transaksional.

Prosedur tersimpan ini harus dijalankan sebelum membuat perubahan skema ke tabel yang direplikasi. Untuk informasi selengkapnya tentang menggunakan prosedur tersimpan ini, lihat Meregenerasi Prosedur Transaksional Kustom untuk Mencerminkan Perubahan Skema.

Izin

Hanya anggota peran server tetap sysadmin , peran database tetap db_owner , atau peran database tetap db_ddladmin yang dapat dijalankan sp_register_custom_scripting.

Lihat Juga

sp_unregister_custom_scripting (T-SQL)

Bagikan melalui