sys.sp_cdc_help_change_data_capture (T-SQL)

  • Artikel

Berlaku untuk:SQL Server

Mengembalikan konfigurasi pengambilan data perubahan untuk setiap tabel yang diaktifkan untuk mengubah pengambilan data dalam database saat ini. Hingga dua baris dapat dikembalikan untuk setiap tabel sumber, satu baris untuk setiap instans pengambilan. Mengubah pengambilan data tidak tersedia di setiap edisi SQL Server. Untuk daftar fitur yang didukung oleh edisi SQL Server, lihat Edisi dan fitur yang didukung SQL Server 2022.

Konvensi sintaks transact-SQL

Sintaks

sys.sp_cdc_help_change_data_capture
    [ [ @source_schema = ] 'source_schema' ]
    [ , [ @source_name = ] 'source_name' ]
[ ; ]

Argumen

[ @source_schema = ] 'source_schema'

Nama skema tempat tabel sumber berada. @source_schema adalah sysname, dengan default NULL. Ketika @source_schema ditentukan, @source_name juga harus ditentukan.

Jika tidak null, @source_schema harus ada di database saat ini.

Jika @source_schema bukan null, @source_name juga harus non-null.

[ @source_name = ] 'source_name'

Nama tabel sumber. @source_name adalah sysname, dengan default NULL. Ketika @source_name ditentukan, @source_schema juga harus ditentukan.

Jika tidak null, @source_name harus ada di database saat ini.

Jika @source_name non-null, @source_schema juga harus non-null.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Tataan hasil

Nama kolom Jenis data Deskripsi
source_schema nama sysname Nama skema tabel sumber.
source_table nama sysname Nama tabel sumber.
capture_instance nama sysname Nama instans pengambilan.
object_id int ID tabel perubahan yang terkait dengan tabel sumber.
source_object_id int ID tabel sumber.
start_lsn biner(10) Nomor urutan log (LSN) mewakili titik akhir rendah untuk mengkueri tabel perubahan.

NULL = titik akhir rendah belum ditetapkan.
end_lsn biner(10) LSN mewakili titik akhir tinggi untuk mengkueri tabel perubahan. Di SQL Server 2012 (11.x), kolom ini selalu NULL.
supports_net_changes bit Dukungan perubahan bersih diaktifkan.
has_drop_pending bit Tidak digunakan di SQL Server 2012 (11.x).
role_name nama sysname Nama peran database yang digunakan untuk mengontrol akses ke data perubahan.

NULL = peran tidak digunakan.
index_name nama sysname Nama indeks yang digunakan untuk mengidentifikasi baris secara unik dalam tabel sumber.
filegroup_name nama sysname Nama grup file tempat tabel perubahan berada.

NULL = ubah tabel berada di grup file default database.
create_date datetime Tanggal instans pengambilan diaktifkan.
index_column_list nvarchar(maks) Daftar kolom indeks yang digunakan untuk mengidentifikasi baris secara unik dalam tabel sumber.
captured_column_list nvarchar(maks) Daftar kolom sumber yang diambil.

Keterangan

Ketika @source_schema dan @source_name default ke NULL, atau secara eksplisit mengatur NULL, prosedur tersimpan ini mengembalikan informasi untuk semua instans penangkapan database yang dapat diakses oleh pemanggil SELECT. Saat @source_schema dan @source_name non-null, hanya informasi pada tabel tertentu yang diaktifkan bernama yang dikembalikan.

Izin

Saat @source_schema dan @source_name NULL, otorisasi pemanggil menentukan tabel yang diaktifkan mana yang disertakan dalam tataan hasil. Penelepon harus memiliki izin SELECT pada semua kolom yang diambil dari instans tangkapan dan juga keanggotaan dalam peran pembatasan yang ditentukan agar informasi tabel disertakan.

Anggota peran database db_owner dapat melihat informasi tentang semua instans pengambilan yang ditentukan. Saat informasi untuk tabel tertentu yang diaktifkan diminta, kriteria SELECT dan keanggotaan yang sama diterapkan untuk tabel bernama.

Contoh

J. Mengembalikan informasi konfigurasi pengambilan data perubahan untuk tabel tertentu

Contoh berikut mengembalikan konfigurasi pengambilan data perubahan untuk HumanResources.Employee tabel.

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_help_change_data_capture
    @source_schema = N'HumanResources',
    @source_name = N'Employee';
GO

B. Mengembalikan informasi konfigurasi pengambilan data perubahan untuk semua tabel

Contoh berikut mengembalikan informasi konfigurasi untuk semua tabel yang diaktifkan dalam database yang berisi data perubahan yang diizinkan untuk diakses oleh pemanggil.

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_help_change_data_capture;
GO