要将数据添加到 Couchbase 的 Analytics（分析）服务中，您需要按照以下步骤进行操作。Couchbase Analytics 服务允许您在不影响事务性工作负载的情况下，对大量数据执行复杂的实时分析查询。

---

步骤 1：确保 Couchbase Analytics 服务已启用

1. 检查节点服务配置：

   • 登录 Couchbase 管理控制台。
   • 导航到顶部菜单的“Servers（服务器）”选项卡。
   • 在节点列表中，检查是否有节点启用了 Analytics 服务。
   • 如果没有节点启用该服务，您需要在现有节点上添加 Analytics 服务，或者添加一个新节点并启用该服务。

   注意：启用 Analytics 服务的节点需要有足够的资源来处理分析查询。

---

步骤 2：创建 Analytics 数据集

Analytics 数据集是 Analytics 服务用于存储和查询的数据容器，相当于关系数据库中的表。

1. 访问 Analytics Query 工作台：

   • 在 Couchbase 管理控制台中，点击顶部菜单的“Query（查询）”选项卡。
   • 在查询页面中，选择“Analytics Query”子选项卡。

2. 创建数据集：

   • 使用以下语法创建数据集：

     CREATE DATASET `<数据集名称>` ON `<桶名称>`;
     

   • 示例：

     CREATE DATASET `customer_dataset` ON `customer_bucket`;
     

     • customer_dataset：数据集的名称，可以自定义。
     • customer_bucket：您想要分析的数据所在的桶（Bucket）名称。

3. 执行语句：

   • 在查询编辑器中输入上述语句，点击“执行”按钮。

---

步骤 3：连接数据集

创建数据集后，默认情况下数据集是未连接的，需要显式连接才能开始加载数据。

1. 连接数据集：

   • 使用以下语法连接数据集：

     CONNECT DATASET `<数据集名称>`;
     

   • 示例：

     CONNECT DATASET `customer_dataset`;
     

2. 执行语句：

   • 在查询编辑器中输入上述语句，点击“执行”按钮。

3. 数据加载：

   • 一旦数据集被连接，Analytics 服务会开始从指定的桶中异步加载数据。

---

步骤 4：验证数据已成功加载

1. 查询数据集：

   • 您可以运行简单的查询来验证数据是否已加载：

     SELECT COUNT(*) FROM `customer_dataset`;
     

   • 这将返回数据集中的文档数量。

2. 查看结果：

   • 如果返回的计数大于 0，说明数据已成功加载。

---

步骤 5：执行 Analytics 查询

现在，您可以使用 Analytics 服务执行复杂的分析查询。

1. 示例查询：

   • 聚合查询：

     SELECT country, COUNT(*) AS customer_count
     FROM `customer_dataset`
     GROUP BY country;
     

     • 按国家统计客户数量。

   • 复杂查询：

     SELECT c.name, o.order_id, o.total_amount
     FROM `customer_dataset` c
     INNER JOIN `order_dataset` o ON c.customer_id = o.customer_id
     WHERE o.total_amount > 1000;
     

     • 查询消费金额大于 1000 的订单及其客户信息。

2. 执行查询：

   • 在 Analytics Query 工作台中输入查询语句，点击“执行”。

3. 查看结果：

   • 查询结果将显示在下方的结果面板中。

---

附加步骤：创建索引（可选）

为优化查询性能，您可以在 Analytics 数据集上创建索引。

1. 创建索引语法：

   CREATE INDEX `<索引名称>` ON `<数据集名称>`(`<字段1>`, `<字段2>`, ...);
   

2. 示例：

   CREATE INDEX `idx_country` ON `customer_dataset`(country);
   

3. 执行语句：

   • 在查询编辑器中输入上述语句，点击“执行”按钮。

---

注意事项

• 数据同步延迟：

  • Analytics 服务的数据集与源桶的数据是异步同步的，可能存在一定的延迟。
  • 数据集会持续接收来自源桶的新数据和更新。

• 数据治理和安全：

  • 确保您有权限访问相应的桶和数据。
  • 遵守数据隐私和合规性要求。

• 资源管理：

  • 大型数据集和复杂查询可能需要更多的系统资源。
  • 确保 Analytics 节点有足够的计算和存储能力。

---

常见问题解答

1. 如何断开数据集连接？

• 语法：

  DISCONNECT DATASET `<数据集名称>`;
  

• 示例：

  DISCONNECT DATASET `customer_dataset`;
  

2. 如何删除数据集？

• 步骤：

  1. 先断开数据集连接：

     DISCONNECT DATASET `customer_dataset`;
     

  2. 删除数据集：

     DROP DATASET `customer_dataset`;
     

3. 如何更新 Analytics 服务中的数据？

• 回答：

  • 数据集连接后，Analytics 服务会自动从源桶同步数据，无需手动更新。
  • 您只需确保数据集保持连接状态。

---

示例：完整操作流程

1. 创建数据集：

   CREATE DATASET `orders_dataset` ON `orders_bucket`;
   

2. 连接数据集：

   CONNECT DATASET `orders_dataset`;
   

3. 创建索引（可选）：

   CREATE INDEX `idx_order_date` ON `orders_dataset`(order_date);
   

4. 执行查询：

   SELECT order_date, SUM(total_amount) AS daily_sales
   FROM `orders_dataset`
   GROUP BY order_date
   ORDER BY order_date;
   

---

参考资料

• 官方文档：

  • Couchbase Analytics 服务概述
  • 创建和管理 Analytics 数据集

---