C用戶端函數庫
建立連接配接
Aerospike對象描述一個叢集。連接配接到一個叢集,第一步需要配置一個aerospike對象。
配置用戶端
要配置用戶端,應提供一個初始化且填充了配置資訊的as_config對象。
首先,使用as_config_init()以預設值初始化as_config:
as_config config;
as_config_init(&config);
初始化as_config完成後,使用特定于應用的設定來填充它。
最低限度,至少需要配置一個伺服器位址給用戶端做seed。用戶端将嘗試連接配接各個seed主機,直到成功連接配接上。
初始化用戶端
要連接配接叢集,首先使用前面建立的as_config配置對象來初始化一個aerospike用戶端對象。
aerospike as;
aerospike_init(&as, &config);
aerospike_init()函數執行成功後,傳回完成初始化完成的aerospike用戶端對象,否則傳回空(NULL)。
建立連接配接
現在,使用初始化完成的aerospike用戶端對象,連接配接到叢集。 aerospike_connect()函數需要一個as_error對象來傳回出錯資訊:
as_error err;
if (aerospike_connect(&as, &err) != AEROSPIKE_OK) {
fprintf(stderr, "err(%d) %s at [%s:%d]\n", err.code, err.message, err.file, err.line);
}
函數傳回碼與err.code的值相一緻。若傳回碼不是AEROSPIKE_OK,則表明發生了錯誤,通過檢查err對象可獲得更多資訊。
一個aerospike用戶端對象内部儲存叢集狀态并維護與叢集間的連接配接池。同一個aerospike用戶端對象可被應用重用,完成給定叢集上的資料庫操作。
若應用需要連接配接到多個Aerospike叢集,應用必須建立多個aerospike用戶端對象,每個連接配接到不同叢集。
關閉連接配接
當不再需要用戶端連接配接到一個叢集時,使用aerospike_close()關閉連接配接:
as_error err;
if (aerospike_close(&as, &err) != AEROSPIKE_OK) {
fprintf(stderr, "err(%d) %s at [%s:%d]\n", err.code, err.message, err.file, err.line);
}
清理
當用戶端不再需要時,通過aerospike_destroy()銷毀用戶端對象并且釋放其所占資源:
原文連結: http://www.aerospike.com/docs/client/c/usage/connect/