Python 客户端驱动提供了数据库操作和集群操作的接口。
Python 客户端驱动的有两种类实例。一种用于数据库操作,另一种用于集群操作。
SequoiaDB 巨杉数据库中的数据存放分为三个级别:
数据库
集合空间
集合
因此,在数据库操作中,可用三个类来分别表示连接、集合空间和集合实例,一个类表示游标实例。
类 | 名称 | 描述 |
---|---|---|
client | 数据库类 | 连接实例代表一个单独的数据库连接 |
collectionspace | 集合空间类 | 集合空间实例代表一个单独的集合空间 |
collection | 集合类 | 集合实例代表一个单独的集合 |
cursor | 游标类 | 游标实例代表一个查询产生的游标 |
Python 客户端需要使用不同的实例进行操作,例如:读取数据的操作需要游标实例,而创建表空间则需要数据库实例。
SequoiaDB 巨杉数据库中的集群操作分为两个级别:
复制组
数据节点
Note:
复制组包含协调复制组、编目复制组和数据复制组三种类型。
复制组实例和数据节点实例可以用以下两种类的实例表示:
类 | 名称 | 描述 |
---|---|---|
replicagroup | 复制组类 | 复制组实例代表一个单独的复制组 |
replicanode | 节点类 | 节点实例代表一个单独的节点 |
replicagroup 的实例用于管理复制组。其操作包括启动、停止复制组,获取复制组中节点的状态、名称信息、数目信息等。
replicanode 的实例用于管理节点。其操作包括启动或停止指定的节点、获取指定节点实例、获取主从节点实例、获取数据节点地址信息等。
Note:
与集群相关的操作需要使用复制组及数据节点实例
每个函数都有返回值,返回值的定义如下:
SDB_OK(数据值为 0):表示执行成功
< 0 :表示数据库错误,具体的错误描述在 err.prop
文件中可以找到,也可以用 pysequoiadb.getErr(error_no) 获取
> 0 :表示操作系统错误,请查阅相关系统的错误码信息