Metabase 一款开源的轻量 BI 工具，帮助您快速从数据库中分析数据、生成可视化报表。本文将介绍如何使用 Metabase 连接至 ByteHouse。

1. 安装 Docker，用于使用 Docker 运行 Metabase。
2. 获取 ByteHouse 企业版集群连接地址、ByteHouse 企业版账号和密码，用于后续 Metabase 连接配置，详情请参考获取集群连接信息。

1. 执行以下命令，使用 Docker 运行 Metabase。执行后，在浏览器中打开 http://localhost:3000/ 以访问 Metabase 界面。具体用法可参考 Metabase 官方网站。

   注意

   • 对于 Metabase 0.55 及以上版本，需要添加 clickhouse.jdbc.v1=true 参数以确保与 ByteHouse 的正常连接。
   • 如果您未使用 Docker 运行 Metabase，请直接添加 -Dclickhouse.jdbc.v1=true 启动参数。

   # Metabase 0.55 及以上版本
   docker run -d -p 3000:3000 --name metabase -e "MB_JAVA_OPTS=-Dclickhouse.jdbc.v1=true" metabase/metabase
   
   # Metabase 0.54 及以下版本
   docker run -d -p 3000:3000 --name metabase metabase/metabase
   

2. 下载 ClickHouse Metabase 插件 jar 文件。
   由于 Metabase 通过 Docker 容器部署，所以需要进入容器并下载 ClickHouse Metabase 插件 jar 文件到 plugins 目录下。
   使用时，请将 <container_id> 替换为您实际使用的容器 ID，您可通过执行 docker ps 查看运行中的容器。

   docker exec -it <container_id> bash
   cd plugins
   wget https://github.com/ClickHouse/metabase-clickhouse-driver/releases/download/1.3.3/clickhouse.metabase-driver.jar
   

3. 退出并重启容器，确保 ClickHouse Metabase 插件可生效。

   docker restart <container_id>
   

4. 重新打开 http://localhost:3000/ 以访问 Metabase 界面。

添加数据库

1. 单击右上角的齿轮图标，然后选择管理员 Admin Settings，访问您的 Metabase 管理页面。

2. 单击添加数据库 Add a database。或者，您可以单击“数据库 Databases”选项卡并选择“添加数据库 Add database”按钮。

3. 如果您的驱动程序安装成功，您将在数据库类型 Database type 的下拉菜单中看到 ClickHouse：
   

4. 为您的数据库指定一个显示名称 Display name，您可自定义名称。

5. 输入 ByteHouse 数据库的连接详细信息。

   参数	配置说明
   Host	ByteHouse 集群连接地址。您可在 ByteHouse 企业版控制台的集群管理 > 集群名称 > 基本信息 > 网络信息中查看并复制公网网关地址，详情请参见获取集群连接信息。
   Port	ByteHouse 集群连接端口，设置为 8123，如果您启用了 SSL，也可设置为 8443。
   Username	ByteHouse 用户名，支持使用 IAM 子用户和数据库用户访问，二者的区别可参见用户类型。 IAM 子用户：您可登录 ByteHouse 企业版控制台，单击右上角 ByteHouse 个人中心，单击账号管理，查看并复制集群连接账号中的用户名，详情请参见获取集群连接信息。 数据库用户：您可登录 ByteHouse 企业版控制台，单击顶部权限管理，单击用户，在用户列表中查看用户类别为 Database 的用户，并复制该用户名。
   Password	ByteHouse 密码。您可登录 ByteHouse 企业版控制台，单击右上角 ByteHouse 个人中心，单击账号管理，查看并复制集群连接账号中的密码，详情请参见获取集群连接信息。
   Database	需连接的 ByteHouse 数据库名。
   Use a secure connection (SSL)	是否启用安全连接（SSL）。

   

6. 单击“保存”按钮，Metabase 将扫描数据库中的表，您可使用 Metabase 对获取的 ByteHouse 数据进行分析，更堵数据分析的操作请参见 Metabase 官方文档。