文档

关于 SequoiaDB

快速入门

快速入门之一键清理

安装

基本操作

数据模型

SQL引擎

FileSystem引擎

S3引擎

系统架构

数据库管理

连接器

驱动

参考手册

SequoiaDB Shell方法

概述

Global

Sdb

SecureSdb

SdbCS

SdbCollection

SdbCursor

SdbQuery

SdbReplicaGroup

SdbNode

SdbDomain

Oma

File

FileContent

Cmd

Remote

Hash

IniFile

Sdbtool

Ssh

System

辅助类型对象

特殊类型对象

操作符

SQL语法

SQL to SequoiaDB 映射表

限制

错误码

故障排除

SAC 管控中心

Web服务

版本信息

Sdb()

名称

Sdb - SequoiaDB 连接对象。

语法

var db = new Sdb([hostname],[svcname])

var db = new Sdb([hostname],[svcname],[username],[password])

类别

Sdb

描述

新建一个 Sdb 对象,用于连接 SequoiaDB。

参数

参数名 参数类型 默认值 描述 是否必填
hostname string localhost 主机名
svcname int 11810 节点端口号
username string 默认为空('') 用户名
password string 默认为空('') 密码

Note:

  1. 可以通过 createUsr() 创建 SequoiaDB 的用户,并设置对应的密码。

  2. 当 SequoiaDB 没有用户时,创建 Sdb 对象可以不使用 username 和 password,否则必须使用相应的 username 和 password 去创建 Sdb 对象。

返回值

成功:返回 Sdb 对象。

失败:抛出异常。

错误

Sdb()函数常见异常如下:

错误码 错误类型 描述 解决方法
-15 SDB_NETWORK 网络错误 检查填写的地址或者端口是否可达。
-79 SDB_NET_CANNOT_CONNECT 无法连接指定的地址 检查地址、端口以及节点的配置信息是否正确。
-104 SDB_CLS_NOT_PRIMARY 分区组不存在主节点 检查当前分区组是否存在 "IsPrimary" 为 "true" 的节点。若当前分区组存在节点未启,请启动节点。
-250 SDB_CLS_NODE_BSFAULT 节点状态不正确 检查节点状态,如检查 catalog 节点是否启动。

如果出错则抛异常,并输出错误信息,可以通过getLastErrMsg()获取错误信息或通过getLastError()获取错误码。 关于错误处理可以参考常见错误处理指南

常见错误可参考错误码

版本

v1.12及以上版本。

示例

  1. 连接默认主机上的 SequoiaDB,hostname 默认为 "localhost",svcname 默认为 11810。

    > var db = new Sdb()
  2. 连接指定机器上的 SequoiaDB,目标机器 "sdbserver1"。

    > var db = new Sdb("sdbserver1",11810)
  3. 使用用户名和密码连接指定机器上的 SequoiaDB。

    > var db = new Sdb("sdbserver1",11810,"admin","123")
回到顶部