sys.sp_cdc_help_change_data_capture (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed Instance

Returnerar konfigurationen för ändringsdatainsamling för varje tabell som är aktiverad för insamling av ändringsdata i den aktuella databasen. Upp till två rader kan returneras för varje källtabell, en rad för varje avbildningsinstans. Ä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_help_change_data_capture
    [ [ @source_schema = ] 'source_schema' ]
    [ , [ @source_name = ] 'source_name' ]
[ ; ]

Arguments

[ @source_schema = ] "source_schema"

Namnet på det schema som källtabellen tillhör. @source_schema är sysname med standardvärdet NULL. När @source_schema anges måste @source_name också anges.

Om det inte är null måste @source_schema finnas i den aktuella databasen.

Om @source_schema inte är null måste @source_name också vara icke-null.

[ @source_name = ] "source_name"

Namnet på källtabellen. @source_name är sysname med standardvärdet NULL. När @source_name anges måste @source_schema också anges.

Om det inte är null måste @source_name finnas i den aktuella databasen.

Om @source_name inte är null måste @source_schema också vara icke-null.

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.
object_id	int	ID för den ändringstabell som är associerad med källtabellen.
source_object_id	int	ID för källtabellen.
start_lsn	binary(10)	Loggsekvensnummer (LSN) som representerar den låga slutpunkten för att fråga ändringstabellen. NULL = den låga ändpunkten har inte fastställts.
end_lsn	binary(10)	LSN som representerar den höga slutpunkten för att köra frågor mot ändringstabellen. I SQL Server 2012 (11.x) är den här kolumnen alltid NULL.
supports_net_changes	bit	Stöd för nettoändring är aktiverat.
has_drop_pending	bit	Används inte i SQL Server 2012 (11.x).
role_name	sysname	Namnet på den databasroll som används för att styra åtkomsten till ändringsdata. NULL = en roll används inte.
index_name	sysname	Namnet på indexet som används för att unikt identifiera rader i källtabellen.
filegroup_name	sysname	Namnet på filgruppen där ändringstabellen finns. NULL = ändringstabellen finns i databasens standardfilgrupp.
create_date	datetime	Datum då avbildningsinstansen aktiverades.
index_column_list	nvarchar(max)	Lista över indexkolumner som används för att unikt identifiera rader i källtabellen.
captured_column_list	nvarchar(max)	Lista över insamlade källkolumner.

Anmärkningar

När både @source_schema och @source_name standardvärdet NULL, eller uttryckligen anges, returnerar den NULLhär lagrade proceduren information för alla databasinsamlingsinstanser som anroparen har SELECT-åtkomst till. När @source_schema och @source_name inte är null returneras endast information om den specifika namngivna aktiverade tabellen.

Permissions

När @source_schema och @source_name är NULLavgör anroparens auktorisering vilka aktiverade tabeller som ingår i resultatuppsättningen. Anropare måste ha SELECT-behörighet för alla insamlade kolumner i insamlingsinstansen och även medlemskap i alla definierade gating-roller för att tabellinformationen ska inkluderas.

Medlemmar i db_owner databasrollen kan visa information om alla definierade instanser av avbildningar. När information för en specifik aktiverad tabell begärs tillämpas samma SELECT- och medlemskapsvillkor för den namngivna tabellen.

Examples

A. Returnera konfigurationsinformation för ändringsdatainsamling för en angiven tabell

I följande exempel returneras konfigurationen för ändringsdatainsamling för HumanResources.Employee tabellen.

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_help_change_data_capture
    @source_schema = N'HumanResources',
    @source_name = N'Employee';
GO

B. Returnera konfigurationsinformation för ändringsdatainsamling för alla tabeller

I följande exempel returneras konfigurationsinformation för alla aktiverade tabeller i databasen som innehåller ändringsdata som anroparen har behörighet att komma åt.

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_help_change_data_capture;
GO