Hyperledger Fabric 1.2.1启用CouchDB作为状态数据库

一. CouchDB

状态数据库可选类型包括LevelDB和CouchDB。LevelDB是嵌入在peer进程中的默认键/值状态数据库，CouchDB是一个可选的外部状态数据库。与LevelDB键/值存储一样，CouchDB可以存储任何以chaincode建模的二进制数据（CouchDB附件函数在内部用于非json二进制数据）。但是，当chaincode值（例如，资产）被建模为JSON数据时，作为JSON文档存储，CouchDB支持对chaincode数据进行丰富的查询。

LevelDB和CouchDB都支持核心chaincode操作，例如获取和设置一个键（资产），并根据键进行查询。键可以通过范围查询，可以对组合键进行建模，以支持针对多个参数的等价查询。例如，作为所有者的组合键，资产id可以用于查询某个实体拥有的所有资产。这些基于key的查询可以用于针对账本的只读查询，以及更新总账的事务。

如果将资产建模为JSON并使用CouchDB，那么就可以使用chaincode中的CouchDB JSON查询语言对chaincode数据值执行复杂的富查询，这些类型的查询对于理解账本上的内容很有帮助。对于这些类型的查询，事务协议响应通常对客户端应用程序有用，但通常不会作为事务提交到排序服务。事实上，也无法保证结果集在chaincode执行与富查询提交时间之间的稳定性，因此使用富查询的结果去执行最终的事务更新操作是不合适的，除非可以保证结果集在chaincode执行时间与提交时间之间的稳定性，或者可以处理在后续交易中的潜在变化。例如，如果对Alice所拥有的所有资产执行一个富查询并将其传输给Bob，那么一个新的资产可能会被另一个事务分配给Alice，这是在chaincode执行时间和提交时间之间的另一个事务，可能此过程中会错过这个“虚值”。

CouchDB作为一个独立的数据库进程与peer一起运行，因此在设置、管理和操作方面有额外的考虑。我们可以考虑从默认的嵌入式LevelDB开始，如果需要额外的复杂的富

二. 启用CouchDB

本文均采用Hyperledger Fabric1.2中fabric-samples中相关组件与资源，在测试环境(fabric-samples/chaincode-docker-devmode)通过Docker启动CouchDB服务

1.配置CouchDB启动信息

修改:fabric-samples/chaincode-docker-devmode/docker-compose-simple.yaml 末尾添加并修改

  couchdb:container_name: couchdbimage: hyperledger/fabric-couchdb# Populate the COUCHDB_USER and COUCHDB_PASSWORD to set an admin user and password# for CouchDB.  This will prevent CouchDB from operating in an "Admin Party" mode.environment:- COUCHDB_USER=- COUCHDB_PASSWORD=# Comment/Uncomment the port mapping if you want to hide/expose the CouchDB service,# for example map it to utilize Fauxton User Interface in dev environments.ports:- "5984:5984"

2.配置CouchDB连接信息

修改:fabric-samples/chaincode-docker-devmode/docker-compose-simple.yaml 中peer模块

修改后

peer:container_name: peerimage: hyperledger/fabric-peerenvironment:- CORE_PEER_ID=peer- CORE_PEER_ADDRESS=peer:7051- CORE_PEER_GOSSIP_EXTERNALENDPOINT=peer:7051- CORE_PEER_LOCALMSPID=DEFAULT- CORE_VM_ENDPOINT=unix:///host/var/run/docker.sock- CORE_LOGGING_LEVEL=DEBUG- CORE_PEER_MSPCONFIGPATH=/etc/hyperledger/msp- CORE_LEDGER_STATE_STATEDATABASE=CouchDB- CORE_LEDGER_STATE_COUCHDBCONFIG_COUCHDBADDRESS=couchdb:5984- CORE_LEDGER_STATE_COUCHDBCONFIG_USERNAME=- CORE_LEDGER_STATE_COUCHDBCONFIG_PASSWORD=volumes:- /var/run/:/host/var/run/- ./msp:/etc/hyperledger/mspworking_dir: /opt/gopath/src/github.com/hyperledger/fabric/peercommand: peer node start --peer-chaincodedev=true -o orderer:7050ports:- 7051:7051- 7053:7053depends_on:- orderer- couchdb

注意JSON文件的格式以及配置信息的一致性，如couchdb名称等

3.启动测试环境

# docker-compose  -f docker-compose-simple.yaml  up -d# docker container ls

二. 测试链码

测试过程

这里在以最简单的sacc.go为例，该链码只涉及到简单的存储（set）和查询（get）功能。整个过程需要启动三个终端：

终端一：启动网络

首先进入开发者模式目录：

1	cd fabric-samples/chaincode-docker-devmode

启动网络：

1	docker-compose -f docker-compose-simple.yaml up

当看到Going to wait for newer blocks时表示启动成功，此时网络中存在四个容器（1 orderer，1 peer， 1 chaincode， 1 cli），创建了通道myc并将peer成功加入。

终端二：编译链码

进入chaincode容器

1	docker exec -it chaincode bash

编译想要测试的chaincode：

1 2	cd sacc go build

成功执行后单当前目录下会出现生成的可执行文件。此时需要启动这个可执行文件：

1	CORE_PEER_ADDRESS=peer:7052 CORE_CHAINCODE_ID_NAME=mycc:0 ./sacc

终端三：在cli中测试链码

进入cli容器：

1	docker exec -it cli bash

安装和实例化链码（实例化设置了a的初始值10）：

1 2	peer chaincode install -p chaincodedev/chaincode/sacc -n mycc -v 0 peer chaincode instantiate -n mycc -v 0 -c '{"Args":["a","10"]}' -C myc

进行测试：

调用 set() 接口将 a 的值设置为20:

1	peer chaincode invoke -n mycc -c '{"Args":["set", "a", "20"]}' -C myc

调用 get() 接口查询 a 的值，发现a的值已经更新为20，测试完毕。

1	peer chaincode query -n mycc -c '{"Args":["get","a"]}' -C myc

另外：
执行docker-compose命令后就可以启动couchdb容器，同时在浏览器中输入地址http://localhost:5984/_utils还可以进入couchdb的web端管理界面，更清晰的看到存入的数据，从而方便配合我们进行测试。　

测试遇到的错误：

结论：fabric1.2.1应选择指定2.1.1版本的couchdb否则会报错，难以解决，错误提示如下：