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 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.
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