How to Start SequoiaDB

Basic Operation

Data Model

Database Management








Release Note


  • Content
  • Comments
  • History



SequoiaDB Java driver provides an interface database operations, and cluster operations. Includes the following seven levels of operation: database, collection space, collection, cursor, replica group, node, domain, lob.For more details, please refer to the online Java API

There are two driving Java class instances. A database operation, another operation for the cluster.

  • Class sample

    There are 3 degree of data in SequoiaDB:

    1) Database

    2) Collection space

    3) Collection

    Logically, every collection space in SequoiaDB has no physical upper boundary. Every collection space is stored in a stand-alone file. So the amount of collection space depends on the size of disk and memory.

    A collection space contains at most 4096 collections. Every collection can contain more than one record. In a physical system, the size of a collection space is at most 256GB.

    Compared with relation database, we can regard record as line in relation database. We can regard collection as table in relation database.

    So in client, there are 3 Handles representing connection, collectionspace and collection, including 1 handle represents cursor, 1 handle represents LOB:

    Sequoiadb Database instance It represents a stand-alone connection
    CollectionSpace Collection space instance It represents a stand-alone collection space
    DBCollection Collection instance It represents a stand-alone collection
    DBCursor Cursor Instance It represents a result set of a query
    DBLob LOB instance Represents a LOB

    SequoiaDB only builds one Socket connection, and it does not lock the network operation internally. If more threads are needed to connect the database, each thread must create a new Sequoiadb object by itself respectively, and also the CollectionSpace/DBColltion/DBCursor objects belong to each Sequoiadb.

  • Cluster Operation

    SequoiaDB database mainly has three levels of cluster operations:

    1) Replica Group

    2) Data Node

    3) Domain

    Note: There are two types of replica group: Catalog Replica Group and Data Replica Group.

    Replica group instance and data node instance can be represented by the instance of the following three classes.

    ReplicaGroup Replica group class Each instance stands for a single replica group
    Node Data node class Each instance stands for a single data node
    sdbDomain Domain class Each instance stands for a domain which

    Replica group and data node instances are needed for the cluster-related operations.

    A ReplicaGroup instance is used to manipulate the replica groups. Its operations include start/stop the replica groups, get the status, name, and amount of the nodes in the replica groups.

    A Node instance is used to manipulate the node. Its operations include start/stop the node, get the specified node instances, obtain the master-slave node example, get data node address information.

    A sdbDomain instance is used to manipulate the domain. Its operations include modify the domains, and get the information of the domains.

Error Information

  • When excecution exceptions occur, most APIs will throw com.sequoiadb.exception.BaseExceptio or java.lang.Exception, correspond to the exception info returned from the database engine or returned from local client respectively.

  • BaseException's exception detailed info can be gotten by the class's getErrorType(), getErrorCode() and getMessage() methods.
please login to comment.
Latest Comment
  • 2015-03-14

About Us

SequoiaDB is a financial-level distributed database vendor and is the first Chinese database listed in Gartner’s Magic Quadrant OPDBMS report. SequoiaDB has recently released version 3.0.
SequoiaDB is now penetrating the vertical sector Financial Industry quickly and had more than 50 banking clients and hundreds of enterprise customers in industries including government, telecommunication, Internet and IoT.

Tower R, No.8 North Star East Road, Chaoyang District, Beijing,China
Tower A, No.22 Qinglan Street, Panyu District, Guangzhou,China
Tsing Hua Tech Park, Nanshan District, Shenzhen,China