sys.fn_cdc_increment_lsn (Transact-SQL)
适用于:SQL Server
根据指定的 LSN 返回序列中的下一个日志序列号 (LSN)。
语法
sys.fn_cdc_increment_lsn ( lsn_value )
参数
lsn_value
LSN 值。 lsn_value为 binary(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
此错误应由开发人员处理。