连接方式概述

本节主要介绍 Oracle 模式下连接和访问 OceanBase 数据库的方法。当前主要支持通过客户端、驱动、ORM 框架或连接池连接到 OceanBase 数据库。

客户端

在连接 OceanBase 数据库的 Oracle 兼容模式租户时，支持的客户端如下：

• OceanBase 客户端（OBClient）

  OBClient 是一个交互式和批处理查询工具，需要单独安装。它是一个命令行用户界面，在连接到数据库时充当客户端，支持 OceanBase 数据库的 Oracle 兼容模式租户。

  OBClient 在运行时需要指定 OceanBase 数据库租户的连接信息。连接上 OceanBase 数据库后，通过 OBClient 可以运行一些数据库命令、SQL 语句和 PL 语句，可以实现以下任务：

  • 计算、存储和打印查询结果。

  • 创建数据库对象、检查和修改对象定义。

  • 开发和运行批处理脚本。

  • 执行数据库管理和修改参数等。

  使用 OceanBase 客户端连接 OB Cloud 云数据库的具体操作示例请参见 通过 OBClient 连接 OB Cloud 云数据库。

• OceanBase 开发者中心（ODC）

  OceanBase 开发者中心（OceanBase Developer Center，ODC）是为 OceanBase 数据库量身打造的企业级数据库开发平台。

  ODC 支持连接 OceanBase 数据库的 MySQL 兼容模式租户和 Oracle 兼容模式租户，同时为数据库开发者提供了数据库日常开发操作、WebSQL、SQL 诊断、会话管理和数据导入导出等功能。

  使用 OceanBase 开发者中心连接 OB Cloud 云数据库的具体操作示例请参见 通过 ODC 桌面版连接 OB Cloud 云数据库。

驱动

• Java 驱动（OceanBase Connector/J）

  OceanBase Connector/J 使用标准 Java 数据库连接 (JDBC) API 为 Java 应用程序提供连接到 OceanBase 数据库的驱动程序。

  Java 数据库连接器（Java Database Connectivity，JDBC）提供了 Java 连接关系数据库的接口，是一种 Java 标准。JDBC 标准由 Sun Microsystems 定义，通过标准 java.sql 接口实现，支持各个提供程序使用自己的 JDBC 驱动程序来实现和扩展标准。JDBC 是基于 X/Open SQL 的调用级别接口（Call Level Interface，CLI）。

  OceanBase Connector/J 驱动程序属于 JDBC Type 4 驱动类型，可以通过本地协议直接与数据库引擎通信。Connector/J 驱动程序兼容 OB2.0 协议。

  注意

  OceanBase 数据库会依据 JDBC 驱动连接时的租户名称判断运行模式为 MySQL 或者 Oracle。Oracle 模式的租户只允许使用 Oracle 兼容的 SQL 语法。

  除了支持标准的 JDBC 应用程序编程接口（API），OceanBase Connector/J 还兼容 Oracle Driver 的使用方式，OceanBase 的 Oracle 模式兼容 Oracle 的大部分语法。

  OceanBase Connector/J 采用一键安装模式，驱动安装包名称为：oceanbase-client-[版本号].jar。

  获取 OceanBase Connector/J 驱动程序安装包。请在 OceanBase 官方网站下载 OceanBase JDBC 驱动程序，填写信息后自助下载 OceanBase Connector/J 驱动程序安装包。关于具体安装步骤，请参见官网文档 OceanBase Connector/J。

  使用 Java 应用程序连接 OceanBase 数据库的具体操作示例请参见 Java 应用程序连接 OB Cloud 云数据库。

• C 驱动

  • OBCI

    OBCI（OceanBase Call Interface）是与 Oracle OCI 兼容的 OceanBase C 语言接口，它提供了与 Oracle OCI 完全兼容的功能特性。

    OBCI 使您可以使用 C 语言来操作 OceanBase 数据库中的数据。它以动态链接库（OBCI 库）的形式提供了标准数据库访问功能，应用程序在运行阶段链接此库就可以使用这些功能。

    OceanBase 提供的 OBCI 是与 Oracle OCI 兼容的 OceanBase C 语言调用接口，提供了与 OCI 兼容的功能特性。使用 Oracle OCI 编写的 C 语言应用程序时，无需修改应用程序源代码，只需在链接时指定运行时库为 OBCI 库，该库文件默认安装到 /u01/obclient/lib 路径下。

    使用 C 应用程序连接 OceanBase 数据库的具体操作示例请参见 C 应用程序连接 OceanBase 数据库。

  • ODBC

    ODBC（Open Database Connectivity）是一种标准的数据库访问接口，通过它，您可以使用统一的方式连接和操作不同类型的数据库。OceanBase 提供的 ODBC 驱动允许应用程序使用标准 SQL 语法与 OceanBase 数据库交互，而无须关心底层实现细节。借助 ODBC，您可以用多种编程语言（如 C、C++ 等）开发应用程序，实现跨数据库的兼容和灵活性。配合 ODBC 驱动，开发者可以轻松地在各种环境中连接 OceanBase，简化数据访问过程，提高开发效率。

    使用 ODBC 连接 OceanBase 数据库的具体操作示例请参见 C 应用程序连接 OceanBase 数据库。

• C ORM 框架

  • SqlSugar

    SqlSugar 是一个简洁、易用的 C# ORM（对象关系映射）框架，旨在帮助开发者快速高效地进行数据库操作。SqlSugar 提供了强大的数据查询和操作功能，支持多种主流数据库，包括 OceanBase。通过 SqlSugar，开发者可以使用简单的 C# 代码执行复杂的数据库操作，避免了繁琐的 SQL 语句编写，提高了开发效率。

    使用 SqlSugar 连接 OceanBase 数据库的具体操作示例请参见 C 应用程序连接 OceanBase 数据库。

ORM 框架

ORM 对象关系映射（Object Relational Mapping，简称 ORM），是一种程序技术，用于实现面向对象编程语言里不同类型系统的数据之间的转换。从效果上说，它其实是创建了一个可在编程语言里使用的"虚拟对象数据库"。

在连接 OceanBase 数据库的 Oracle 兼容模式租户时，支持的 ORM 框架如下：

• SpringBoot

  SpringBoot 连接 OceanBase 数据库的具体操作示例请参见 SpringBoot 连接 OB Cloud 云数据库。

• SpringBatch

  SpringBatch 连接 OceanBase 数据库的具体操作示例请参见 SpringBatch 连接 OB Cloud 云数据库。

• SpringJDBC

  SpringJDBC 连接 OceanBase 数据库的具体操作示例请参见 SpringJDBC 连接 OB Cloud 云数据库。

• SpringJPA

  SpringJPA 连接 OceanBase 数据库的具体操作示例请参见 SpringJPA 连接 OB Cloud 云数据库。

• Hibernate

  Hibernate 连接 OceanBase 数据库的具体操作示例请参见 Hibernate 连接 OB Cloud 云数据库。

• MyBatis

  MyBatis 连接 OceanBase 数据库的具体操作示例请参见 MyBatis 连接 OceanBase 数据库。

连接池

数据库连接池配置是确保系统与数据库高效、稳定连接的重要步骤。合理的连接池设置不仅可以有效管理数据库连接数量，避免由于高并发导致的连接耗尽问题，还可以通过合理的超时设置，及时清理无效连接，确保系统性能。

OB Cloud 支持多种连接池连接，您可以根据业务特点自行选择连接池实现。

• Tomcat
• C3P0
• Proxool
• HikariCP
• DBCP
• Commons Pool
• Druid