sys.fn_cdc_increment_lsn (Transact-SQL)

适用于SQL Server

根据指定的 LSN 返回序列中的下一个日志序列号 (LSN)。

Transact-SQL 语法约定

语法

  
sys.fn_cdc_increment_lsn ( lsn_value )  

参数

lsn_value

LSN 值。 lsn_valuebinary(10)。

返回类型

binary(10)

注解

此函数返回的 LSN 值始终大于指定的值,并且不存在介于这两个值之间的 LSN 值。

若要系统地查询随时间变化的更改数据流,可以定期重复调用该查询函数,每次调用时指定一个新的查询间隔来限定查询中返回的更改的范围。 为帮助确保不丢失数据,通常使用前一个查询的上限来生成后一个查询的下限。 由于查询间隔是一个闭区间,因此新的下限必须大于前一个上限,但要足够小,以确保不存在 LSN 值介于此值与旧上限之间的更改。 该函数 sys.fn_cdc_increment_lsn 用于获取此值。

权限

需要公共数据库角色的成员身份。

示例

下例将前一个查询的上限保存到变量 sys.fn_cdc_increment_lsn 中,然后根据此上限使用 @save_to_lsn 来生成变更数据捕获查询的新下限值。

USE AdventureWorks2022;  
GO  
DECLARE @from_lsn binary(10), @to_lsn binary(10), @save_to_lsn binary(10);  
SET @save_to_lsn = <previous_upper_bound_value>;  
SET @from_lsn = sys.fn_cdc_increment_lsn(@save_to_lsn);  
SET @to_lsn = sys.fn_cdc_get_max_lsn();  
SELECT * from cdc.fn_cdc_get_all_changes_HumanResources_Employee( @from_lsn, @to_lsn, 'all' );  
GO  

注意

如果提供的 LSN 范围在调用或调用cdc.fn_cdc_get_all_changes_<capture_instance>cdc.fn_cdc_get_net_changes_<capture_instance>时不适用,则预期会出现错误 313。 lsn_value如果参数超出最低 LSN 或最高 LSN 的时间,则执行这些函数将返回错误 313: Msg 313, Level 16, State 3, Line 1 An insufficient number of arguments were supplied for the procedure or function 此错误应由开发人员处理。

另请参阅