# Apache Superset Integration

## 介绍

**Manticore Search** 是一个功能强大的开源搜索引擎，以其在处理大量文本数据时的灵活性和多功能性而闻名。在我们持续努力提升用户体验并为更广泛的受众带来高级搜索功能的过程中，我们很兴奋地宣布 **Apache Superset** 中集成了 Manticore Search，这是一个领先的数据探索和可视化平台。

此集成自 Manticore Search 6.2.0 版本起可用，允许用户通过 Apache Superset 的默认 MySQL 连接器充分利用 Manticore Search 的全部潜力，简化数据分析并使用户无需深入的技术知识即可创建令人惊叹的可视化图表。

在本文中，我们将提供一个逐步教程，指导您连接 Manticore 到 Apache Superset 并添加图表。

## 逐步教程

### 步骤 1：安装和配置 Manticore Search

在将 **Manticore Search** 与 **Apache Superset** 连接之前，请确保已在服务器上正确安装和配置 Manticore Search。请参考官方 Manticore Search 指南获取 [安装和配置步骤](https://manual.manticoresearch.com/Installation/Installation) 的帮助。

### 步骤 2：设置 Apache Superset

要设置 Apache Superset，请遵循官方 [Apache Superset 安装指南](https://superset.apache.org/docs/quickstart/)。

请注意，目前我们仅支持 Apache Superset 3.x 的集成！4.x 尚未支持。

### 步骤 3：准备 Manticore Search 数据以进行可视化

在下一步中，您需要准备并在 Manticore Search 中创建表，然后加载数据以帮助我们生成图表并使用 Apache Superset 进行可视化。使用 MySQL 客户端连接到 Manticore 并执行以下查询：

我们将使用以下结构：

```sql
CREATE TABLE product_sales (
id bigint,
product_category text,
sale_date timestamp,
sales_amount float
)
```

现在，让我们添加一些数据以填充表：

```sql
INSERT INTO product_sales (product_category, sale_date, sales_amount)
VALUES
('Electronics', 1630454400, 1500),
('Fashion', 1630540800, 1200),
('Home & Garden', 1630627200, 900),
('Electronics', 1630713600, 1800),
('Fashion', 1630800000, 1100),
('Home & Garden', 1630886400, 1000);
```

### 步骤 4：将 Manticore Search 连接到 Apache Superset

1. 登录到您的 **Apache Superset** 仪表板，点击顶部导航栏中的 "+" 并选择 “数据库连接”。
    ![数据库连接](./manticoresearch-apache-superset-integration/database-connections.png)
2. 选择 "+ DATABASE" 以添加新数据库。
    ![添加数据库](./manticoresearch-apache-superset-integration/add-database.png)
3. 选择 "MySQL" 作为数据库类型。
    ![选择数据库连接器](./manticoresearch-apache-superset-integration/select-database-connector.png)
4. 在配置页面中，提供以下详细信息：
    - 数据库名称：为数据库命名（例如，"Manticore"）。
    - 填写 “主机”、“端口”、“用户名” 和 “显示名称”
        ![连接数据库设置](./manticoresearch-apache-superset-integration/connect-database-settings.png)
5. 点击 "Connect" 以验证连接并保存。

### 步骤 5：创建图表和仪表板

1. 在 Apache Superset 仪表板中，点击顶部导航栏中的 "Dashboards" 并选择 "New dashboard."
2. 打开仪表板并点击 "+" 图标以添加新图表。
3. 选择通过 MySQL 连接器连接的 Manticore Search 数据集。
4. 从可用的可视化选项列表中选择要创建的图表类型（例如，柱状图、折线图、饼图）。例如，我们将选择 `BAR CHART` 图表。

### 步骤 6：配置图表

1. 使用 Apache Superset 的查询构建器或编写 SQL 查询，从 Manticore Search 数据库中获取您要可视化的数据。
    ![数据库图表查询](./manticoresearch-apache-superset-integration/dataset-chart-query.png)
2. 根据需要自定义图表的外观、标签和其他设置。
3. 点击 "UPDATE CHART" 以更新图表。
4. 为图表命名，然后点击 "Save" 以永久保存到仪表板中。

### 步骤 7：查看图表结果

以下是使用新配置的图表和提供的数据获得的结果示例。

![图表结果](./manticoresearch-apache-superset-integration/chart-result.png)

## 结论

Manticore Search 在 Apache Superset 中的集成标志着我们在持续致力于为用户提供高级搜索功能和无缝数据可视化体验方面的重要里程碑。通过遵循此逐步教程，您可以轻松地使用默认的 MySQL 连接器将 Manticore Search 连接到 Apache Superset，并创建展示您数据真正价值的引人入胜、富有洞察力的图表。

不要错过 Manticore Search 与 Apache Superset 强大组合所带来的绝佳机会。今天就开始探索您的数据并释放其全部潜力！

阅读更多关于 [Apache Superset 集成](https://manual.manticoresearch.com/Integration/Apache_Superset#Integration-with-Apache-Superset) 的内容。