Freigeben über


sys.sp_cdc_help_change_data_capture (Transact-SQL)

Gilt für: SQL Server

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 (erfolgreich) 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 Standardeinstellung NULLoder explizit festgelegt NULLsind, gibt diese gespeicherte Prozedur Informationen für alle Instanzen der Datenbankerfassung 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 sind NULL, 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