Couchbase II( View And Index)

Views

view的作用是从没有结构和半结构的数据对象中抽取过滤需要的信息，并生成相关的index信息，通常生成json数据。 view通过迭代bucket所有文档而提取过滤信息，进而生成index。

一个bucket可以有多个设计文档，一个设计文档（Design Document）可以有多个views。

开发view和产品view开发view 以dev——前缀开始，只对部分数据做index和view，以帮助不用对所有的数据做view，而调试得到正确的view，之后可以切换到产品模式（去掉dev_前缀)

view名一定要是一个或多个uft编码字符，首尾中间不含空白（空格， tab等）

View的作用

索引和查询存储的对象
构建输出指定的对象类型
从数据库抽取过滤信息
计算，统计，聚集数据集合的信息

View contents

view的输出对应每个emit有三个重要属性

Document ID

每次调用emit（）都会包含 document id，帮助加载所有的文档通过get()

View key

这是emit（）的第一个参数，你可以指定key任何值，包括数组（一组值）来查询复杂的选择和报告。

key的值也决定如何插叙

View value

这是emit（）的第二个参数，只能被自定义的reduce方法使用。

查询和选择

Couchbase 支持三种选择方式：

Speific Key（指定的键）

$result = $cb->view("recipes", "bytitle", array('key' => 'Apple Pie'));

One or more keys

$result = $cb->view("dev_recipes", "bytitle", array('keys' => array('Shepherds

pie', 'Mariners pie')));

Key range

#会找出tittle在Meat loaf到Mexican tacos间所有的数据

$result = $cb->view("dev_recipes", "bytitle", array('startkey' => 'Meat

loaf','endkey' => 'Mexican tacos'));

可选的附加功能

key可以帮助过滤查询，但view也有排序和其他需求：

descending

Return the documents in descending by key order

endkey

Stop returning records when the specified key is reached. Key must be specified as a JSON value.

endkey_docid

Stop returning records when the specified document ID is reached

full_set Use the full cluster data set (development views only).

group

Group the results using the reduce function to a group or single row

group_level
```
Specify the group level to be used
```

inclusive_end

Specifies whether the specified end key should be included in the result

key

Return only documents that match the specified key. Key must be specified as a JSON value.

keys

Return only documents that match each of keys specified within the given array.

Key must be specified as a JSON value. Sorting is not applied when using this option.

limit

Limit the number of the returned documents to the specified number

on_error

Sets the response in the event of an error. stop will stop returning rows;

continue will notify you of the error, but continue returning rows from other nodes.

reduce
```
Use the reduction function.
```

skip

Skip this number of records before starting to return the results

stale

Allow the results from a stale view to be used. ok uses a stale index;

false forces an index update;

up date_after updates the index after it has been accessed (default)

startkey

Return records with a value equal to or greater than the specified key.

Key must be specified as a JSON value.

startkey_docid

Return records starting with the specified document ID

处理不同的数据格式

有时可能因为应用的版本，而造成输出不同等，而输入的数据格式也不同,emit 可以出现多次，通过选择控制输出不同格式（JS）：

function (doc, meta){

    if (doc.preptime && doc.cooktime){

        emit(parseInt(doc.preptime, 10) + parseInt(doc.cooktime, 10), null);

    }

    else{

        emit(parseInt(doc.totalcooktime, 10), null);

    }

}

当需要使用到reduce时，这时emit的第二个参数，就需要传入value，如果不要用到，就像上面例子传入null就好

index 更新

index更新会在各个节点同步时，触发更新。Couchbase在读写时（get， set）时，先从缓存层开始，只用序列化更新到磁盘，才会更新index：

index会根据服务配置设定的更新频率自动更新。
在query时，可以指定是否更新index
删除文档时，只用硬盘上的数据被删除，index才会被删除
文档有TTL过期时限，相关index会自动更新当文档过期

stale 参数

在客户端获取数据时，设置 -stale- 参数可以设定三种index 更新状态：

update_after

在获取数据后更新index，也就是下次查询时使用的是更新的view

使用当前版本的index，不触发index更新

false

强制更新所有的索引后返回查询结果，也许会很费时间，因为要更新所有的view和index。

Reductions

_count

_count内建函数用来统计来自map的输入行

_sum

_sum 会把map输出的值或多个值加起来。

_stats

用于聚集统计，最大，最小等值。

文档的元数据

meta 含如下信息和字段：

数据对象的ID或键（key），和set方法用来写数据的key是一样的

rev

内建版本号，用来追踪当前数据的版本。rev字段含的信息是不具有一致性或可跟踪性，不可用于客户端应用中。

type

保存文档的类型， JSON文档是json类型， 二进制文档是base64类型

flags

flags是一个32为的整数，用来保存数据保存创建的时间， 可用状态由客户端是否支持决定

expiration

数据对象过期时间 ，和TTL的表示一致