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

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

2024-12-23 18:57:22作者:晏闻田Solitary

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之外,按照相应的步骤进行安装。

登录后查看全文
热门项目推荐