--- title: "通过 Liquibase 管理 OcenBase 数据库版本 - OceanBase 数据库 V4.3.5 | OceanBase 文档中心" description: 通过 Liquibase 管理 OcenBase 数据库版本 Liquibase 是一个开源的数据库版本控制工具，它支持数据库 Schema 的版本追踪、更新以及回滚。 前提条件 您已下载 Liquibase 并解压安装。 您已从 官方网站 下载 MySQL JDBC 驱动，获得 mysql-connector-j-… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.3.5 LTS # 通过 Liquibase 管理 OcenBase 数据库版本 更新时间：2026-04-14 14:16:46 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.5/zh-CN/680.ecological-integration/300.schema-evolution/200.liquibase.md) Liquibase 是一个开源的数据库版本控制工具，它支持数据库 Schema 的版本追踪、更新以及回滚。 ## 前提条件 - 您已下载 [Liquibase](https://www.liquibase.org/get-started/quickstart) 并解压安装。 - 您已从[官方网站](https://dev.mysql.com/downloads/connector/j/)下载 MySQL JDBC 驱动，获得 `mysql-connector-j-x.x.x.jar` 文件。 - 您已安装 OceanBase 数据库并且创建了 MySQL 模式租户。 ## 版本兼容性 建议使用 OceanBase 的 V4.2.3 或更高版本，以确保更好的集成体验。 ## 操作步骤 ### 步骤一：获取数据库连接串 联系 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-1000000002016100)。 - `user_name`：格式为 **用户@租户#集群名称** 或 **用户名@SERVICE:服务名**。使用格式 **用户@租户#集群名称** 时，默认租户为 'sys'，管理员用户为 'root'。直连数据库时可省略集群名称，ODP 连接时则需要填写。 - `$password`：提供账户密码。 更多连接串的信息，请参见 [通过 OBClient 连接 OceanBase 租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013251)。 **示例如下：** ```shell obclient -hxxx.xxx.xxx.xxx -P2881 -utest_user001@mysql001 -p****** -Dtest ``` ### 步骤二：使用 Liquibase 的参考示例 1. **将 JDBC 驱动放入 Liquibase 的 lib 目录下** 在您的虚拟机中，找到您解压的 Liquibase 文件夹，进入 `lib` 目录。将下载的 `mysql-connector-j-x.x.x.jar` 文件复制到此目录下。 或使用命令行： ```bash mv path/to/mysql-connector-j-x.x.x.jar path/to/liquibase/lib/ ``` 2. **新建配置文件** 在 Liquibase 的根目录下，新建一个名为 `liquibase.properties` 的配置文件。您可以使用任意文本编辑器（如 `nano`、`vim` 或 `gedit`）创建该文件，写入以下内容： ``` url: jdbc:mysql://xxx.xxx.xxx.xxx:2881/test username: your_username password: your_password classpath: lib/mysql-connector-j-8.3.0.jar ``` 请确保替换 `xxx.xxx.xxx.xxx` 为您的 OceanBase 数据库主机地址，以及输入您的数据库端口号、用户名和密码。获取数据库地址、端口号、用户名和密码参见**步骤一**。 3. **生成数据库当前结构状态的快照** 切换到 Liquibase 的根目录并执行以下命令，生成当前数据库结构的快照： ```shell ./liquibase --changeLogFile=mydatabase_changelog.xml generateChangeLog ``` 根据您使用的 Liquibase 版本，实际参数可能会有所不同，请参考 [Liquibase 官方文档](https://docs.liquibase.com/home.html?_ga=2.193221357.1372013942.1726823585-713905107.1726823585)。 4. **创建新的表** 在 Liquibase 的根目录下，新建一个名为 `dbchangelog.xml` 的文件，写入以下内容： ```xml ``` 5. **执行变更** 使用以下命令执行变更，创建 `actor` 表： ```shell ./liquibase update --changeLogFile=dbchangelog.xml ``` 6. **回滚操作** 变更成功后，您也可以尝试执行回滚操作，将数据库回退到上一个版本： ```shell ./liquibase rollbackCount 1 --changelog-file=dbchangelog.xml ``` ## 更多信息 如果在使用 Liquibase 的过程中遇到问题，建议您查阅 [Liquibase 官方文档](https://docs.liquibase.com/home.html?_ga=2.193221357.1372013942.1726823585-713905107.1726823585)。 上一篇 下一篇 ![有帮助](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) 咨询热线