使用 IBM Cloudant 仪表板
通过使用 IBM® Cloudant® for IBM Cloud® 仪表板,您可以创建 IBM Cloudant 数据库,使用数据填充数据库,并使用查询或 API 端点检索数据。 有关 API 端点的更多信息,请参阅 API 和 SDK 参考。
目标
- 打开 IBM Cloudant 仪表板。
- 创建数据库。
- 将 JSON 文档添加到数据库并运行查询。
- 复制数据库。
- 监视活动任务。
- 使用 IBM Cloudant进行监视。
准备工作
在开始本教程之前,请在 IBM Cloud 中创建服务实例。 您可以遵循 入门 教程中的指示信息来创建一个。
在 IBM Cloudant 仪表板上打开服务实例
通过执行以下步骤打开 IBM Cloudant 服务实例:
-
转至 IBM Cloud“仪表板”。
-
单击“资源”列表中的 服务。
-
从“服务”部分中,单击您在 入门 教程中创建的
Cloudant-o7
实例,然后单击 启动仪表板。 这将打开 IBM Cloudant 仪表板。
现在,您可以创建数据库并对其运行查询。
创建数据库
在本练习中,您将创建 dashboard-demo
数据库,这是本教程中使用的数据库。
-
在 IBM Cloudant 仪表板中,单击 创建数据库。
创建数据库窗口打开。
-
输入数据库名称
dashboard-demo
。 -
选择“非分区”,然后单击“创建”。
dashboard-demo
数据库将自动打开。
现在,您可以创建一些文档。
向数据库添加文档
在本练习中创建的 文档 在本练习中创建的文档包括在后面的练习中用来查询 dashboard-demo
数据库的数据。
-
单击 创建文档。
此时将打开“新建文档”窗口。
-
复制以下样本文本并替换新文档中的现有文本。 对文档 1 使用以下样本文本:
{ "firstname": "Sally", "lastname": "Brown", "age": 16, "location": "New York City, NY", "_id": "doc1" }
-
重复步骤 1 和 2 以将其余四个文档添加到数据库。 对文档 2 使用以下样本文本:
{ "firstname": "John", "lastname": "Brown", "age": 21, "location": "New York City, NY", "_id": "doc2" }
对文档 3 使用以下样本文本:
{ "firstname": "Greg", "lastname": "Greene", "age": 35, "location": "San Diego, CA", "_id": "doc3" }
对文档 4 使用以下样本文本:
{ "firstname": "Anna", "lastname": "Greene", "age": 44, "location": "Baton Rouge, LA", "_id": "doc4" }
对文档 5 使用以下样本文本:
{ "firstname": "Lois", "lastname": "Brown", "age": 33, "location": "New York City, NY", "_id": "doc5" }
您已使用五个文档填充
dashboard-demo
。 您可以在以下截屏中的“表”视图中查看文档:Sample documents
运行简单查询
此示例演示了 IBM Cloudant Query 如何根据 lastname
和 firstname
查找文档。
-
单击 查询。
-
复制以下样本 JSON 并替换新查询窗口中的现有文本:
{ "selector": { "lastname" : "Greene", "firstname" : "Anna" } }
-
单击运行查询。
查询将显示结果。 您可以在表视图中查看这些结果,如以下截屏所示:
查询
有关更多信息,请参阅 IBM Cloudant Query 教程或 IBM Cloudant Query上的 API 参考。
复制数据库
复制数据库时,它将同步两个数据库 (源和目标) 的状态。 复制会将源数据库中发生的所有更改复制到目标数据库。 从源数据库中删除文档时,还会从目标数据库中删除该文档。
有关更多信息,请参阅 复制。
-
单击 复制。
-
单击 新建复制。
“作业配置”页面将打开。
此外,您可以通过单击“操作”列中的 复制 从数据库页面创建复制。
-
输入复制作业的以下信息。 在“源”部分中使用以下信息:
- 输入-选择 远程数据库。
- 名称-输入数据库 URL:
$SERVICE_URL/query-movies
。 - 认证-保留为
None
。
在“目标”部分中使用以下信息:
- 输入-选择 新建本地数据库。
- 新数据库-输入新数据库的名称
query-movies
。 - 新数据库选项-不选择“分区”选项。
- 认证-选择 IAM 认证。
- IAM API 密钥-从实例的服务凭证输入
apikey
。
有关更多信息,请参阅有关 查找服务凭证 的部分。
使用“选项”部分中的以下信息:
- 复制类型-保留为
One time
。 - 复制文档-保留为
Custom ID (optional
。
Replication configuration page -
单击 启动复制。
“复制”页面将打开,您可以在其中看到复制作业正在运行。
Status of your replication job -
查看作业完成更改为“已完成”时的状态。
-
请检查是否已在数据库页面上创建数据库。
“数据库”页面
监视活动任务
“活动任务”页面显示所有正在运行的任务的列表。 当您监视系统的性能时,此列表可帮助您查找潜在问题。 您可以看到活动任务的列表,其中包括压缩,复制和建立索引。 有关更多信息,请参阅 管理任务 指南。
如果实例没有任何活动任务,那么您可以返回到上一步骤,删除 query-movies
数据库,然后再次进行复制。 如果您立即打开“活动任务”页面,那么可以看到复制。
-
单击活动任务。
此时将打开“活动任务”页面。
活动任务 -
单击关联的选项卡以查看特定于任务的信息。
使用 IBM Cloudant 进行监视
使用通过读取,写入和全局查询显示吞吐量的图形来监视您的使用情况。 您可以查看当前操作,被拒绝的请求和存储器使用情况。
您的服务实例不包含任何数据,因为它仅用于演示目的。 但是,您可以通过执行以下步骤来查看可供您使用的监视信息:
-
单击监控。
“监视”页面将打开到“当前操作”选项卡。 通过查看按读,写和全局查询细分的请求,查看最近使用的供应吞吐量容量。 虚线是实例允许的峰值容量。 峰值容量基于为供应的吞吐量容量设置的内容。
Current Operations -
单击 被拒绝的请求。
查看由
429: too many requests
响应数显示的来自给定秒的被拒绝请求数。 当请求超过为实例设置的供应吞吐量容量时,将拒绝这些请求。 此图显示按读取数,写入数和全局查询细分的已拒绝请求数。已拒绝请求 -
单击存储器。
定期查看存储器,以便在需要更改套餐的供应时做好准备。
存储器
有关更多信息,请参阅 计划和供应。