sys.sp_cdc_get_captured_columns (Transact-SQL)

Gäller för:SQL Server

Returnerar metadata för förändringsdatafångst för de infångade källkolumnerna som spåras av den angivna fångstinstansen. Ändringsdataregistrering finns inte tillgänglig i varje utgåva av SQL Server. En lista över funktioner som stöds av versionerna av SQL Server finns i Utgåvor och funktioner som stöds i SQL Server 2022.

Transact-SQL syntaxkonventioner

Syntax

sys.sp_cdc_get_captured_columns [ @capture_instance = ] N'capture_instance'
[ ; ]

Arguments

[ @capture_instance = ] N'capture_instance'

Namnet på fångstinstansen kopplad till en källtabell. @capture_instance är sysname och kan inte vara NULLdet.

För att rapportera om fångstinstanserna för tabellen, kör sys.sp_cdc_help_change_data_capture stored proceduren.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

Kolumnnamn Datatyp Description
source_schema sysname Namnet på källtabellschemat.
source_table sysname Namnet på källtabellen.
capture_instance sysname Namnet på avbildningsinstansen.
column_name sysname Namnet på den erövrade källkolumnen.
column_id int ID för kolumnen i källtabellen.
column_ordinal int Kolumnens position inom källtabellen.
data_type sysname Kolumndatatyp.
character_maximum_length int Maximal teckenlängd för den teckenbaserade kolumnen; annars, NULL.
numeric_precision tinyint Precision för kolumnen om den är numerisk. annars . NULL
numeric_precision_radix smallint Precisionsradix för kolumnen om numerisk; annars, NULL.
numeric_scale int Kolumnens skala om den är numerisk; annars, NULL.
datetime_precision smallint Kolumnens precision om den är date-time-baserad; annars, NULL.

Remarks

Använd sys.sp_cdc_get_captured_columns för att få kolumninformation om de fångade kolumnerna genom att fråga fångstinstansens frågefunktioner cdc.fn_cdc_get_all_changes_<capture_instance> eller cdc.fn_cdc_get_net_changes_<capture_instance>. Kolumnnamnen, ID:n och positionen förblir konstanta under hela fångstinstansens livslängd. Endast kolumndatatypen ändras när datatypen för den underliggande källkolumnen i den spårade tabellen ändras. Kolumner som läggs till eller tas bort från en källtabell påverkar inte de fångade kolumnerna i befintliga capture-instanser.

Använd sys.sp_cdc_get_ddl_history för att få information om data definition language (DDL)-satser applicerade på en källtabell. Alla DDL-ändringar som modifierade strukturen hos en spårad källkolumn returneras i resultatuppsättningen.

Permissions

Kräver medlemskap i den db_owner fasta databasrollen. För alla andra användare kräver SELECT-behörighet för alla insamlade kolumner i källtabellen och, om en gating-roll för insamlingsinstansen har definierats, medlemskap i den databasrollen. När anroparen inte har behörighet att visa källdatan returnerar funktionen felmeddelande 22981 (Object doesn't exist or access is denied.).

Examples

Följande exempel ger information om de fångade kolumnerna i HumanResources_Employee fångstinstansen.

USE AdventureWorks2022;
GO

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

Relaterat innehåll

  • Last updated on