sys.sp_cdc_help_change_data_capture (Transact-SQL)

Artikel
12/22/2023

Gibt die Change Data Capture-Konfiguration für jede Tabelle zurück, die in der aktuellen Datenbank für Change Data Capture aktiviert ist. Für jede Quelltabelle können bis zu zwei Zeilen zurückgegeben werden: eine Zeile für jede Aufzeichnungsinstanz. Änderungsdatenerfassung ist in jeder Edition von SQL Server nicht verfügbar. Eine Liste der Funktionen, die von den SQL Server-Editionen unterstützt werden, finden Sie unter Editionen und unterstützte Funktionen von SQL Server 2022.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @source_schema = ] 'source_schema'

Der Name des Schemas, zu dem die Quelltabelle gehört. @source_schema ist "sysname" mit der Standardeinstellung "NULL. Wenn @source_schema angegeben wird, muss auch @source_name angegeben werden.

Wenn keine Null ist, muss @source_schema in der aktuellen Datenbank vorhanden sein.

Wenn @source_schema ungleich NULL ist, muss @source_name auch nicht null sein.

[ @source_name = ] 'source_name'

Der Name der Quelltabelle. @source_name ist "sysname" mit einem Standardwert von NULL. Wenn @source_name angegeben wird, muss auch @source_schema angegeben werden.

Wenn keine Null ist, muss @source_name in der aktuellen Datenbank vorhanden sein.

Wenn @source_name ungleich NULL ist, muss @source_schema auch nicht null sein.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Resultset

Spaltenname	Datentyp	Beschreibung
`source_schema`	sysname	Name des Quelltabellenschemas.
`source_table`	sysname	Name der Quelltabelle.
`capture_instance`	sysname	Name der Aufzeichnungsinstanz.
`object_id`	int	ID der Änderungstabelle, die der Quelltabelle zugeordnet ist.
`source_object_id`	int	ID der Quelltabelle.
`start_lsn`	binary(10)	Protokollfolgenummer (Log Sequence Number, LSN), die den unteren Endpunkt zum Abfragen der Änderungstabelle darstellt. NULL = der niedrige Endpunkt wurde nicht eingerichtet.
`end_lsn`	binary(10)	LSN, die den oberen Endpunkt zum Abfragen der Änderungstabelle darstellt. In SQL Server 2012 (11.x) ist diese Spalte immer NULL.
`supports_net_changes`	bit	Die Unterstützung für Nettoänderungen ist aktiviert.
`has_drop_pending`	bit	Wird in SQL Server 2012 (11.x) nicht verwendet.
`role_name`	sysname	Name der Datenbankrolle, mit deren Hilfe der Zugriff auf die Änderungsdaten gesteuert wird. NULL = eine Rolle wird nicht verwendet.
`index_name`	sysname	Name des Indexes, mit dessen Hilfe Zeilen in der Quelltabelle eindeutig identifiziert werden.
`filegroup_name`	sysname	Name der Dateigruppe, in der sich die Änderungstabelle befindet. NULL = Die Änderungstabelle befindet sich in der Standarddateigruppe der Datenbank.
`create_date`	datetime	Datum, an dem die Aufzeichnungsinstanz aktiviert wurde.
`index_column_list`	nvarchar(max)	Liste der Indexspalten, mit deren Hilfe Zeilen in der Quelltabelle eindeutig identifiziert werden.
`captured_column_list`	nvarchar(max)	Liste der aufgezeichneten Quellspalten.

Hinweise

Wenn sowohl @source_schema als auch @source_name Standard auf NULL festgelegt oder explizit null festgelegt werden, gibt diese gespeicherte Prozedur Informationen für alle Datenbankerfassungsinstanzen zurück, auf die der Aufrufer SELECT-Zugriff hat. Wenn @source_schema und @source_name nicht null sind, werden nur Informationen zur spezifischen benannten aktivierten Tabelle zurückgegeben.

Berechtigungen

Wenn @source_schema und @source_name NULL sind, bestimmt die Autorisierung des Aufrufers, welche aktivierten Tabellen im Resultset enthalten sind. Aufrufer müssen über die SELECT-Berechtigung für alle aufgezeichneten Spalten der Aufzeichnungsinstanz verfügen und zudem Mitglied aller definierten Gatingrollen für die einzubeziehenden Tabelleninformationen sein.

Mitglieder der db_owner-Datenbankrolle können Informationen zu allen definierten Erfassungsinstanzen anzeigen. Beim Anfordern von Informationen für eine bestimmte aktivierte Tabelle werden auf die benannte Tabelle die gleichen SELECT- und Mitgliedschaftskriterien angewendet.

Beispiele

.A Zurückgeben von Konfigurationsinformationen zur Datenerfassung von Änderungen für eine angegebene Tabelle

Im folgenden Beispiel wird die Change Data Capture-Konfiguration für die HumanResources.Employee-Tabelle zurückgegeben.

USE AdventureWorks2022;
GO

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

B. Zurückgeben von Konfigurationsinformationen zur Datenerfassung von Änderungen für alle Tabellen

Im folgenden Beispiel werden Konfigurationsinformationen für alle aktivierten Tabellen in der Datenbank zurückgegeben, die Änderungsdaten enthalten, auf die der Aufrufer zugreifen darf.

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_help_change_data_capture;
GO