sys.sp_cdc_help_change_data_capture (Transact-SQL)

Gilt für:yes SQL Server (alle unterstützten Versionen)

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. Change Data Capture ist nicht in jeder Edition von MicrosoftSQL Server verfügbar. Eine Liste der Funktionen, die von den SQL Server-Editionen unterstützt werden, finden Sie unter Von den SQL Server 2016-Editionen unterstützte Funktionen.

Topic link iconTransact-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 vom Datentyp sysname und hat den Standardwert NULL. Wenn source_schema angegeben wird, muss auch source_name angegeben werden.

Wenn nicht NULL ist, muss source_schema in der aktuellen Datenbank vorhanden sein.

Wenn source_schema ungleich NULL ist, muss source_name auch ungleich NULL sein.

[ @source_name = ] '@source_name'
Der Name der Quelltabelle. source_name ist vom Datentyp sysname und hat den Standardwert NULL. Wenn source_name angegeben wird, müssen auch source_schema angegeben werden.

Wenn nicht NULL ist, muss source_name in der aktuellen Datenbank vorhanden sein.

Wenn source_name ungleich NULL ist, muss source_schema auch ungleich NULL sein.

Rückgabecodewerte

„0“ (erfolgreich) oder „1“ (fehlerhaft)

Resultsets

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 untere Endpunkt wurde nicht erstellt.
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.

Bemerkungen

Wenn sowohl source_schema als auch source_name Standardwert NULL haben oder explizit NULL festgelegt sind, gibt diese gespeicherte Prozedur Informationen für alle Datenbankerfassungsinstanzen zurück, auf die der Aufrufer SELECT-Zugriff hat. Wenn source_schema und source_name ungleich NULL sind, werden nur Informationen zur bestimmten 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 Aufzeichnungsinstanzen 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 Change Data Capture-Konfigurationsinformationen für eine angegebene Tabelle

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

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

B. Zurückgeben von Change Data Capture-Konfigurationsinformationen 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 AdventureWorks2012;  
GO  
EXECUTE sys.sp_cdc_help_change_data_capture;  
GO