概述
C++ 用戶端驅動提供了資料庫操作和叢集操作的接口。主要包括以下8個級别的操作:
- 資料庫
- 集合空間
- 集合
- 遊标
- 副本組
- 節點
- 域
- 大對象
C++ 類執行個體
C++ 用戶端驅動有兩種類執行個體。一種用于資料庫操作,另一種用于叢集操作。
-
資料庫操作執行個體
SequoiaDB 資料庫中的資料存放分為三個級别:
1)資料庫
2)集合空間
3)集合
是以,在資料庫操作中,可用3個類來分别表示資料庫連接配接,集合空間,集合,1個類表示遊标,1個類表示大對象:
類 | 名稱 | 描述 |
---|---|---|
sdb | 資料庫類 | 該類主要用于管理整個資料庫,包括建立連接配接,建立集合空間等 |
sdbCollectionSpace | 集合空間類 | 該類主要用于管理集合 |
sdbCollection | 集合類 | 該類主要用于對資料進行增删改查等操作 |
sdbCursor | 遊标類 | 該類主要用于周遊查詢、快照傳回的結果,遊标執行個體代表一個查詢産生的遊标 |
sdbLob | 大對象類 | 該類主要用于對大對象進行讀寫等操作 |
C++ 用戶端需要使用不同的執行個體進行操作。譬如讀取資料的操作需要遊标執行個體,而建立集合空間則需要資料庫執行個體。
Note:
(1)對于每一個連接配接,其産生的集合空間,集合,與遊标句柄共用一個套接字。是以在多線程系統中,必須確定每個線程不會同時針對同一套接字,在同一時間發送或接收資料。
(2)一般來說,不建議使用多個線程共同操作一個連接配接句柄與其産生的其它句柄。
(3)如果每個線程使用自己的連接配接句柄以及其它産生的句柄,則可以保證線程安全。
-
叢集操作執行個體
SequoiaDB 資料庫中的叢集操作分為三個級别:
1)分區組
2)資料節點
3)域
Note:
分區組包括三種類型:編目分區組,協調分區組,資料分區組。
與叢集相關的操作需要使用分區組及資料節點執行個體。類 名稱 描述 sdbReplicaGroup 分區組類 分區組執行個體代表一個單獨的分區組 sdbNode 資料節點類 資料節點執行個體代表一個單獨的資料節點 sdbDomain 域類 域執行個體代表一個管理若幹個分區組的域 - sdbReplicaGroup 的執行個體用于管理分區組。其操作包括啟動、停止分區組,擷取分區組中節點的狀态、名稱資訊、數目資訊。
- sdbNode 的執行個體用于管理資料節點。其操作包括啟動、停止指定的資料節點,擷取資料節點位址資訊。
- sdbDomain 的執行個體用于管理域。其包括修改域,擷取域資訊等操作。
錯誤資訊
每個函數都有傳回值,傳回值的定義如下:
SDB_OK(資料值為0):表示執行成功;
< 0 :表示資料庫錯誤,具體的錯誤描述在 C++ 驅動開發包中 include/ossErr.h 檔案中可以找到;
> 0 :表示系統錯誤,請查閱相關系統的錯誤碼資訊。
更多内容可點選巨杉資料庫官網檢視。