Freigeben über


sys.sp_cdc_help_change_data_capture (Transact-SQL)

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 nur in den Editionen SQL Server 2008 Enterprise, Developer und Evaluation verfügbar.

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, in das die Quelltabelle gehört. source_schema ist vom Datentyp sysname und hat den Standardwert 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 und hat den Standardwert 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 2008 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 2008 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 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 AdventureWorks2008R2;
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 AdventureWorks2008R2;
GO
EXECUTE sys.sp_cdc_help_change_data_capture;
GO

Siehe auch

Andere Ressourcen