C开发基础

    这里介绍如何使用 C 客户端驱动接口编写使用 SequoiaDB 数据库的程序。为了简单起见，下面的例子不全部是完整的代码，只起示例性作用。可到 /sequoiadb/client/samples/C 下获取相应的完整的代码。

    • 数据库连接（Connecting）编写完整客户端文件 connect.c 演示连接到数据库。文件必须包含“client.h”头文件。

    在 Linux 下，可以如下编译及链接动态链接库文件 libsdbc.so。

    1. $ gcc -o connect connect.c -I /< PATH >/sdbdriver/include -lsdbc -L /< PATH >/sdbdriver/lib
    2. $ ./connect localhost 11810 "" ""
    3. connect success!
    • 创建集合空间，集合
    1. // 首先，定义集合空间、集合句柄。
    2. sdbCSHandle collectionspace       = 0 ;
    3. sdbConnectionHandle connection    = 0 ;
    4. // 创建集合空间"foo"
    5. rc = sdbCreateCollectionSpace ( connection, "foo", SDB_PAGESIZE_4K, &collectionspace ) ;  
    6. // 在新建立的集合空间中创建集合"bar"
    7. rc = sdbCreateCollection ( collectionspace, "bar", &collection ) ;

    Note:

    在创建集合“bar”时并没有附加分区、压缩等信息，关于创建集合的更详细情况，请参考详情请查阅 C API

    • 插入数据

    SequoiaDB 存储数据采用 BSON 的格式，BSON 是一种类似 JSON 的二进制对象。保存数据库中的数据，首先必须创建 bson 对象。下面会将{name:"Tom",age:24}插入到集合中。

    • 查询

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

    1. // 定义一个游标句柄
    2. sdbCursorHandle cursor = 0 ;
    3. ...
    4. // 查询所有记录，查询结果放在游标句柄中
    5. rc = sdbQuery(collection, NULL, NULL, NULL, NULL, 0, -1, &cursor ) ;
    6. bson_init( &obj );
    7. while( !( rc=sdbNext( cursor, &obj ) ) )
    8. {
    9.    bson_print( &obj ) ;
    10.    bson_destroy( &obj ) ;
    11.    bson_init( &obj );
    12. }
    13. bson_destroy( &obj ) ;
    • 索引
    1. #define INDEX_NAME "index"
    2. ...
    3. // 首先创建一 bson 对象包含将要创建的索引的信息
    4. bson_init( &obj ) ;
    5. bson_append_int( &obj, "name", 1 ) ;
    6. bson_append_int( &obj, "age", -1 ) ;
    7. rc = bson_finish( &obj ) ;
    8. if ( rc != SDB_OK )
    9. printf("Error.");
    10. // 创建一个以"name"为升序，"age"为降序的索引
    11. rc = sdbCreateIndex ( collection, &obj, INDEX_NAME, FALSE, FALSE ) ;
    12. bson_destroy ( &obj ) ;

    此处，我们在集合句柄 collection 指定的集合中更新记录。因为没有指定数据匹配规则，所以此示例将更新集合中所有的集合。

    此处，因为没有指定记录匹配条件，所以此示例将更新集合句柄 collection 指定的集合中所有的记录。

    集群操作

    • 分区组操作

    分区组操作包括创建分区组（sdbCreateReplicaGroup），得到分区组句柄（sdbGetReplicaGroup），启动分区组（sdbStartReplicaGroup），停止分区组（sdbStopReplicaGroup）等。以下为分区组操作示例性的例子。真正的应用应包括错误检测等。

    1. // 定义一个分区组句柄
    2. sdbReplicaGroupHandle rg = 0 ;
    3. ...
    4. // 先建立一个编目分区组
    5. rc = sdbCreateCataReplicaGroup ( connection, HOST_NAME, SERVICE_NAME, CATALOG_SET_PATH , NULL ) ;
    6. // 创建数据分区组
    7. rc = sdbCreateReplicaGroup ( connection, GROUP_NAME, &rg ) ;
    8. // 创建数据节点
    9. rc = sdbCreateNode ( rg, HOST_NAME1, SERVICE_NAME1, DATABASE_PATH1, NULL ) ;
    10. // 启动分区组
    11. rc = sdbStartReplicaGroup( rg ) ;
    • 数据节点操作

    数据节点操作包括创建数据节点（sdbCreateNode），得到主数据节点（sdbGetNodeMaster），得到从数据节点（sdbGetNodeSlave），启动数据节点（sdbStartNode），停止数据节点（sdbStopNode）等。以下为数据节点操作示例性的例子。真正的应用应包括错误检测等。

    1. // 定义一个数据节点句柄
    2. sdbNodeHandle masternode   = 0 ;
    3. sdbNodeHandle slavenode    = 0 ;
    4. ...
    5. // 获取主数据节点
    6. rc = sdbGetNodeMaster ( rg, &masternode ) ;
    7. //获取从数据节点
    8. rc = sdbGetNodeSlave ( rg, &slavenode ) ;