setSessionAttr - 设置会话属性
db.setSessionAttr(<options>)
Sdb
该函数用于设置会话属性。
options（ object，必填 ）
通过参数 options 可以设置会话属性：
PreferredInstance（ string/array/number ）：会话读操作优先选择的实例，默认为协调节点配置文件中参数 preferredinstance 的取值。如果节点未配置 preferredinstance，该参数默认值为 "M"。
取值类型分为角色取值和实例取值，用户可使用数组指定多个取值，具体如下：
角色取值：
实例取值：
Note:
- 同时指定实例和角色取值时，优先选择符合该实例 ID 和角色的节点。如果未匹配到对应节点，将随机选取数据组中的节点。例如取值为 [1, "S"] 时，表示优先选取实例 ID 为 1 的备节点，未匹配到对应节点时则随机选取节点。
- 符号 "-" 用于扩展角色取值。如果使用 "-" 扩展角色取值，在未匹配到对应节点的情况下，将随机选取指定角色中的节点。例如取值为 [1, "-S"] 时，如果未匹配到对应节点，将在数据组包含的备节点中随机选取节点。
- 指定多个角色取值时，角色与其扩展取值的语义相同，且只有第一个取值生效。例如取值为 ["-M", "S"] 时，仅 "-M" 生效，表示优先选择数据组中的主节点。
- 单独指定实例取值时，如果数据组内不存在对应实例 ID 的节点，节点的 instanceid 将根据数据组中 NodeID 的正序顺序，从 1 开始重新分配。同时服务端将按（实例 ID - 1）%（节点总数）对实例 ID 进行转换，转换后的值再与 instanceid 匹配获取对应节点。
- 如果同一个会话中，读请求前有写请求，有效期限内读请求将默认使用写请求使用的节点（主实例）进行读取，用户可通过配置 PreferredPeriod 修改读请求复用写请求节点的有效期限。
格式：PreferredInstance: "M" 或 PreferredInstance: [1, 10, "S"]
PreferredInstanceMode（ string ）：当存在多个候选实例时，指定会话的选择模式，默认为协调节点配置文件中参数 preferredinstancemode 的取值。如果节点未配置 preferredinstancemode，该参数默认值为 "random"。
该参数取值如下：
格式：PreferredInstaceMode: "random"
PreferredPeriod（ number ）：指定优先实例的有效周期，单位为秒，默认为协调节点配置文件中参数 preferredperiod 的取值。如果节点未配置 preferredperiod，该参数默认值为 60。
格式：PreferredPeriod: 60
PreferredStrict（ boolean ）：指定节点选择是否为严格模式，默认值为 false，表示非严格模式。
当指定为严格模式时，节点只能从参数 Preferredinstance 指定的实例取值中选取。如果 Preferredinstance 未指定实例取值，该参数不生效。
格式：PreferredStrict: true
Timeout（ number ）：会话执行操作的超时时间，超时则返回错误提示信息，单位为毫秒，默认值为 -1。
该参数最小取值为 1000 毫秒；取值为 -1 表示不进行超时检测。
格式：Timeout: 10000
TransIsolation（ number ）：会话事务的隔离级别，默认值为 0。
该参数取值如下：
格式：TransIsolation: 1
TransTimeout（ number ）：会话事务锁等待超时时间，超时则返回错误提示信息，单位为秒，默认值为 60。
格式：TransTimeout: 10
TransLockWait（ boolean ）：会话事务在 RC 隔离级别下是否需要等锁，默认值为 false，表示无需等待记录锁。
格式：TransLockWait: true
TransUseRBS（ boolean ）：会话事务是否使用回滚段，默认值为 true，表示使用回滚段。
格式：TransUseRBS: true
TransAutoCommit（ boolean ）：会话事务是否开启自动事务提交，默认值为 false，表示不开启自动事务提交。
格式：TransAutoCommit: true
TransAutoRollback（ boolean ）：会话事务在操作失败时是否自动回滚，默认值为 true，表示自动回滚。
格式：TransAutoRollback: true
TransRCCount（ boolean ）：会话事务是否使用读已提交来处理 count() 查询，默认值为 true，表示使用读已提交。
格式：TransRCCount: true
Note：
- 事务相关属性只有 TransTimeout 允许在事务中设置，其它事务属性需要在非事务中设置。
- 获取会话属性请参考 getSessionAttr()。
函数执行成功时，无返回值。
函数执行失败时，将抛异常并输出错误信息。
setSessionAttr() 函数常见异常如下：
| 错误码 | 错误类型 | 可能发生的原因 | 解决办法 |
|---|---|---|---|
| -6 | SDB_INVALIDARG | options 属性输入错误 | 检查所设置属性的值和范围等 |
当异常抛出时，可以通过 getLastErrMsg() 获取错误信息或通过 getLastError() 获取错误码，关于错误处理可以参考常见错误处理指南。
v3.4 及以上版本
指定会话优先从主实例中读数据
> db.setSessionAttr({PreferredInstance: "M"})指定会话优先从实例 ID 为 1 的备实例中读数据
> db.setSessionAttr({PreferredInstance: [1, "S"]})指定会话执行操作的超时时间为 10 秒
> db.setSessionAttr({Timeout: 10000})
