在 DataGrip 中连接 OceanBase 数据库

DataGrip 是一款由 JetBrains 开发的集成开发环境（IDE），专门用于数据库管理和 SQL 开发，帮助数据库开发人员和数据分析师更高效地管理和查询数据库，编写复杂的 SQL 查询以及进行数据库设计和维护。本文以 OceanBase 数据库的 MySQL 租户和 macOS 操作系统为例，介绍如何在 DataGrip 中连接 OceanBase 数据库数据库。

前提条件

• 您已下载并安装 DataGrip，详情请参见 DataGrip 官方网站。

• 请确保待连接的 OBServer 节点 IP 与 DataGrip 所在机器保持网络连通。

• 您已安装 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 模式下的权限分类。

• $user_name：提供租户的连接账户。ODP 连接的常用格式：用户名@租户名#集群名 或者 集群名:租户名:用户名；直连方式格式：用户名@租户名。

• $password：提供账户密码。

更多连接串的信息，请参见 通过 OBClient 连接 OceanBase 租户。

示例如下：

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

步骤二：在 DataGrip 中创建 OceanBase 数据源进行连接

1. 如果您是首次使用 DataGrip，在您的本地打开 DataGrip 后，单击 New Project 创建一个新的项目。

2. 在创建的项目中，单击页面顶部的 图标，打开 Database Explorer 控制面板。

3. 在 Database Explorer 的左上角，选择 + > Data Source > MySQL > MySQL。

4. 在 Data Sources 弹窗中，根据 步骤一：获取 OceanBase 数据库连接串 获取的连接串完成如下配置：

   配置项	说明
   Name	自定义的 Data Source 名称。
   Host	取自连接串中 -h 参数，OceanBase 数据库连接地址。
   User	取自连接串中 -u 参数，账号名称，例如：test。
   Password	取自连接串中 -p 参数，账号密码。
   Port	取自连接串中 -P 参数，OceanBase 数据库连接端口。
   Database	取自连接串中 -D 参数，需要访问的数据库名称。

5. 单击 Test Connection，测试是否能够成功连接。

6. 显示连接成功的信息后，单击 OK，完成连接。

后续操作

完成连接后，您可开始使用 DataGrip。有关 DataGrip 的详细操作指南，请参见 DataGrip 官方使用文档。