Apache OpenWhisk Cloudant数据库套餐使用详解

1. 安装指南

在Bluemix上设置Cloudant数据库

1. 在Bluemix控制台中创建一个Cloudant服务实例。

2. 确保创建服务实例后，生成了一个凭证密钥。

3. 刷新命名空间中的包，以自动为每个定义了凭证密钥的Cloudant服务实例创建包绑定。

   wsk package refresh
   

4. 检查创建的包绑定是否已配置了与你的Cloudant服务实例对应的托管主机和凭证。

   wsk package get /<yourBluemixOrg>_<yourBluemixSpace>/Bluemix_<yourCloudantServiceInstance>_Credentials-1 parameters
   

在Bluemix之外设置Cloudant数据库

如果你不是在Bluemix上使用OpenWhisk和Cloudant，或者你希望在Bluemix之外设置你的Cloudant数据库，你需要手动为你的Cloudant账户创建包绑定。

1. 使用以下命令创建一个配置了你的Cloudant账户的用户名、密码和主机名的包绑定。

   wsk package bind /whisk.system/cloudant <yourPackageName> -p username <yourCloudantUsername> -p password <yourCloudantPassword> -p host <yourCloudantAccount>.cloudant.com
   

2. 确认包绑定已创建。

   wsk package list
   

2. 项目的使用说明

本项目提供的/whisk.system/cloudant包允许你与Cloudant数据库进行交互，其中包括以下操作和馈送：

• /whisk.system/cloudant：用于操作Cloudant数据库的包。
• /whisk.system/cloudant/read：从数据库中读取文档的动作。
• /whisk.system/cloudant/write：向数据库中写入文档的动作。
• /whisk.system/cloudant/changes：数据库变化时触发事件的馈送。

3. 项目API使用文档

监听Cloudant数据库的变化

你可以定义一个过滤函数，以避免不必要的变更事件触发你的触发器。

创建一个名为design_doc.json的JSON文档文件，包含以下过滤函数：

{
  "doc": {
    "_id": "_design/mailbox",
    "filters": {
      "by_status": "function(doc, req){if (doc.status != req.query.status){return false;} return true;}"
    }
  }
}

在你的数据库中创建一个新的设计文档，包含过滤函数：

wsk action invoke /_/myCloudant/write -p dbname testdb -p overwrite true -P design_doc.json -r

使用changes馈送配置服务，以便在Cloudant数据库的每次变更时触发一个触发器。参数如下：

• dbname：Cloudant数据库名称（必填）。
• maxTriggers：达到此限制时停止触发（可选，默认为无限）。
• filter：在设计文档上定义的过滤函数（可选）。
• query_params：过滤函数的额外查询参数（可选）。

向Cloudant数据库写入数据

使用write动作将文档存储到名为testdb的Cloudant数据库中。确保该数据库存在于你的Cloudant账户中。

wsk action invoke /_/myCloudant/write --blocking --result --param dbname testdb --param doc "{\"_id\":\"heisenberg\",\"name\":\"Walter White\"}"

从Cloudant数据库读取数据

使用read动作从名为testdb的Cloudant数据库中获取文档。确保该数据库存在于你的Cloudant账户中。

wsk action invoke /_/myCloudant/read --blocking --result --param dbname testdb --param id heisenberg

4. 项目安装方式

请参照上述的“安装指南”部分，根据你使用的环境是在Bluemix上还是Bluemix之外，按照相应的步骤进行安装。