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.
.gif "Themenlink (Symbol)")
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 AdventureWorks;
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 AdventureWorks;
GO
EXECUTE sys.sp_cdc_help_change_data_capture;
GO