sys.sp_cdc_help_change_data_capture (Transact-SQL)

  • Artikel

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 Microsoft SQL Server verfügbar. Eine Liste der Funktionen, die von den Editionen von SQL Server unterstützt werden, finden Sie unter Von den SQL Server 2012-Editionen unterstützte Funktionen.

Themenlink (Symbol) 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 vom Datentyp sysname. Der Standardwert ist NULL. Wenn source_schema angegeben ist, muss auch source_name angegeben sein.

    Bei einem anderen Wert als NULL muss source_schema in der aktuellen Datenbank vorhanden sein.

    Wenn source_schema nicht NULL ist, muss source_name ebenfalls nicht NULL sein.

  • [ @source\_name = ] 'source_name'
    Der Name der Quelltabelle. source_name ist vom Datentyp sysname. Der Standardwert ist NULL. Wenn source_name angegeben ist, muss auch source_schema angegeben sein.

    Bei einem anderen Wert als NULL muss source_name in der aktuellen Datenbank vorhanden sein.

    Wenn source_schema nicht NULL ist, muss source_name ebenfalls nicht NULL sein.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

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 hat diese Spalte immer den Wert NULL.

supports_net_changes

bit

Die Unterstützung für Nettoänderungen ist aktiviert.

has_drop_pending

bit

Wird in SQL Server 2012 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 source_schema und source_name den Standardwert NULL annehmen oder explizit auf NULL festgelegt werden, gibt diese gespeicherte Prozedur Informationen für alle Aufzeichnungsinstanzen der Datenbank zurück, für die der Aufrufer über SELECT-Zugriff verfügt. Wenn source_schema und source_name nicht NULL sind, werden nur Informationen zu der spezifischen, benannten, aktivierten Tabelle zurückgegeben.

Berechtigungen

Wenn source_schema und source_name NULL sind, bestimmt die Autorisierung des Aufrufers die Tabellen, die in das Resultset einbezogen werden. 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 Datenbankrolle db_owner 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