Skip to content

Latest commit

 

History

History
67 lines (53 loc) · 2.71 KB

sys-fn-cdc-map-lsn-to-time-transact-sql.md

File metadata and controls

67 lines (53 loc) · 2.71 KB
title description author ms.author ms.date ms.service ms.subservice ms.topic f1_keywords helpviewer_keywords dev_langs
sys.fn_cdc_map_lsn_to_time (Transact-SQL)
sys.fn_cdc_map_lsn_to_time (Transact-SQL)
rwestMSFT
randolphwest
03/14/2017
sql
system-objects
reference
sys.fn_cdc_map_lsn_to_time_TSQL
sys.fn_cdc_map_lsn_to_time
fn_cdc_map_lsn_to_time_TSQL
fn_cdc_map_lsn_to_time
sys.fn_cdc_map_lsn_to_time
fn_cdc_map_lsn_to_time
TSQL

sys.fn_cdc_map_lsn_to_time (Transact-SQL)

[!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

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)