createDataSource()

名称

createDataSource - 创建数据源

语法

db.createDataSource( <name>, <address>, [user], [password], [type], [options] )

类别

Sdb

描述

该函数用于创建数据源，以实现跨集群的数据访问。

参数

• name（ string，必填 ）

  数据源名称，同一数据库中该名称唯一

• address（ string，必填 ）

  作为数据源的 SequoiaDB 集群中所有或部分协调节点地址；配置多个地址时，需确保地址所指向的协调节点存在于同一集群中，且地址数不超过七个

• user（ string，选填 ）

  数据源用户名

• password（ string，选填 ）

  与 user 对应的数据源用户密码

• type（ string，选填 ）

  数据源类型，当前仅支持 SequoiaDB

• options（ object，选填 ）

  通过 options 参数可以设置其他选填参数

  1. AccessMode（string）：配置对该数据源的访问权限，包括读写数据，默认值为"ALL"

     取值如下：

     • "READ"：允许进行只读操作
     • "WRITE"：允许进行写操作
     • "ALL"或"READ|WRITE"：允许进行所有操作
     • "NONE"：不允许进行任何操作

     格式：AccessMode:"READ"

  2. ErrorFilterMask（string ）：配置对数据源进行数据操作的错误过滤，默认值为"NONE"

     取值如下：

     • "READ"：过滤数据读错误
     • "WRITE"：过滤数据写错误
     • "ALL"或"READ|WRITE"：过滤所有数据读写错误
     • "NONE"：不对任何错误进行过滤

     格式：ErrorFilterMask:"READ"

  3. ErrorControlLevel（string ）：配置对映射集合或集合空间进行不支持的数据操作（如 DDL）时的报错级别，默认值为"High"

     取值如下：

     • "High"：报错并输出错误信息
     • "Low"：忽略不支持的数据操作且不执行

     格式：ErrorControlLevel:"Low"

返回值

函数执行成功时，将返回一个 DataSource 对象。

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

错误

createDataSource() 函数常见异常如下：

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

版本

v3.2.8 及以上版本

示例

创建一个名为“datasource”的数据源，该数据源只允许进行只读操作

> db.createDataSource("datasource","192.168.20.66:50000","","","SequoiaDB",{AccessMode:"READ"})