Bagikan melalui

sp_repladdcolumn (T-SQL)

Berlaku untuk: SQL ServerAzure SQL Managed Instance

Menambahkan kolom ke artikel tabel yang sudah diterbitkan. Memungkinkan kolom baru ditambahkan ke semua penerbit yang menerbitkan tabel ini, atau hanya menambahkan kolom ke publikasi tertentu yang menerbitkan tabel. Prosedur tersimpan ini dijalankan di Publisher pada database publikasi.

Penting

Prosedur tersimpan ini tidak digunakan lagi, dan didukung untuk kompatibilitas mundur. Ini hanya boleh digunakan dengan Penerbit SQL Server 2000 (8.x) dan Penerbit penerbit ulang SQL Server 2000 (8.x). Prosedur ini tidak boleh digunakan pada kolom dengan jenis data yang diperkenalkan di SQL Server 2005 (9.x) dan versi yang lebih baru.

Konvensi sintaks transact-SQL

Sintaks

sp_repladdcolumn
    [ @source_object = ] N'source_object'
    , [ @column = ] N'column'
    , [ @typetext = ] N'typetext'
    [ , [ @publication_to_add = ] N'publication_to_add' ]
    [ , [ @from_agent = ] from_agent ]
    [ , [ @schema_change_script = ] N'schema_change_script' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
[ ; ]

Argumen

[ @source_object = ] N'source_object'

Nama artikel tabel yang berisi kolom baru untuk ditambahkan. @source_object adalah nvarchar(358), tanpa default.

[ @column = ] N'column'

Nama kolom dalam tabel yang akan ditambahkan untuk replikasi. @column adalah sysname, tanpa default.

[ @typetext = ] N'typetext'

Definisi kolom yang ditambahkan. @typetext adalah nvarchar(3000), tanpa default. Misalnya, jika kolom order_filled sedang ditambahkan, dan ini adalah bidang karakter tunggal, bukan null, dan memiliki nilai default N, order_filled akan menjadi parameter kolom , sementara definisi kolom, char(1) NOT NULL CONSTRAINT constraint_name DEFAULT 'N' akan menjadi nilai parameter @typetext .

[ @publication_to_add = ] N'publication_to_add'

Nama publikasi tempat kolom baru ditambahkan. @publication_to_add adalah nvarchar(4000), dengan default all. Jika all, maka semua publikasi yang berisi tabel ini terpengaruh. Jika @publication_to_add ditentukan, maka hanya publikasi ini yang menambahkan kolom baru.

[ @from_agent = ] from_agent

Menentukan apakah prosedur tersimpan sedang dijalankan oleh agen replikasi. @from_agent int, dengan default 0. Nilai digunakan ketika prosedur tersimpan 10 ini sedang dijalankan oleh agen replikasi, dan dalam setiap kasus lain nilai default harus digunakan.

[ @schema_change_script = ] N'schema_change_script'

Menentukan nama dan jalur skrip SQL Server yang digunakan untuk memodifikasi prosedur tersimpan kustom yang dihasilkan sistem. @schema_change_script adalah nvarchar(4000), dengan default NULL. Replikasi memungkinkan prosedur tersimpan kustom yang ditentukan pengguna untuk menggantikan satu atau beberapa prosedur default yang digunakan dalam replikasi transaksional. @schema_change_script dijalankan setelah perubahan skema dilakukan pada artikel tabel yang direplikasi menggunakan sp_repladdcolumn, dan dapat digunakan sebagai berikut:

  • Jika prosedur tersimpan kustom secara otomatis diregenerasi, @schema_change_script dapat digunakan untuk menghilangkan prosedur tersimpan kustom ini, dan menggantinya dengan prosedur tersimpan kustom yang ditentukan pengguna yang mendukung skema baru.

  • Jika prosedur tersimpan kustom tidak diregenerasi secara otomatis, @schema_change_script dapat digunakan untuk meregenerasi prosedur tersimpan ini atau untuk membuat prosedur tersimpan kustom yang ditentukan pengguna.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

Mengaktifkan atau menonaktifkan kemampuan untuk membatalkan rekam jepret. @force_invalidate_snapshot adalah bit, dengan default 1.

  • 1 menentukan bahwa perubahan pada artikel dapat menyebabkan rekam jepret tidak valid, dan jika demikian, nilai 1 memberikan izin untuk rekam jepret baru terjadi.

  • 0 menentukan bahwa perubahan pada artikel tidak menyebabkan rekam jepret tidak valid.

[ @force_reinit_subscription = ] force_reinit_subscription

Mengaktifkan atau menonaktifkan kemampuan untuk menginisialisasi ulang langganan. @force_reinit_subscription adalah bit, dengan default 0.

  • 0 menentukan bahwa perubahan pada artikel tidak menyebabkan langganan diinisialisasi ulang.

  • 1 menentukan bahwa perubahan pada artikel dapat menyebabkan langganan diinisialisasi ulang, dan jika demikian, nilai 1 memberikan izin untuk reinitialisasi langganan terjadi.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Izin

Hanya anggota peran server tetap sysadmin dan peran database tetap db_owner yang dapat menjalankan sp_repladdcolumn.

Konten terkait

  • Last updated on