• Python开发基础
    • 数据库操作
    • 集群操作

    Python开发基础

    本节介绍使用Python运行SequoiaDB。首先安装SequoiaDB,安装信息请查看安装章节。

    这里介绍如何使用Python客户端驱动接口编写使用SequoiaDB数据库的程序。为了简单起见,下面的示例不全是完整的代码,只起示例性作用。可到SequoiadDB安装路径下samples/Python下获取相应的完整的代码。更多查看Python API

    Note:在Python中构造BSON时默认使用dict,dict的字段是无序的。如果要求BSON中的字段顺序与输入顺序一致(例如,创建索引时索引键的定义),请使用collections.OrderedDict。

    数据库操作

    • 数据库连接(Connecting)

    以下是connect.py演示如何连接到数据库。

    1. import pysequoiadb
    2. from pysequoiadb import client
    3.  
    4. # connect to local db, using default args value.
    5. host = 'localhost'
    6. port = 11810
    7. # user= '', password= ''
    8. db = client(host, port)
    9.  
    10. # if no error occurs, connect to specified server successfully
    11. print 'Connect success'
    12. db.disconnect()

    在Linux下,可以直接运行python解释执行connect.py。

    Note:

    本例程连接到本地数据库的服务端口11810,使用的是空的用户名和密码。用户需要根据自己的实际情况配置参数。譬如,将上述代码中的 db = client() 修改为 db = client('192.168.10.188', 11810)。当数据库已经创建用户时,应该使用正确的用户及密码连接到数据库,否则连接失败。

    • 创建集合空间和集合

    以下创建了一个名字为“foo”的集合空间和一个名字为“bar”的集合,集合空间内的集合的数据页大小为16k。可根据实际情况选择不同大小的数据页。创建集合后,可对集合做增删改查等操作。

    1. # connect to db
    2. db = client("localhost", 11810)
    3.  
    4. # create collection space
    5. cs_name = 'foo'
    6. cs = db.create_collection_space(cs_name)
    7.  
    8. cl_name = 'bar'
    9. cl = cs.create_collection(cl_name)
    • 插入数据(insert)
    1. # creat dict object
    2. record = {"name":"Tom", "age":24}
    3. oid = cl.insert ( record ) ;

    record为输入参数,为要插入的数据。dict对象将会被转换成bson插入到集合中。oid 是插入该记录时,返回的bson结构的objectid。

    • 查询(query)
    1. import pysequoiadb
    2. from pysequoiadb import client
    3. from pysequoiadb.error import SDBEndOfCursor
    4.  
    5. cr = cl.query()
    6. while True:
    7. try:
    8. record = cr.next()
    9. print(record)
    10. except SDBEndOfCursor:
    11. break
    12. finally:
    13. cr.close()

    查询操作需要一个游标对象存放查询的结果到本地。要获得查询的结果需要使用游标操作。本例使用了游标操作的next接口,表示从查询结果中取到一条记录。此示例中没有设置查询条件,筛选条件,排序情况,及仅使用默认索引。

    • 索引(index)
    1. index_name = "index_name"
    2. idx = OrderedDict([('name', 1), ('age', -1)])
    3. cl.create_index ( idx, index_name, False, False ) ;

    集合对象collection中创建一个以“name”为升序,“age”为降序的索引。

    • 更新(update)
    1. rule = {"$set":{ "age":19}}
    2. print rule
    3. cl.update( rule )

    在集合对象 ollection中更新了记录。实例中没有指定数据匹配规则,所以此示例将更新集合中所有的集合。

    • 错误处理

    调用 API 遇到的异常时,python 驱动会将异常直接抛出。可以选择捕获异常,并打印异常信息或是进行一些其他操作。SDBBaseError 异常是基础异常,异常主要包含errcode、detail 和 error_object。异常的详情可以查询 Python API。示例如下:

    1. try:
    2. cl = db.get_collection("foo.bar")
    3. condition = {"_id":{"$oid":"5d035e2bb4d450b04fcd0dff"}}
    4. cl.delete ( condition=condition )
    5. except SDBBaseError as e:
    6. print(e.detail)
    7.  
    8. """
    9. 异常信息为:
    10. pysequoiadb.error.SDBInvalidArgument: SDB_INVALIDARG(-6), Invalid Argument, detail: Failed to delete
    11. """

    集群操作

    分区组操作包括创建分区组(client::creat_replica_group),得到分区组实例(client:: get_replica_group_by_name 和 client:: get_replica_group_by_id),启动分区组所有节点(replicagroup::start),停止分区组所有节点(replicagroup::stop)等。

    • 分区组操作

    以下仅作为示例,真正的应用应包括错误检测等。

    1. rg = db.create_replica_group ("group1")
    2.  
    3. config = {}
    4. rg.create_node ('ubuntu-test-03', '20000', "/opt/sequoiadb/database/20000", config)
    5.  
    6. rg.start ()

    创建名为group1的数据组。创建节点时,定义一个空的map对象config表示该节点没有更多的配置内容。

    • 节点操作

    节点操作包括创建节点(replicagroup::create_node),获取主节点(replicagroup::get_master),获取备节点(replicagroup::get_slave),启动节点(replicanode::start),停止节点(replicanode::stop)等。

    以下为数据节点操作示例性的例子。真正的应用应包括错误检测等。

    1. # 获取数据组group
    2. rg = db.get_replica_group_by_name("group1")
    3.  
    4. # 获取数据主节点
    5. master = rg.get_master() ;
    6.  
    7. # 获取数据备节点
    8. slave = rg.get_slave() ;