文档首页 > > 开发指南> SQL参考> 函数和操作符> SEQUENCE函数

SEQUENCE函数

分享
更新时间: 2019/11/12 GMT+08:00

序列函数为用户从序列对象中获取后续的序列值提供了简单的多用户安全的方法。

  • nextval(regclass)

    描述:递增序列并返回新值。

    • 为了避免从同一个序列获取值的并发事务被阻塞, nextval操作不会回滚;也就是说,一旦一个值已经被抓取, 那么就认为它已经被用过了,并且不会再被返回。 即使该操作处于事务中,当事务之后中断,或者如果调用查询结束不使用该值,也是如此。这种情况将在指定值的顺序中留下未使用的"空洞"。 因此,DWS序列对象不能用于获得"无间隙"序列。
    • 如果nextval被下推到DN上时,各个DN会自动连接GTM,请求next values值,例如(insert into t1 select xxx,t1某一列需要调用nextval函数),由于GTM上有最大连接数为8192的限制,而这类下推语句会导致消耗过多的GTM连接数,因此对于这类语句的并发数目限制为7000(其它语句需要占用部分连接)/集群DN数目。

    返回类型:bigint

    示例:

    select nextval('seqDemo'); 
     nextval
    ---------
           2
    (1 row)
  • currval(regclass)

    返回当前会话里最近一次nextval返回的指定的sequence的数值。如果当前会话还没有调用过指定的sequence的nextval,那么调用currval将会报错。需要注意的是,这个函数在默认情况下是不支持的,需要通过设置enable_beta_features为true之后,才能使用这个函数。同时在设置enable_beta_features为true之后,nextval()函数将不支持下推。

    返回类型:bigint

    示例:

    select currval('seq1'); 
     currval
    ---------
           2
    (1 row)
  • lastval()

    描述:返回当前会话里最近一次nextval返回的数值。这个函数等效于currval,只是它不用序列名为参数,它抓取当前会话里面最近一次nextval使用的序列。如果当前会话还没有调用过nextval,那么调用lastval将会报错。

    需要注意的是,这个函数在默认情况下是不支持的,需要通过设置enable_beta_features或者lastval_supported为true之后,才能使用这个函数。同时这种情况下,nextval()函数将不支持下推。

    返回类型:bigint

    示例:

    select lastval(); 
     lastval
    ---------
           2
    (1 row)
  • setval(regclass, bigint)

    描述:设置序列的当前数值。

    返回类型:bigint

    示例:

    select setval('seqDemo',1);
     setval
    --------
          1
    (1 row)
  • setval(regclass, bigint, boolean)

    描述:设置序列的当前数值以及is_called标志。

    返回类型:bigint

    示例:

    select setval('seqDemo',1,true);
     setval
    --------
          1
    (1 row)

    Setval后当前会话及GTM上会立刻生效,但如果其他会话有缓存的序列值,只能等到缓存值用尽才能感知Setval的作用。所以为了避免序列值冲突,setval要谨慎使用。

    因为序列是非事务的,setval造成的改变不会由于事务的回滚而撤销。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区