| title | sys.fn_cdc_map_lsn_to_time (Transact-SQL) | ||||
|---|---|---|---|---|---|
| description | sys.fn_cdc_map_lsn_to_time (Transact-SQL) | ||||
| author | rwestMSFT | ||||
| ms.author | randolphwest | ||||
| ms.date | 03/14/2017 | ||||
| ms.service | sql | ||||
| ms.subservice | system-objects | ||||
| ms.topic | reference | ||||
| f1_keywords |
|
||||
| helpviewer_keywords |
|
||||
| dev_langs |
|
[!INCLUDE 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.
:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions
sys.fn_cdc_map_lsn_to_time ( lsn_value )
lsn_value
Is the LSN value to match against. lsn_value is binary(10).
datetime
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.
Requires membership in the public role.
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
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)