自增字段

概念

自增字段是集合中可以自动生成唯一序列的字段。集合允许拥有多个自增字段。

为保证高性能，自增字段的序列值是在编目节点中统一生成，并批量分配给协调节点的。因此默认地，自增字段的值只保证趋势递增（或递减），但不保证连续分配。以递增序列为例，如果多个协调节点同时插入数据，在小的区间内，可能会出现后插入的文档的序列值比先插入的小，但在大的区间内，数值是递增的。如需连续递增，也可以设置有关属性来实现。

属性

Note:

• 自增字段可以是嵌套字段。
• Increment为正整数时，StartValue默认为1，MinValue默认为1，MaxValue默认为2⁶³ -1。
  Increment为负整数时，StartValue默认为-1，MinValue默认为-2⁶³ ，MaxValue默认为-1。
• StartValue必须位于[MinValue,MaxValue]区间。
• 当设置AcquireSize为1时，可以实现序列连续递增（或递减）。CacheSize和AcquireSize是性能相关的参数，建议谨慎修改。
• 使用主子表时，仅主表自增字段会生效，子表自增字段无效。
• 如客户端设置过自增字段的值，或使用中修改过自增字段的属性，字段值将可能不唯一。如需保证修改后值唯一，建议使用唯一索引。
• 独立节点不支持自增字段。

SequoiaDB Shell支持的操作

• 创建

  1、可以使用 SdbCS.createCL() 接口创建集合时，在options指定AutoIncrement参数来创建。
  2、在已有的集合上使用 SdbCollection.createAutoIncrement() 来创建。

• 删除

  可通过接口 SdbCollection.dropAutoIncrement() 实现删除。

• 修改

  可通过接口 SdbCollection.setAttributes() 在options指定AutoIncrement参数修改自增字段的属性。

• 查看

  在集合的 编目信息快照 的AutoIncrement字段中，可以查看现有的自增字段。如要查看详细的自增字段属性信息，还需查找对应的 序列快照。

示例

1. 在创建集合时指定自增字段为studentID。

   > db.foo.createCL("bar", { AutoIncrement: { Field: "studentID" } })
   localhost:11810.foo.bar
   Takes 0.586001s.
   > db.foo.bar.insert({ name: "Tom" })
   Takes 0.033371s.
   > db.foo.bar.find()
   {
     "_id": {
       "$oid": "5bd7da4260ff5166c507aa22"
     },
     "name": "Tom",
     "studentID": 1
   }
   Return 1 row(s).
   Takes 0.006712s.

2. 在集合上创建起始值为5000自增字段，并修改增加间隔为10。然后查看集合自增字段属性。

   > db.foo.bar.createAutoIncrement({ Field: "studentID", StartValue: 5000 })
   Takes 0.069783s.
   > db.foo.bar.setAttributes({ AutoIncrement: { Field: "studentID", Increment: 10 } })
   Takes 0.039292s.
   >
   > db.snapshot( SDB_SNAP_CATALOG, { Name: "foo.bar" }, { AutoIncrement: 1 } )
   {
     "AutoIncrement": [
       {
         "SequenceName": "SYS_21333102559237_studentID_SEQ",
         "Field": "studentID",
         "Generated": "default",
         "SequenceID": 4
       }
     ]
   }
   Return 1 row(s).
   Takes 0.006737s.
   > 
   > db.snapshot( SDB_SNAP_SEQUENCES, { Name: "SYS_21333102559237_studentID_SEQ" } )
   {
     "AcquireSize": 1000,
     "CacheSize": 1000,
     "CurrentValue": 5000,
     "Cycled": false,
     "ID": 4,
     "Increment": 10,
     "Initial": true,
     "Internal": true,
     "MaxValue": {
       "$numberLong": "9223372036854775807"
     },
     "MinValue": 1,
     "Name": "SYS_21333102559237_studentID_SEQ",
     "StartValue": 5000,
     "Version": 1,
     "_id": {
       "$oid": "5bd8fcfc8af29ca6ad2a32e8"
     }
   }
   Return 1 row(s).
   Takes 0.012240s.

3. 在集合上创建一个嵌套和非嵌套的自增字段，然后删除非嵌套的字段。

   > db.foo.bar.createAutoIncrement([ { "Field": "No" }, { Field: "student.ID" } ])
   Takes 0.628813s.
   > db.foo.bar.insert({ student: { "name": "Tom" } })
   Takes 0.006884s.
   > db.foo.bar.find()
   {
     "_id": {
       "$oid": "5bd7e2478c74f9c1a14366ca"
     },
     "student": {
       "name": "Tom",
       "ID": 1
     },
     "No": 1
   }
   Return 1 row(s).
   Takes 0.007183s.
   > db.foo.bar.dropAutoIncrement("No")
   Takes 0.066828s.
   > db.foo.bar.insert({ student: { "name": "Jerry" } })
   Takes 0.003347s.
   > db.foo.bar.find()
   {
     "_id": {
       "$oid": "5bd7e2478c74f9c1a14366ca"
     },
     "student": {
       "name": "Tom",
       "ID": 1
     },
     "No": 1
   }
   {
     "_id": {
       "$oid": "5bd7e2b08c74f9c1a14366cb"
     },
     "student": {
       "name": "Jerry",
       "ID": 2
     }
   }
   Return 2 row(s).
   Takes 0.010535s.