Riak HTTP接口使用指南：从基础到高级特性

Riak HTTP接口使用指南：从基础到高级特性

riak Riak is a decentralized datastore from Basho Technologies. 项目地址: https://gitcode.com/gh_mirrors/ri/riak

概述

Riak是一个分布式键值存储系统，提供了多种接口来访问和操作数据。其中HTTP接口是最直观、最易于使用的接口之一。本文将详细介绍如何通过HTTP接口与Riak进行交互，包括基础操作和高级特性。

基础配置

启用HTTP接口

要使用Riak的HTTP接口，首先需要在配置文件中启用它。在riak_core配置段中添加以下两行：

{web_ip, "127.0.0.1"}.
{web_port, 8098}.

配置完成后启动Riak，HTTP接口将在http://127.0.0.1:8098/riak/...地址上可用。

自定义路径前缀

默认情况下，Riak使用"riak"作为路径前缀。如果需要修改，可以添加配置：

{raw_name, "myprefix"}.

基础操作

桶操作

在Riak中，桶(Bucket)是组织数据的容器。所有桶默认存在，无需显式创建。

获取桶属性：

curl -i http://127.0.0.1:8098/riak/example

修改桶属性（如修改n_val）：

curl -X PUT -H "content-type: application/json" \
  http://127.0.0.1:8098/riak/example --data "{\"props\":{\"n_val\":4}}"

数据操作

存储数据

使用PUT请求存储数据，需要指定Content-Type：

curl -X PUT -H "content-type: text/plain" \
  http://127.0.0.1:8098/riak/example/foo --data "I have a document."

Riak支持任意内容类型，包括application/json、image/gif等。

获取数据

使用GET请求获取数据：

curl -i http://127.0.0.1:8098/riak/example/foo

响应中包含重要头信息：

• X-Riak-Vclock: 向量时钟，用于并发控制
• Content-Type: 与存储时指定的类型一致
• Etag: 对象版本标识符

更新数据

更新时需要提供向量时钟：

curl -X PUT -H "content-type: text/plain" \
  -H "X-Riak-Vclock: a85hYGBgzGDKBVIsLGtY2zOYEhnzWBkE12w8ypcFAA==" \
  http://127.0.0.1:8098/riak/example/foo \
  --data "I have a modified document."

删除数据

使用DELETE请求删除数据：

curl -X DELETE http://127.0.0.1:8098/riak/example/foo

读写参数调优

可以通过查询参数调整读写行为：

• r: 读操作所需的最小副本数
• w: 写操作所需的最小副本数
• dw: 持久化写操作所需的最小副本数
• rw: 删除操作所需的最小副本数

示例：

curl http://127.0.0.1:8098/riak/example/foo?r=1

高级特性

数据冲突与兄弟节点(Siblings)

当桶的allow_mult属性设为true时，允许存在多个版本的数据（兄弟节点）。

启用兄弟节点支持：

curl -X PUT -H "content-type: application/json" \
  http://127.0.0.1:8098/riak/example \
  --data "{\"props\":{\"allow_mult\":true}}"

创建兄弟节点：

curl -X PUT -H "content-type: text/plain" \
  http://127.0.0.1:8098/riak/example/sib --data "one thing"
curl -X PUT -H "content-type: text/plain" \
  http://127.0.0.1:8098/riak/example/sib --data "another"

获取兄弟节点：

curl -i http://127.0.0.1:8098/riak/example/sib

响应状态码为300 Multiple Choices，返回所有兄弟节点的vtag。

查看特定兄弟节点：

curl http://127.0.0.1:8098/riak/example/sib?vtag=xKntdvwv9b1sIj1LArbox

以multipart格式获取所有兄弟节点：

curl -i -H "accept: multipart/mixed" http://127.0.0.1:8098/riak/example/sib

解决冲突：

curl -X PUT -H "content-type: text/plain" \
  -H "X-Riak-Vclock: a85hYGBgzmDKBVIszBJiPRlMiYx5rAyzNmw8ygcVZoyuU4YKz0cIszUnMZ0/pIAskQUA" \
  http://127.0.0.1:8098/riak/example/sib --data "resolved"

链接遍历(Link Walking)

Riak支持通过链接关联文档，并提供了链接遍历功能。

添加链接：

curl -X PUT -H "content-type: text/plain" \
  -H "link: </riak/memo/xyz>; riaktag=\"author\", </riak/memo/abc>; riaktag=\"reader\"" \
  http://127.0.0.1:8098/riak/person/jane --data "Name: Jane Doe"

链接遍历语法：

/riak/{起始桶}/{起始键}/{目标桶},{标签},{保持}

示例：

curl -i http://127.0.0.1:8098/riak/person/jane/memo,_,_

响应为multipart/mixed格式，包含遍历到的所有文档。

总结

Riak的HTTP接口提供了简单直观的方式来与分布式存储系统交互。通过本文介绍的基础操作和高级特性，开发者可以充分利用Riak的强大功能，包括灵活的数据模型、冲突解决机制和文档关联功能。无论是简单的键值存储还是复杂的分布式应用场景，Riak都能提供可靠的支持。

riak Riak is a decentralized datastore from Basho Technologies. 项目地址: https://gitcode.com/gh_mirrors/ri/riak