sys.sp_cdc_help_change_data_capture (T-SQL)

Artikel
08/21/2024

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 pengambilan 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 adalah 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

Bagikan melalui