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 };初始化客户端

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);

原文链接:

译 者:歪脖大肚子Q

泪,一种痛苦的雨滴,不知从什么时候开始已在我的世界下个不停。

Aerospike C客户端手册

相关文章:

你感兴趣的文章:

标签云: