sys.sp_cdc_get_captured_columns (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Gibt Metadateninformationen von Change Data Capture für die aufgezeichneten Quellspalten zurück, die von der angegebenen Aufzeichnungsinstanz nachverfolgt wurden. Änderungsdatenerfassung ist in jeder Edition von SQL Server nicht 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_get_captured_columns
    [ @capture_instance = ] 'capture_instance'
[ ; ]

Argumente

[ @capture_instance = ] 'capture_instance'

Der Name der Aufnahmeinstanz, die einer Quelltabelle zugeordnet ist. @capture_instance ist "sysname" und darf nicht NULL sein.

Führen Sie zum Melden der Aufnahmeinstanzen für die Tabelle die sys.sp_cdc_help_change_data_capture gespeicherte Prozedur aus.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Resultset

Spaltenname Datentyp Beschreibung
source_schema sysname Name des Quelltabellenschemas.
source_table sysname Name der Quelltabelle.
capture_instance sysname Name der Aufzeichnungsinstanz.
column_name sysname Name der aufgezeichneten Quellspalte.
column_id int ID der Spalte in der Quelltabelle.
column_ordinal int Position der Spalte innerhalb der Quelltabelle.
data_type sysname Spaltendatentyp.
character_maximum_length int Maximale Zeichenlänge der zeichenbasierten Spalte; andernfalls NULL.
numeric_precision tinyint Genauigkeit der Spalte, wenn sie auf numerischen Werten basiert; andernfalls NULL.
numeric_precision_radix smallint Basis der Genauigkeit der Spalte, wenn sie auf numerischen Werten basiert; andernfalls NULL.
numeric_scale int Dezimalstellen der Spalte, wenn sie auf numerischen Werten basiert; andernfalls NULL.
datetime_precision smallint Genauigkeit der Spalte, wenn sie auf datetime-Werten basiert; andernfalls NULL.

Hinweise

Dient sys.sp_cdc_get_captured_columns zum Abrufen von Spalteninformationen zu den erfassten Spalten, die durch Abfragen der Abfragefunktionen der Erfassungsinstanzabfragen cdc.fn_cdc_get_all_changes_<capture_instance> oder cdc.fn_cdc_get_net_changes_<capture_instance> zurückgegeben werden. Die Spaltennamen, IDs und Position bleiben während der Lebensdauer der Aufzeichnungsinstanz konstant. Nur die Spaltendatentypen ändern sich, wenn sich der Datentyp der zugrunde liegenden Quellspalte in der nachverfolgten Tabelle ändert. Spalten, die einer Quelltabelle hinzugefügt oder gelöscht werden, wirken sich nicht auf die erfassten Spalten vorhandener Aufnahmeinstanzen aus.

Verwenden Sie sys.sp_cdc_get_ddl_history , um Informationen zu DDL-Anweisungen (Data Definition Language) abzurufen, die auf eine Quelltabelle angewendet werden. Alle DDL-Änderungen, die die Struktur einer nachverfolgten Quellspalte geändert haben, werden im Resultset zurückgegeben.

Berechtigungen

Hierfür ist die Mitgliedschaft in der festen Datenbankrolle db_owner erforderlich. Für alle anderen Benutzer ist die SELECT-Berechtigung für alle aufgezeichneten Spalten in der Quelltabelle und, wenn eine Gatingrolle für die Aufzeichnungsinstanz definiert wurde, eine Mitgliedschaft in dieser Datenbankrolle erforderlich. Wenn der Aufrufer nicht über die Berechtigung zum Anzeigen der Quelldaten verfügt, gibt die Funktion Den Fehler 22981 (Object doesn't exist or access is denied.) zurück.

Beispiele

Im folgenden Beispiel werden Informationen zu den aufgezeichneten Spalten in der HumanResources_Employee-Aufzeichnungsinstanz zurückgegeben.

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_get_captured_columns
    @capture_instance = N'HumanResources_Employee';
GO

Zugehöriger Inhalt