风河博客

客户端与集群的交互

在开发应用时，最常见的问题是，客户端和客户端库如何与集群通信，如何适应运行中集群的拓扑结构改变。通常而言，在客户端与数据库交互中，couchbase扮演一个黑盒子。假如你使用了smart client，集群的拓扑、节点结构，以及对应信息的变更，完全由vBucket映射表和客户端库联合起来自动处理。

客户端库负责客户端与集群中各个节点的直接通信。你用来初次建立连接的那个节点，不会扮演代理或网关的角色。smart client（或Moxi）会加载vBucket映射表，从映射表里学习到把不同信息存储到集群里的哪个节点。客户端直接与正确的节点通信，中间没有代理或网关。

在拓扑结构改变时（例如，rebalance或者故障转移），客户端库自动处理任何临时的错误。总之而言，你不必关心任何集群的配置与拓扑相关信息。

关于客户端与集群的通信机制，请见之前的文档，Couchbase的Smartclient有何作用

过期时间

过期时间（time to live [TTL]）的用途是，在存储信息时设置一个超时值，它让文档自动过期删除。除了delete()函数外，文档的过期值是从数据库里删除信息的唯一方法。一旦过期时间到了，数据就会删除。

过期时间设置为一个数字，它代表秒数。如果这个数字代表的秒数，小余30天（30*24*60*60秒），这个值就是相对值。例如，3600秒表示文档在一个小时后过期。如果秒数大于30天，过期值就是绝对值，表示从epoch时间以来的绝对秒数。

过期时间可以用在不同的应用场景，但最普通的场景是使用它存储session数据。例如你可以用它存储session并设置过期时间2小时，用户如果超过2小时没访问网站，session自动删除。

如果用户还在访问数据，可以使用touch()和getAndTouch()函数来更新过期时间，不必另外执行数据更新操作来更新过期值。

标签

除了过期时间，所有文档在存储时也带了一系列标签（flags）。并非所有的客户端库都支持标签，但如果支持，你可以用标签来增加文档描述信息，例如文档类型。

【注】这次测试中，遇到了一些问题，因此本文用E文编写，随后发到Couchbase社区咨询一下。

We have five nodes as the couchbase cluster, the servers have enough memory and disk, with ubuntu 12.04 OS. Couchbase server version: 2.0.1 community edition (build-170). I use the default bucket for test, it has been assigned 5GB memory totally.

The test Ruby script is as below:

require 'couchbase'
require 'securerandom'

client = Couchbase.connect("http://couch.example.com:8091/pools/default/buckets/default")

100000.times do |s|
value_10k = SecureRandom.hex(5120)
key_uuid = SecureRandom.uuid

begin
client.set key_uuid, value_10k, :ttl => 3600
rescue Couchbase::Error::Base => e
puts e
end
end

继续阅读 →

文档数据

文档数据是纯字节序列，服务器不会试图去解析或理解存储的文档格式。这意味着你可以存储从数字到图片的任何东西。这种开放的存储结构，也意味着不必去声明或定义要存储信息的结构，你可以充分灵活的自己定义所需要的结构。

存储简单的信息，例如数字或字串，只需简单的将数据写进文档值。存储复杂的信息结构，你可能需要序列化对象，或者更通用的JSON结构。

序列化

序列化将特定语言的复杂的内部结构，例如hash或对象，转换为字节序列，从而可以存储在couchbase里。序列化的结构还能被还原成原来的数据结构，从而被特定的语言直接使用。

所有的couchbase客户端库在存取文档时，都自动支持序列化和反序列化结构或对象。

JSON

序列化信息的问题是，它是语言约定的。假如你在Java里存储一个对象或数据结构到couchbase，它被序列化为一个只有java语言库才能识别的串。假如要跨语言进行信息存储，你需要使用更通用的格式，比如JSON。

JSON之所以流行，一是因为它很简洁（它看起来像许多脚本语言的内置hash结构），二是它可以被Javascript直接使用，这样在web基础的应用里，不必对它做特别处理。

JSON的格式有良好的描述，详见http://json.org. 在couchebase里使用JSON的最好方法是，每条记录存储一个JSON哈希结构。例如，可以定义一条啤酒记录如下：

{
"id": "beer_Hoptimus_Prime",
"type": "beer",
"abv": 10.0,
"brewery": "Legacy Brewing Co.",
"category": "North American Ale",
"name": "Hoptimus Prime",
"style": "Imperial or Double India Pale Ale",
}

许多语言支持类似的hash、hashmap或关联数组结构，有相应的库可以将hash结构转换为JSON格式，并还原它们。

请注意：couchbase 2.0在使用JSON存储信息时，允许你使用查询和索引的高级功能。