sys.sp_cdc_help_change_data_capture (Transact-SQL)
Gilt für:
SQL Server
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. Änderungsdatenerfassung ist nicht in jeder Edition von SQL Server verfügbar. Eine Liste der Funktionen, die von den SQL Server-Editionen unterstützt werden, finden Sie unter Editionen und unterstützte Funktionen von SQL Server 2022.
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 sysname mit dem Standardwert NULL. Wenn @source_schema angegeben wird, muss auch @source_name angegeben werden.
Wenn nicht NULL, muss @source_schema in der aktuellen Datenbank vorhanden sein.
Wenn @source_schema nicht NULL ist, muss @source_name auch ungleich NULL sein.
[ @source_name = ] 'source_name'
Der Name der Quelltabelle. @source_name ist sysname mit dem Standardwert NULL. Wenn @source_name angegeben wird, muss auch @source_schema angegeben werden.
Wenn nicht NULL, muss @source_name in der aktuellen Datenbank vorhanden sein.
Wenn @source_name nicht NULL ist, muss @source_schema auch ungleich 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 niedrige Endpunkt wurde nicht festgelegt. |
end_lsn |
binary(10) | LSN, die den oberen Endpunkt zum Abfragen der Änderungstabelle darstellt. In SQL Server 2012 (11.x) lautet diese Spalte immer NULL. |
supports_net_changes |
bit | Die Unterstützung für Nettoänderungen ist aktiviert. |
has_drop_pending |
bit | Nicht in SQL Server 2012 (11.x) 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 auf NULL festgelegt oder explizit NULL festgelegt werden, 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 Erfassungsinstanzen 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 Konfigurationsinformationen zur Änderungsdatenerfassung für eine angegebene Tabelle
Im folgenden Beispiel wird die Change Data Capture-Konfiguration für die HumanResources.Employee-Tabelle zurückgegeben.
USE AdventureWorks2022;
GO
EXECUTE sys.sp_cdc_help_change_data_capture
@source_schema = N'HumanResources',
@source_name = N'Employee';
GO
B. Zurückgeben von Konfigurationsinformationen zur Änderungsdatenerfassung 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 AdventureWorks2022;
GO
EXECUTE sys.sp_cdc_help_change_data_capture;
GO