IBM Cloud Docs
使用 IBM Cloudant 仪表板

使用 IBM Cloudant 仪表板

通过使用 IBM® Cloudant® for IBM Cloud® 仪表板,您可以创建 IBM Cloudant 数据库,使用数据填充数据库,并使用查询或 API 端点检索数据。 有关 API 端点的更多信息,请参阅 API 和 SDK 参考

目标

  1. 打开 IBM Cloudant 仪表板。
  2. 创建数据库。
  3. 将 JSON 文档添加到数据库并运行查询。
  4. 复制数据库。
  5. 监视活动任务。
  6. 使用 IBM Cloudant进行监视。

准备工作

在开始本教程之前,请在 IBM Cloud 中创建服务实例。 您可以遵循 入门 教程中的指示信息来创建一个。

在 IBM Cloudant 仪表板上打开服务实例

通过执行以下步骤打开 IBM Cloudant 服务实例:

  1. 转至 IBM Cloud“仪表板”。

  2. 单击“资源”列表中的 服务

  3. 从“服务”部分中,单击您在 入门 教程中创建的 Cloudant-o7 实例,然后单击 启动仪表板。 这将打开 IBM Cloudant 仪表板。

现在,您可以创建数据库并对其运行查询。

创建数据库

在本练习中,您将创建 dashboard-demo 数据库,这是本教程中使用的数据库。

  1. 在 IBM Cloudant 仪表板中,单击 创建数据库

    创建数据库窗口打开。

  2. 输入数据库名称 dashboard-demo

  3. 选择“非分区”,然后单击“创建”。

    dashboard-demo 数据库将自动打开。

现在,您可以创建一些文档。

向数据库添加文档

在本练习中创建的 文档 在本练习中创建的文档包括在后面的练习中用来查询 dashboard-demo 数据库的数据。

  1. 单击 创建文档

    此时将打开“新建文档”窗口。

  2. 复制以下样本文本并替换新文档中的现有文本。 对文档 1 使用以下样本文本:

    {
      "firstname": "Sally",
      "lastname": "Brown",
      "age": 16,
      "location": "New York City, NY",
      "_id": "doc1"
    }
    
  3. 重复步骤 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 如何根据 lastnamefirstname 查找文档。

  1. 单击 查询

  2. 复制以下样本 JSON 并替换新查询窗口中的现有文本:

     {
        "selector": {
              "lastname" : "Greene",
              "firstname" : "Anna"            
           }        
     }
    
  3. 单击运行查询

    查询将显示结果。 您可以在表视图中查看这些结果,如以下截屏所示:

    查询结果
    查询
    *

有关更多信息,请参阅 IBM Cloudant Query 教程或 IBM Cloudant Query上的 API 参考。

复制数据库

复制数据库时,它将同步两个数据库 (源和目标) 的状态。 复制会将源数据库中发生的所有更改复制到目标数据库。 从源数据库中删除文档时,还会从目标数据库中删除该文档。

有关更多信息,请参阅 复制

  1. 单击 复制

  2. 单击 新建复制

    “作业配置”页面将打开。

    此外,您可以通过单击“操作”列中的 复制 从数据库页面创建复制。

  3. 输入复制作业的以下信息。 在“源”部分中使用以下信息:

    • 输入-选择 远程数据库
    • 名称-输入数据库 URL: $SERVICE_URL/query-movies
    • 认证-保留为 None

    在“目标”部分中使用以下信息:

    • 输入-选择 新建本地数据库
    • 新数据库-输入新数据库的名称 query-movies
    • 新数据库选项-不选择“分区”选项。
    • 认证-选择 IAM 认证
    • IAM API 密钥-从实例的服务凭证输入 apikey

    有关更多信息,请参阅有关 查找服务凭证 的部分。

    使用“选项”部分中的以下信息:

    • 复制类型-保留为 One time
    • 复制文档-保留为 Custom ID (optional

    先前描述的“复制配置”页面。
    Replication configuration page

  4. 单击 启动复制

    “复制”页面将打开,您可以在其中看到复制作业正在运行。

    状态页面显示有关复制作业的信息。
    Status of your replication job

  5. 查看作业完成更改为“已完成”时的状态。

  6. 请检查是否已在数据库页面上创建数据库。

    “数据库”页面显示服务实例中每个数据库的详细信息。
    “数据库”页面

监视活动任务

“活动任务”页面显示所有正在运行的任务的列表。 当您监视系统的性能时,此列表可帮助您查找潜在问题。 您可以看到活动任务的列表,其中包括压缩,复制和建立索引。 有关更多信息,请参阅 管理任务 指南。

如果实例没有任何活动任务,那么您可以返回到上一步骤,删除 query-movies 数据库,然后再次进行复制。 如果您立即打开“活动任务”页面,那么可以看到复制。

  1. 单击活动任务

    此时将打开“活动任务”页面。

    在“活动任务”页面上,您可以看到活动任务的列表,其中包括压缩,复制和建立索引。
    活动任务

  2. 单击关联的选项卡以查看特定于任务的信息。

使用 IBM Cloudant 进行监视

使用通过读取,写入和全局查询显示吞吐量的图形来监视您的使用情况。 您可以查看当前操作,被拒绝的请求和存储器使用情况。

您的服务实例不包含任何数据,因为它仅用于演示目的。 但是,您可以通过执行以下步骤来查看可供您使用的监视信息:

  1. 单击监控

    “监视”页面将打开到“当前操作”选项卡。 通过查看按读,写和全局查询细分的请求,查看最近使用的供应吞吐量容量。 虚线是实例允许的峰值容量。 峰值容量基于为供应的吞吐量容量设置的内容。

    “当前操作”选项卡是“监视”页面的缺省选项卡。
    Current Operations

  2. 单击 被拒绝的请求

    查看由 429: too many requests 响应数显示的来自给定秒的被拒绝请求数。 当请求超过为实例设置的供应吞吐量容量时,将拒绝这些请求。 此图显示按读取数,写入数和全局查询细分的已拒绝请求数。

    “拒绝请求”选项卡显示按读,写和全局查询细分的拒绝请求。
    已拒绝请求

  3. 单击存储器

    定期查看存储器,以便在需要更改套餐的供应时做好准备。

    “存储器”选项卡包含 JSON 文档,索引和附件。
    存储器

有关更多信息,请参阅 计划和供应