---
title: "通过 ODC 连接数据库 | OceanBase 文档中心"
description: 通过 ODC 连接数据库 您可以通过 OceanBase 提供的开发者工具 ODC 来连接 OceanBase 数据库的 Oracle 和 MySQL 租户。 前提条件 请确保已经获取并安装 ODC。 您可以联系 OceanBase 技术支持人员来获取 ODC 的安装包。有关 ODC 安装的相关信息，参见 《ODC …
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

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

# 通过 ODC 连接数据库

更新时间：2023-07-18 17:25:59

您可以通过 OceanBase 提供的开发者工具 ODC 来连接 OceanBase 数据库的 Oracle 和 MySQL 租户。

## 前提条件

- 请确保已经获取并安装 ODC。

  您可以联系 OceanBase 技术支持人员来获取 ODC 的安装包。有关 ODC 安装的相关信息，参见 [《ODC 部署指南》](https://www.oceanbase.com/docs/enterprise-odc-doc-cn-10000000000515650)。
 - 请确认已从部署人员处获取 OceanBase 数据库对应的连接串。

  在 ODC 中连接数据库时会用到该连接串中的信息。

## 注意事项

在通过 ODC 连接 OceanBase 数据库时，所有用户只能连接本租户下的数据库，不能连接其他租户下的数据库。

## 操作步骤

> **说明**
>
>  
>
> 不同 ODC 版本的操作界面可能不同，本文档以 ODC V3.2.0 版本为例提供数据库的连接指导，ODC 其他版本的操作请参考 ODC 对应版本的产品文档。

1. 登录 ODC。

   进入 ODC 首页后，ODC 首页中会直接显示 **个人连接** 页签。
 2. 在 **个人连接** 页签右上角，单击 **新建连接** 按钮。

   ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer/V3.1.3/zh-CN/developer-guide/connect-to-oceanbase-database/4.%E6%96%B0%E5%BB%BA%E6%95%B0%E6%8D%AE%E5%BA%93%E8%BF%9E%E6%8E%A5.png)
 3. 在弹出的页面中，填写或选择待连接的数据库信息。

   您可以通过两种方式填写数据库连接的基础配置信息：

      - 根据 OceanBase 数据库连接串（`mysql -h` **`主机名`** `-P` **`端口号`** `-u` **`数据库用户名@租户名`** `#` **`集群名`** `-D` **`默认数据库`** `-p '` **`数据库密码`** `'`），在配置页面填写下表中的信息。
      - 在页面的 **智能解析** 项中直接粘贴数据库连接串，ODC 会自动识别连接串并在窗口中填充各项连接信息。

       | 信息项 | 说明 |
       | --- | --- |
       | 所属区域 | 选择连接实例所在的区域 **公有云** （阿里云上的数据库实例） 或 **独立部署/专有云** （在自己环境中搭建的数据库实例）。 |
       | 连接模式 | 选择 **MySQL** 或 **Oracle** 。 |
       | 连接名称 | 指定该连接的名称。 |
       | 设置标签 | 用于为连接添加提示说明类的信息。 单击 **连接名称** 文本框后的 **设置标签** 按钮为当前连接指定标签，在弹出的下拉列表中可进行设置标签和管理标签的操作：      - 设置标签：在下拉列表中选择目标标签完成设置。若列表为空请先新建标签。     - 管理标签：单击列表最下方的 **新建标签** 按钮或者单击列表上方的设置图标以弹出 **标签管理** 窗口。在标签管理窗口可对创建好的标签进行编辑和删除操作。也可单击上方的 **新建标签** 按钮指定新标签的名称和图标颜色。 |
       | 连接地址 | - **主机名** ：待连接的数据库所在服务器的 IP 信息。     - **端口号** ：待连接的数据库所在服务器的端口号信息。     - **集群** ：待连接的数据库所在集群的名称。     - **租户** ：待连接的数据库所在租户的名称。 |
       | 默认数据库 | 连接 MySQL 租户中的数据库时，需填写该连接要使用的默认数据库，连接 Oracle 租户中的数据库时则无需填写该项。 |
       | 数据库用户名 | 在租户中创建的账号（MySQL 模式下该账户必须有访问默认数据库的权限）。 |
       | 数据库密码 | 在租户中创建的账号的密码。 单击数据库密码框后的 **测试连接** 按钮，测试是否能够连接到目标数据库。如果配置信息有误，会有异常提示，例如用户或密码不对、网络异常等。 |
       | 保存数据库密码 | 关闭该项时，连接信息中将不保存数据库密码信息。每次进入连接或测试连接时，需要在弹出的密码弹窗中输入数据库密码以进入连接。 开启该项时，连接信息将保存数据库密码信息，每次进入连接无需输入数据库密码。 |
       | 智能解析 | 在文本框中粘贴连接串信息，ODC 会自动识别连接串并在窗口中填充各项连接信息。 |
       | SQL 查询超时时间 | 单击页面下方 **高级配置** 标签弹出该项。支持自定义 SQL 超时时间，默认为 60 s，超过指定的时间时查询自动终止。 |
       | 查询 sys 租户视图 | 单击页面下方 **高级配置** 标签弹出该项，当 **连接地址** 中已指定 **`租户`** 为 `sys` 时，该项被自动填充。      - **账户** ：拥有 `sys` 租户视图查看权限的账号。     - **密码** ：账号对应的密码。   输入账户和密码信息后，单击密码框后的 **测试连接** 按钮测试账户信息是否正确。    **说明**   ODC V2.3.0 及之后的版本，如果需要使用数据导入导出和查看分区信息功能，需要在此项配置 `root@sys` 账号。 |

       ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V3.2.3/zh-CN/2.user-guide/4.database-connection-and-routing/3.database-connection/%E6%96%B0%E5%BB%BA%E4%B8%AA%E4%BA%BA%E8%BF%9E%E6%8E%A5.png)
 4. 单击页面下方的 **保存** 按钮，将当前的配置信息持久保存在 ODC 连接列表中。
 5. 在连接配置列表中，单击刚刚保存的连接名或者在该连接对应的 **操作** 列中，单击 **打开** ，即可登录到 OceanBase 数据库。

## 相关阅读

通过 ODC 连接并使用 OceanBase 数据库的更多信息，请参见 ODC 对应版本的使用文档。

 上一篇 下一篇 ![有帮助](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) 咨询热线