设为首页 加入收藏

TOP

AerospikeC客户端手册―――数据扫描―记录扫描
2015-07-24 10:30:48 来源: 作者: 【 】 浏览:1
Tags:AerospikeC 客户端 手册 数据 扫描 记录

记录扫描

Aerospike C客户端提供扫描指定namespace和set中所有记录的能力。
扫描可使用扫描API定义。使用扫描API,可以初始化和填充一个as_scan对象。
以初始化过的as_scan,可用下面任一个操作执行扫描:
aerospike_scan_foreach() — 执行扫描并对每个记录调用一个函数。
aerospike_scan_background() — 执行扫描但不要结果,提供检查扫描状态的能力。

使用foreach处理结果

函数aerospike_scan_foreach()执行扫描,对查找到的记录逐个调用回调函数。回调函数的型构是:

typedef bool (*aerospike_scan_foreach_callback)(const as_val *value, void *udata);

这个回调函数在扫描期间找到的每条记录上被调用,记录通过参数value传递,用户提供数据由参数udata传递。需注意到value的类型是const as_val *,意味着回调函数没有责任去销毁value,并且value仅在回调函数作用域中可见。回调函数不能将value传递到函数作用域以外。

没有更多的结果需要处理时,会以NULL做为参数value的值调用回调函数。

对于正常的扫描操作,value将是一个记录,可简单地使用as_record_fromval()转换成记录对象。若参数value是个记录,此函数返回一个记录对象;否则返回空值(NULL)。也可使用as_val_type()检查value的类型。

bool callback(const as_val *value, void *udata) { if (value == NULL) { // scan is complete return true; } as_record *rec = as_record_fromval(value); if (rec != NULL) { // process record } return true; }

检查后台扫描状态

函数aerospike_scan_background()把发送扫描请求发给到数据库执行,客户端不用等待结果。客户端会被返给一个扫描id(scan id),用来检查扫描的运行状态。

扫描id能用来周期性检查扫描的状态,理想状况下,应用将根据获取到的扫描状态,智能判断轮询状态的频度。

扫描的状态信息被填充到as_scane_info实例对象中:

as_scan_info scan_info; if (aerospike_scan_info(&as, &err, NULL, scan_id, &scan_info) != AEROSPIKE_OK) { fprintf(stderr, "err(%d) %s at [%s:%d]\n", err.code, err.message, err.file, err.line); }

以上代码只是很简单地检查状态,并假设状态检查只做一次。

若应用持续跟踪运行已用时间,那在获取状态后就能通过检查scan_info的成员域progress_pct,估计出扫描还将占用多长时间,。


】【打印繁体】【投稿】【收藏】 【推荐】【举报】【评论】 【关闭】 【返回顶部
分享到: 
上一篇报表开发实例――动态多层次KPI钻.. 下一篇Redis数据结构(二)字典

评论

帐  号: 密码: (新用户注册)
验 证 码:
表  情:
内  容:

·TCP/UDP协议_百度百科 (2025-12-26 12:20:11)
·什么是TCP和UDP协议 (2025-12-26 12:20:09)
·TCP和UDP详解 (非常 (2025-12-26 12:20:06)
·Python 教程 - W3Sch (2025-12-26 12:00:51)
·Python基础教程,Pyt (2025-12-26 12:00:48)