文档中心

setAttributes()

名称

setAttributes - 修改序列的属性

语法

sequence.setAttributes(<options>)

类别

SdbSequence

描述

该函数用于修改序列的当前值、起始值、最小值、最大值等属性。

参数

options( object必填

通过 options 参数可以修改序列的属性:

  • CurrentValue( number ):序列当前值

    格式:CurrentValue : <num>

  • StartValue( number ):序列起始值

    格式:StartValue : <num>

  • MinValue( number ):序列最小值

    格式:MinValue : <num>

  • MaxValue( number ):序列最大值

    格式:MaxValue : <num>

  • Increment( number ):序列每次增加的间隔

    格式:Increment : <num>

  • CacheSize( number ):编目节点每次缓存的序列值的数量

    格式:CacheSize : <num>

  • AcquireSize( number ):协调节点每次获取的序列值的数量

    格式:AcquireSize : <num>

  • Cycled( boolean ):序列值达到最大值或最小值时是否允许循环

    格式:Cycled : true | false

返回值

函数执行成功时,无返回值。

函数执行失败时,将抛异常并输出错误信息。

错误

当异常抛出时,可以通过 getLastErrMsg() 获取错误信息或通过 getLastError() 获取错误码。更多错误处理可以参考常见错误处理指南

版本

v3.4.2 及以上版本

示例

修改序列当前值

> var sequence = db.createSequence( "IDSequence" )
> sequence.setAttributes( { CurrentValue: 1000 } )
回到顶部