---
title: "在 Quick BI 中连接 OceanBase 并获取数据 - OceanBase 数据库 V4.3.2 | OceanBase 文档中心"
description: 在 Quick BI 中连接 OceanBase 并获取数据 本文将使用 Quick BI 专业版并以 OceanBase 数据库 MySQL 模式为例，介绍如何在 Quick BI 中 连接 OceanBase 数据库进行数据展示。 前提条件 您已购买 Quick BI 专业版。更多版本选择和具体购买详情，请参见 …
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.3.2

# 在 Quick BI 中连接 OceanBase 并获取数据

更新时间：2024-10-10 21:40:45

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.2/zh-CN/680.ecological-integration/700.visualization/400.quick-bi.md)  

本文将使用 Quick BI 专业版并以 OceanBase 数据库 MySQL 模式为例，介绍如何在 Quick BI 中 连接 OceanBase 数据库进行数据展示。

## 前提条件

- 您已购买 Quick BI 专业版。更多版本选择和具体购买详情，请参见 [Quick BI 产品计费说明](https://help.aliyun.com/zh/quick-bi/product-overview/purchases-upgrades-downgrades-renewals-and-overdue-payments?spm=a2c4g.11186623.0.0.7b5c6b9aJlPzLG)。
 - 您已安装 OceanBase 数据库并且创建了 MySQL 模式租户。

## 操作步骤

### 步骤一：获取数据库连接串

联系 OceanBase 数据库部署人员或者管理员获取相应的数据库连接串，例如：

```
obclient -h$host -P$port -u$user_name -p$password -D$database_name

```

**参数说明：**

- `$host`：提供 OceanBase 数据库连接 IP。OceanBase 数据库代理（OceanBase Database Proxy，ODP）连接方式使用的是一个 ODP 地址；直连方式使用的是 OBServer 节点的 IP 地址。
 - `$port`：提供 OceanBase 数据库连接端口。ODP 连接的方式默认是 `2883`，在部署 ODP 时可自定义；直连方式默认是 `2881`，在部署 OceanBase 数据库时可自定义。
 - `$database_name`：需要访问的数据库名称。

  #### 注意

  连接租户的用户需要拥有该数据库的 `CREATE`、`INSERT`、`DROP` 和 `SELECT` 权限。更多有关用户权限的信息，请参见 [MySQL 模式下的权限分类](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052880)。
 - `$user_name`：提供租户的连接账户。ODP 连接的常用格式：`用户名@租户名#集群名` 或者 `集群名:租户名:用户名`；直连方式格式：`用户名@租户名`。
 - `$password`：提供账户密码。

更多连接串的信息，请参见 [通过 OBClient 连接 OceanBase 租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001050310)。

**示例如下：**

```shell
obclient -hxxx.xxx.xxx.xxx -P2881 -utest_user001@mysql001 -p****** -Dtest

```

### 步骤二：在 Quick BI 中连接 连接 OceanBase 数据库

1. 登录 Quick BI 控制台，选择 **数据源 > 新建数据源**页面，搜索 **OceanBase**，选择 **Alibaba OceanBase**。

   ![](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.3.1/ecological-integration/quick-bi/create-datasource.png)
 2. 根据步骤一中获取的连接串继续完成如下配置：

   ![](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.3.1/ecological-integration/quick-bi/config-connection.png)

   | 配置项 | 说明 |
   | --- | --- |
   | 显示名称 | 自定义数据源名称。 |
   | 模式 | MySQL 模式。 |
   | 数据库地址 | 取自连接串中 `-h` 参数，OceanBase 数据库连接地址。 |
   | 端口 | 取自连接串中 `-P` 参数，OceanBase 数据库连接端口。 |
   | 数据库 | 取自连接串中 `-D` 参数，需要访问的数据库名称。 |
   | 用户名 | 取自连接串中 `-u` 参数，账号名称。 |
   | 密码 | 取自连接串中 `-p` 参数，账号密码。 |
 3. 单击**连接测试**。当顶部弹窗显示**数据源连通性正常**，表示可正常连接 OceanBase 数据库。

    ![connect-1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/cloud/OBCloud-240420/Integrations/QuickBI/connected.png)
 4. 单击**确定**。若展示如下所示页面，即代表您已成功连接并将 OceanBase 数据库添加为数据源。

    ![connector-2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/cloud/OBCloud-240420/Integrations/QuickBI/success.png)

## 后续操作

完成数据源创建后，您可开始使用 Quick BI。有关 Quick BI 的详细操作指南，请参见 [Quick BI 官方使用文档](https://help.aliyun.com/zh/quick-bi/user-guide/?spm=a2c4g.11186623.0.0.3fdc481aS1Rxz1)。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线
