Aerospike C客户端手册———建立连接

C客户端函数库

建立连接

Aerospike对象描述一个集群。连接到一个集群,第一步需要配置一个aerospike对象。

配置客户端

要配置客户端,应提供一个初始化且填充了配置信息的as_config对象。

首先,使用as_config_init()以默认值初始化as_config:

as_config config;
as_config_init(&config);

初始化as_config完成后,使用特定于应用的设置来填充它。

最低限度,至少需要配置一个服务器地址给客户端做seed。客户端将尝试连接各个seed主机,直到成功连接上。

config.hosts[0] = { .addr = "127.0.0.1", .port = 3000 };

初始化客户端

要连接集群,首先使用前面创建的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()销毁客户端对象并且释放其所占资源:

aerospike_destroy(&as);

 

猜你喜欢

转载自jj-tyro201504151529.iteye.com/blog/2204161