本文共 6835 字,大约阅读时间需要 22 分钟。
CouchDB介绍:
CouchDB是Apache组织发布的一款开源的、面向文档类型的NoSQL数据库。由Erlang编写,使用json格式保存数据。CouchDB以RESTful的格式提供服务
可以很方便的对接各种语言的客户端
CouchDB最大的竞争对手就是熟悉的MangoDB。它们的不同点比较会在另外一篇里面写入
CouchDB 目标是做下一代的Web应用存储系统
CouchDB下载,安装:
官网:http://couchdb.apache.org/ 目前只有2.0.0版本 2016年9月份
CouchDB 安装完成后自动启动,默认是5984
Docker下的安装配置:
1、先创建一个couchdb容器,并赋值给couch1
1 2 | COUCH1=$(docker run -d -p 5984 - v /var/lib/couchdb couchdb) root@ubuntu:~ # echo $COUCH1 |
1 | 6d708f72e25e9f0d693aa5a8ce5afd1a61e945355f728f409bc5a90676e0524c |
2、给couchDB中插入数据
要确保你的HOST是可用的
1 2 3 | $ HOST=localhost #这里如果localhost不行,就更换成主机ip $ URL= "http://$HOST:$(docker port $COUCH1 5984 | grep -o '[1-9][0-9]*$')/_utils/" $ echo "Navigate to $URL in your browser, and use the couch interface to add data" |
操作结果:
1 2 3 4 5 6 7 | root@ubuntu:~ # HOST=123.xx.xx.x8 #这里是公网ip就不显示出来了 root@ubuntu:~ # URL="http://$HOST:$(docker port $COUCH1 5984 | grep -o '[1-9][0-9]*$')/_utils/" root@ubuntu:~ # docker port $COUCH1 5984 #这里映射到了宿主机32768端口,并监听所有ip 0.0.0.0:32768 root@ubuntu:~ # echo "Navigate to $URL in your browser, and use the couch interface to add data" Navigate to http: //123 .xx.xx.x8:32768 /_utils/ in your browser, and use the couch interface to add data # 打开浏览器输入http://123.xx.xx.x8:32768/_utils/ 将会显示couchDB的页面 |
创建数据库账号
控制台页面的左边的主要部分列出了当前数据库,并提供了一个 Create Database … 的操作;右边的侧边栏呢,从上到下分别提供了 工具、 文档 、 诊断 和 当前数据库 3个菜单。最右下角是版本号和一句话:“Welcome to Admin Party! Everyone is admin. Fix this”,什么意思呢?就是说ConchDB默认用户都是admin,对于用惯了关系型数据库的我们,本能的就会感觉这并不安全,没错,其实就是不安全!!!!,所以,点击 Fix this 来新建一个用户吧。
注意:如果使用中发现某些按钮是灰色的或者 Compact & Cleanup 一直在转圈等待,请先看看自己是不是管理员。
点击 Create Database …
并输入一个数据库名称就可以新建一个数据啦
创建成功后会跳转到当前新建的数据库,如果我们返回Overview页面就会发现刚才新建的数据库已经被添加到列表中了。
在新建的数据库的管理页面中点击 New Document
,我们就可以新建一个文档,其中会包含一个默认的Id字段作为唯一标识,我们可以不用管他,同时也可以点击 Add Field
来新增字段,这里假设我们新增一个人,字段如下图:
点击右面的“source”按钮,就能看到json格式的内容
点击上面的“Save doucement”来保存数据,然后再主页就能看到我们新创建的数据库了
双击Field或者Value列的单元格可以更改字段名或字段值
点击右侧的绿色对勾按钮后,该字段的值将会被保存,此时切换到Source标签就可以看到json格式的数据
编辑完成后点击上方的 Save Document
按钮就可以将刚才的json数据保存到数据库中,保存成功后系统会自动为我们添加一个 rev
字段,这个字段代表当前文档的版本号
更新操作呢也比较简单,只需要单击当前文档的Key或者双击Value就可以进入编辑页面,在编辑页面中不但能修改字段的Key/Value,还可以新增和删除字段,同样,点击 Save Document
即可保存当前修改,同时,我们可以注意到,该文档的 rev
值已经发生了变化,这代表该文档的版本号已经被更新
同样,进入当前记录的详情页我们就可以看到 Delete Document
按钮,点击之后当前文档就会被删除。
但是,值得注意的是,当我们使用 Delete Document
操作将文档删除后,表面看是没有数据了,但是该数据仍然占用了那么多空间,并没有减少,如下图:
这时我们需要进入数据库详情页,使用 Compact & Cleanup…
中的 Compact Database
操作来清理被占用的空间,如果发现此功能点击之后一直在转圈等待,去看看自己是不是管理员用户吧。
1 | COUCH2=$(docker run -d -p 5984 --volumes-from $COUCH1 couchdb) |
使用浏览器浏览第二个数据库
1 2 3 | HOST=localhost #这里如果localhost不行,就更换成主机ip URL= "http://$HOST:$(docker port $COUCH2 5984 | grep -o '[1-9][0-9]*$')/_utils/" echo "Navigate to $URL in your browser, and use the couch interface to add data" |
Tips: 对cURL还不太了解的亲们可以搜索下,很好用的工具,可以从这里下载:
注意:为了测试方便,我们删除原来的数据库。
前面已经介绍过,CouchDB支持使用RESTful API的方式来对数据进行操作,例如,我们在浏览器中输入 就可以查看demo数据库中详细信息。如图:
下面是借鉴别人的操作流程,自己没有时间敲了,大家随意感受一下CouchDB流畅的RESTful操作方式:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 | # 获取CouchDB相关信息 curl -X GET http: //127 .0.0.1:5984 { "couchdb" : "Welcome" , "uuid" : "a853c053a5a54a4d3ccbaad0d9ffd3b0" , "version" : "1.6.1" , "vendor" :{ "version" : "1.6.1" , "name" : "The Apache Software Foundation" }} # 创建demo数据库(需要admin权限,参照下一条命令) curl -X PUT http: //127 .0.0.1:5984 /demo { "error" : "unauthorized" , "reason" : "You are not a server admin." } # 使用用户名密码登录CouchDB,并创建demo数据库 curl -X PUT http: //username :password@127.0.0.1:5984 /demo { "ok" : true } # 查看所有数据库 curl -X GET http: //127 .0.0.1:5984 /_all_dbs [ "_replicator" , "_users" , "demo" ] # 查看demo数据库相关信息 curl -X GET http: //127 .0.0.1:5984 /demo { "db_name" : "demo" , "doc_count" :0, "doc_del_count" :0, "update_seq" :0, "purge_seq" :0, "compact_running" : false , "disk_size" :79, "data_size" :0, "instance_start_time" : "1452000207199340" , "disk_format_version" :6, "committed_update_seq" :0} # 向demo数据库中添加一个文档(自动生成Id),注意:windows下需要使用Content-Type:application/json的HttpHeader curl -H "Content-Type:application/json" -X POST http: //127 .0.0.1:5984 /demo -d {\"name\":\"fooly\"} { "ok" : true , "id" : "3ebb59dd78ff448f283f48817800321c" , "rev" : "1-0e4ea534f2c1e7f05e21804b5f2f7a71" } # 查看demo数据库中的所有文档 curl -X GET http: //127 .0.0.1:5984 /demo/_all_docs { "total_rows" :1, "offset" :0, "rows" :[ { "id" : "3ebb59dd78ff448f283f48817800321c" , "key" : "3ebb59dd78ff448f283f48817800321c" , "value" :{ "rev" : "1-0e4ea534f2c1e7f05e21804b5f2f7a71" }} ]} # 获取一个uuid curl -X GET http: //127 .0.0.1:5984 /_uuids { "uuids" :[ "3ebb59dd78ff448f283f4881780033c0" ]} # 向demo数据库中添加一个文档(使用获取到的uuid作为Id) curl -H "Content-Type:application/json" -X PUT http: //127 .0.0.1:5984 /demo/3ebb59dd78ff448f283f4881780033c0 -d {\"name\":\"momo314\"} { "ok" : true , "id" : "3ebb59dd78ff448f283f4881780033c0" , "rev" : "1-eb393d36ac1ad38ada8361d94fc5d0b6" } # 更新指定Id的文档(但是失败了,因为CouchDB是按版本提交的,同一个源提交多次会造成一定的混乱。所以,需要指定文档版本进行控制。) curl -H "Content-Type:application/json" -X PUT http: //127 .0.0.1:5984 /demo/3ebb59dd78ff448f283f4881780033c0 -d {\"name\":\"momo314\",\"age\":18} { "error" : "conflict" , "reason" : "Document update conflict." } # 更新指定Id和指定版本的文档 curl -H "Content-Type:application/json" -X PUT http: //127 .0.0.1:5984 /demo/3ebb59dd78ff448f283f4881780033c0 -d {\"_rev\":\"1-eb393d36ac1ad38ada8361d94fc5d0b6\",\"name\":\"momo314\",\"age\":18} { "ok" : true , "id" : "3ebb59dd78ff448f283f4881780033c0" , "rev" : "2-5d081e17588c03c27340035e420edecd" } # 获取指定Id的文档内容 curl -X GET http: //127 .0.0.1:5984 /demo/3ebb59dd78ff448f283f4881780033c0 { "_id" : "3ebb59dd78ff448f283f4881780033c0" , "_rev" : "2-5d081e17588c03c27340035e420edecd" , "name" : "momo314" , "age" :18} # 删除指定Id和rev版本号的文档 curl -X DELETE http: //username :password@127.0.0.1:5984 /demo/3ebb59dd78ff448f283f4881780033c0 ?rev=2-5d081e17588c03c27340035e420edecd { "ok" : true , "id" : "3ebb59dd78ff448f283f4881780033c0" , "rev" : "2-5d081e17588c03c27340035e420edecd" } # 查看demo数据库中的所有文档(刚才的文档确实被删除掉了) curl -X GET http: //127 .0.0.1:5984 /demo/_all_docs { "total_rows" :1, "offset" :0, "rows" :[ { "id" : "3ebb59dd78ff448f283f48817800321c" , "key" : "3ebb59dd78ff448f283f48817800321c" , "value" :{ "rev" : "1-0e4ea534f2c1e7f05e21804b5f2f7a71" }} ]} # 删除demo数据库(需要admin权限,参照下一条命令) curl -X DELETE http: //127 .0.0.1:5984 /demo { "error" : "unauthorized" , "reason" : "You are not a server admin." } # 使用用户名密码登录CouchDB,并删除demo数据库 curl -X DELETE http: //username :password@127.0.0.1:5984 /demo { "ok" : true } # 查看所有数据库(demo数据库确实被删除掉了) curl -X GET http: //127 .0.0.1:5984 /_all_dbs [ "_replicator" , "_users" ] |