> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> RocketBI 是一个自助式商业智能平台，可帮助你快速分析数据、创建拖放式可视化内容，并直接在 Web 浏览器中与同事协作。

# 目标：使用 Rocket.BI 搭建你的第一个仪表盘

export const CommunityMaintainedBadge = () => {
  return <div className="CommunityMaintainedBadge">
            <div className="CommunityMaintainedIcon">
            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 256 256">
                <path d="M244.8,150.4a8,8,0,0,1-11.2-1.6A51.6,51.6,0,0,0,192,128a8,8,0,0,1-7.37-4.89,8,8,0,0,1,0-6.22A8,8,0,0,1,192,112a24,24,0,1,0-23.24-30,8,8,0,1,1-15.5-4A40,40,0,1,1,219,117.51a67.94,67.94,0,0,1,27.43,21.68A8,8,0,0,1,244.8,150.4ZM190.92,212a8,8,0,1,1-13.84,8,57,57,0,0,0-98.16,0,8,8,0,1,1-13.84-8,72.06,72.06,0,0,1,33.74-29.92,48,48,0,1,1,58.36,0A72.06,72.06,0,0,1,190.92,212ZM128,176a32,32,0,1,0-32-32A32,32,0,0,0,128,176ZM72,120a8,8,0,0,0-8-8A24,24,0,1,1,87.24,82a8,8,0,1,0,15.5-4A40,40,0,1,0,37,117.51,67.94,67.94,0,0,0,9.6,139.19a8,8,0,1,0,12.8,9.61A51.6,51.6,0,0,1,64,128,8,8,0,0,0,72,120Z"></path>
            </svg>
        </div>
            Community Maintained
        </div>;
};

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

在本指南中，你将安装 Rocket.BI，并用它搭建一个简单的仪表盘。
下面就是这个仪表盘：

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_01.gif?s=7b11f13f19fbcfdecdf22de78642b4cc" alt="显示销售指标、图表和 KPI 的 Rocket BI 仪表盘" border width="1200" height="651" data-path="images/integrations/data-visualization/rocketbi_01.gif" />

<br />

你可以通过[此链接查看该仪表盘](https://demo.rocket.bi/dashboard/sales-dashboard-7?token=7eecf750-cbde-4c53-8fa8-8b905fec667e)。

<div id="install">
  ## 安装
</div>

使用我们预先构建的 Docker 镜像启动 RocketBI。

获取 docker-compose.yml 和配置文件：

```bash theme={null}
wget https://raw.githubusercontent.com/datainsider-co/rocket-bi/main/docker/docker-compose.yml
wget https://raw.githubusercontent.com/datainsider-co/rocket-bi/main/docker/.clickhouse.env
```

编辑 `.clickhouse.env`，添加 ClickHouse server 的信息。

运行以下命令启动 RocketBI：`docker-compose up -d .`

打开浏览器，访问 `localhost:5050`，使用以下账号登录：`hello@gmail.com/123456`

如需从源码构建或进行高级配置，可在此查看 [Rocket.BI Readme](https://github.com/datainsider-co/rocket-bi/blob/main/README.md)

<div id="lets-build-the-dashboard">
  ## 开始创建仪表盘
</div>

在 Dashboard 中，你会看到自己的报表。点击 **+New** 即可开始进行可视化。

你可以创建**不限数量的仪表盘**，并在单个仪表盘中绘制**不限数量的图表**。

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_02.gif?s=01eda82e51fa011f0b20bf39bc83ebbf" alt="展示在 Rocket BI 中创建新图表过程的动画" border width="800" height="434" data-path="images/integrations/data-visualization/rocketbi_02.gif" />

<br />

在 YouTube 上查看高清教程：[https://www.youtube.com/watch?v=TMkdMHHfvqY](https://www.youtube.com/watch?v=TMkdMHHfvqY)

<div id="build-the-chart-controls">
  ### 设置图表控件
</div>

<div id="create-a-metrics-control">
  #### 创建指标控件
</div>

在 Tab 过滤器中，选择要使用的指标字段。请务必留意聚合设置。

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_03.png?fit=max&auto=format&n=8vRlAzTPu3QtBgl8&q=85&s=3e8b7e659a89015a3c2efdfb22bcad96" alt="Rocket BI 指标控件配置面板，显示已选字段和聚合设置" border width="1646" height="863" data-path="images/integrations/data-visualization/rocketbi_03.png" />

<br />

重命名过滤器，并将控件保存到仪表盘

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_04.png?fit=max&auto=format&n=8vRlAzTPu3QtBgl8&q=85&s=d3f1b5fe6ba64b5a50f8b1e43553c624" alt="已重命名过滤器、可保存到仪表盘的指标控件" border width="1156" height="138" data-path="images/integrations/data-visualization/rocketbi_04.png" />

<div id="create-a-date-type-control">
  #### 创建日期类型控件
</div>

选择一个 Date 字段作为主日期列：

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_05.png?fit=max&auto=format&n=8vRlAzTPu3QtBgl8&q=85&s=18d5bd1912480daac85153dede1e1354" alt="Rocket BI 中的日期字段选择界面，显示可用的日期列" border width="1646" height="863" data-path="images/integrations/data-visualization/rocketbi_05.png" />

<br />

添加查找范围不同的重复变体。例如，按年、按月、按日或按星期几。

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_06.png?fit=max&auto=format&n=8vRlAzTPu3QtBgl8&q=85&s=cc44a2b854fc17a2fb249c787985a52f" alt="日期范围配置，显示按年、按月和按日等不同的时间段选项" border width="1646" height="863" data-path="images/integrations/data-visualization/rocketbi_06.png" />

<br />

重命名过滤器，并将控件保存到仪表盘

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_07.png?fit=max&auto=format&n=8vRlAzTPu3QtBgl8&q=85&s=38aa7cd5ceb5b2ca675fe7b4ac12ae92" alt="已重命名过滤器并准备保存到仪表盘的日期范围控件" border width="346" height="444" data-path="images/integrations/data-visualization/rocketbi_07.png" />

<div id="now-let-build-the-charts">
  ### 现在，开始创建图表
</div>

<div id="pie-chart-sales-metrics-by-regions">
  #### 饼图：按区域划分的销售指标
</div>

选择 Adding new chart，然后选择 Pie Chart

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_08.png?fit=max&auto=format&n=8vRlAzTPu3QtBgl8&q=85&s=56f80fe11f05d8b1049788ae9c8c71de" alt="图表类型选择面板，其中饼图选项已高亮显示" border width="1860" height="1312" data-path="images/integrations/data-visualization/rocketbi_08.png" />

<br />

首先，将 Dataset 中的“Region”列拖放到 Legend Field

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_09.png?fit=max&auto=format&n=8vRlAzTPu3QtBgl8&q=85&s=5763d3eac89b68328bd9a5d29120a7e0" alt="拖放界面，显示将 Region 列添加到图例字段" border width="2562" height="1486" data-path="images/integrations/data-visualization/rocketbi_09.png" />

<br />

然后，切换到图表控件标签页

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_10.png?fit=max&auto=format&n=8vRlAzTPu3QtBgl8&q=85&s=e7f001e3c91ee5262a66d3d73ab99056" alt="图表控件标签页界面，显示可视化配置选项" border width="1420" height="918" data-path="images/integrations/data-visualization/rocketbi_10.png" />

<br />

将指标控件拖放到 Value Field

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_11.png?fit=max&auto=format&n=8vRlAzTPu3QtBgl8&q=85&s=8d09bae4567c2554875ce8c490102a4c" alt="将指标控件添加到饼图的值字段中" border width="2532" height="1484" data-path="images/integrations/data-visualization/rocketbi_11.png" />

<br />

(你也可以将 指标控件 用于排序)

前往 Chart Setting 进行进一步自定义

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_12.png?fit=max&auto=format&n=8vRlAzTPu3QtBgl8&q=85&s=455e7f2fa5e79e8391c3a743100df40d" alt="图表设置面板，显示饼图的自定义选项" border width="1130" height="806" data-path="images/integrations/data-visualization/rocketbi_12.png" />

<br />

例如，将 Data label 更改为 Percentage

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_13.png?fit=max&auto=format&n=8vRlAzTPu3QtBgl8&q=85&s=d41e35eabc0da39cec1e2f25caceb896" alt="数据标签设置已更改为在饼图上显示百分比" border width="2534" height="1468" data-path="images/integrations/data-visualization/rocketbi_13.png" />

<br />

保存并将图表添加到仪表盘

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_14.png?fit=max&auto=format&n=8vRlAzTPu3QtBgl8&q=85&s=1a5d95dd82af3e313d3574a791663fdd" alt="仪表盘视图，显示新添加的饼图和其他控件" border width="1566" height="1056" data-path="images/integrations/data-visualization/rocketbi_14.png" />

<div id="use-date-control-in-a-time-series-chart">
  #### 在时间序列图表中使用日期控件
</div>

让我们使用堆叠柱状图

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_15.png?fit=max&auto=format&n=8vRlAzTPu3QtBgl8&q=85&s=8d03314b280a822e8fa6fc998b228cca" alt="使用时间序列数据创建堆叠柱状图的界面" border width="1836" height="1332" data-path="images/integrations/data-visualization/rocketbi_15.png" />

<br />

在图表控件中，将指标控件用作 Y 轴，将日期范围用作 X 轴

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_16.png?fit=max&auto=format&n=8vRlAzTPu3QtBgl8&q=85&s=40f4da123d8d1320965ece0a4ea0b3d9" alt="图表控件配置，Y 轴显示指标，X 轴显示日期范围" border width="2552" height="1496" data-path="images/integrations/data-visualization/rocketbi_16.png" />

<br />

将区域列添加到 Breakdown 中

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_17.png?fit=max&auto=format&n=8vRlAzTPu3QtBgl8&q=85&s=c838a9d4806b1a6f233b65099d901985" alt="将区域列添加为堆叠柱状图中的 breakdown 维度" border width="2552" height="1496" data-path="images/integrations/data-visualization/rocketbi_17.png" />

<br />

添加数值图表作为 KPI，并美化仪表盘

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-home-button/8vRlAzTPu3QtBgl8/images/integrations/data-visualization/rocketbi_18.png?fit=max&auto=format&n=8vRlAzTPu3QtBgl8&q=85&s=0de1f78d7d575be89b682ae79b4dda7c" alt="包含 KPI 数值图表、饼图和时间序列可视化的完整仪表盘" border width="2788" height="1506" data-path="images/integrations/data-visualization/rocketbi_18.png" />

<br />

现在，你已经成功搭建出第一个 rocket.BI 仪表盘