Aerospike C客户端手册———错误处理

错误处理

每个数据库操作均接受一个as_error对象做为参数。当在操作期间发生错误,参数as_error会被填入状态码和错误信息。通常,参数as_error是数据库操作的第二个参数。

as_error提供的信息包括:

  • code — 操作的状态,类型是as_status。
  • message — 错误码相应的信息。若操作成功完成,此信息可能为空(NULL)。
  • func — 错误发生的函数名。若未能正确捕获,可能为空(NULL)。
  • file — 错误发生的文件名。若未能正确捕获,可能为空(NULL)。
  • line — 错误发生的文件行号。若未能正确捕获,可能为0。

当操作完成,返回一个as_status类型的值,此值对应于as_error.code。若操作返回失败状态,一般是非AEROSPIKE_OK, 应用应检查as_error变量以取得更多信息。请参见as_status.h获取完成列表。

一个as_error变量可重用于多个操作,每个操作会重置as_error并在出错时设值。

下面是一个错误处理的简单示例:

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

原文链接: http://www.aerospike.com/docs/client/c/usage/error.html

译      者: 歪脖大肚子Q

时间: 2024-10-07 00:16:46

Aerospike C客户端手册———错误处理的相关文章

Aerospike C客户端手册———用户定义函数—应用UDF到记录

应用UDF到记录 Aerospike C客户端API提供aerospike_key_apply()来应用一个用户定义函数到数据库中某记录. 在使用aerospike_key_apply()操作前,包含被应用函数的UDF模块,必须首先注册到Aerospike服务器.请参见[注册用户定义函数]章节来学习如何使用C API注册,或阅读[aql手册]学习如何使用外部工具注册. 下面的代码引用自示例目录[examples/basic_examples/get],由Aerospike C客户端安装包自带.

Aerospike C客户端手册———用户定义函数—注册用户定义函数

注册用户定义函数 Aerospike C 客户端提供在数据库中注册.更新或移除一个用户定义函数(UDF)模块的能力.目前,用户定义函数仅支持LUA语言. aerospike_udf_put() - 注册或更新UDF模块. aerospike_udf_remove() - 移除UDF模块. 下面的代码引用自示例目录[examples/basic_examples/udf],由Aerospike C客户端安装包自带. 请先阅读[创建连接]章节内容,理解如何建立与集群的连接. 从文件读取UDF 很可能

Aerospike C客户端手册———查询—查询记录

查询记录 查询时除了使用主索引,Aerospike C客户端也提供API来通过检索次索引查询数据库. 为了使用次索引查询数据,首先应初始化并填充一个as_query对象:然后,以初始化完成的as_query对象,使用aerospike_query_foreach()执行查询.一个查询可以: 对返回的满足条件记录逐个调用回调函数. 对返回的满足条件记录集合应用流式用户定义函数(StreamUDF),再对StreamUDF返回结果调用回调用函数. 此章节专注于第一种方式,如想了解第二种方式,请参见[

Aerospike C客户端手册———数据扫描—记录扫描

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

Aerospike C客户端手册———日志

日志 Aerospike C客户端有一个日志设施,用于记录内部日志信息.默认情况下,日志记录器将日志信息写到stderr.但应用可更改日志的详细程度或提供一个客户化方法来记录日志信息. 设置日志级别 若应用需要修改日志信息详细程度,可使用as_log_set_level()设置不同的日志级别:. as_log_set_level(&as->log, AS_LOG_LEVEL_DEBUG); 日志级别有: AS_LOG_LEVEL_OFF AS_LOG_LEVEL_ERROR AS_LOG_L

Aerospike C客户端手册———键-值存储—删除记录

删除记录 Aerospike C客户端API提供一个简单的操作来删除数据库中的数据. 数据删除示例代码被所有示例使用.下面的代码引用自示例目录[examples/basic_examples/put],由Aerospike C客户端安装包自带. 请先阅读[创建连接]章节内容,理解如何建立与集群的连接. 初始化键(KEY) 删除记录时,数据库需要通过键(key)来标识这条记录.下面我们为示例代码创建一个键.用来做键的是字符串"test-key",数据所在的namespace名称为&quo

Aerospike C客户端手册———键-值存储—批量读取记录

批量读取记录 除了每次读取单条记录外,还可以在一个事务中从集群中读取多条记录.相关的客户Aerospike C客户端API调用是: aerospike_batch_get() - 返回所需记录所有bin数据. aerospike_batch_exists() - 返回所需记录元数据(生存时间, 分代编号). 后面的代码引用自示例目录[examples/basic_examples/get],由Aerospike C客户端安装包自带. 请先阅读[创建连接]章节内容,理解如何建立与集群的连接. 初始

Aerospike C客户端手册———键-值存储—读取记录

读取记录 Aerospike C 客户端AP提供四个从数据库读取一条记录的操作: aerospike_key_get() - 读取一条记录所有bin数据. aerospike_key_select() - 读取一条记录指定bin数据. aerospike_key_exists() - 检查一条记录的存在性. aerospike_key_operate() - 在一条记录上执行操作,包括对指定bin的读取操作. 此章节主要讨论前三个操作,aerospike_key_operate()操作将在后面的

Aerospike C客户端手册———示例

示例 Aerospike C客户端函数库自带一系列的示例,用来说明如何使用客户端构建应用.这些示例打包在[客户端函数库安装包]中,安装到'examples'目录下. 示例包括的内容抽样说明如下: 基本示例 存放和获取包含多bin的记录. 设置记录生存时间(TTL). 在记录上应用用户定义函数. 批量示例 一次请求多条记录. 查询示例 次索引与聚合的使用 扫描示例 扫描整个namespace或一个set. 在扫描的结果集上应用用户定义函数. 为了构建所有示例,请转到examples目录下,然后执行