sys.fn_cdc_map_lsn_to_time (Transact-SQL)

Applies to: SQL Server

Returns the date and time value from the tran_end_time column in the cdc.lsn_time_mapping system table for the specified log sequence number (LSN). You can use this function to systematically map LSN ranges to date ranges in a change table.

Transact-SQL syntax conventions

Syntax

  
sys.fn_cdc_map_lsn_to_time ( lsn_value )  

Arguments

lsn_value
Is the LSN value to match against. lsn_value is binary(10).

Return Type

datetime

Remarks

This function can be used to determine the time that a change was committed based upon the __$start_lsn value returned in the row of change data.

Permissions

Requires membership in the public role.

Examples

The following example uses the function sys.fn_cdc_map_lsn_to_time to determine the commit time associated with the last change processed in the specified LSN interval for the HumanResources_Employee capture instance.

USE AdventureWorks2022;  
GO  
DECLARE @max_lsn binary(10);  
SELECT @max_lsn = MAX(__$start_lsn)  
FROM cdc.fn_cdc_get_all_changes_HumanResources_Employee(@from_lsn, @to_lsn, 'all');  
SELECT sys.fn_cdc_map_lsn_to_time(@max_lsn);  
GO   

See Also

cdc.lsn_time_mapping (Transact-SQL)
sys.fn_cdc_map_time_to_lsn (Transact-SQL)
cdc.fn_cdc_get_net_changes_<capture_instance> (Transact-SQL)
cdc.fn_cdc_get_all_changes_<capture_instance> (Transact-SQL)