在 Vercel 中连接 OB Cloud 云数据库

Vercel 面向前端与全栈开发者，提供快速的构建、部署与全球分发能力。将 OB Cloud 与 Vercel 结合使用，可基于兼容 MySQL 的 OceanBase 数据库快速构建和扩展前端应用，并借助高可用、可扩展及具备数据安全与合规能力的云数据库保障业务数据。

本文介绍如何通过配置环境变量，将 OB Cloud 云数据库连接到 Vercel 项目，使部署在 Vercel 上的应用能够访问 OceanBase 数据。

前提条件

• 您的环境中有可用的事务型（MySQL）集群实例。请先参考 创建租户 完成租户创建后，再按下列步骤操作。
• 已存在可用的 MySQL 租户、MySQL 数据库及账号，且账号已具备读写权限。如需创建，请参见 创建账号 和 创建数据库（仅 MySQL）。
• 您具备项目管理员或实例管理员角色，可对项目中实例进行读写操作；如无权限，请联系组织管理员添加。
• 已注册 Vercel 账号。若尚未注册，请参见 Vercel 文档 创建个人账号 或 创建团队。
• 已在 Vercel 中创建或导入一个项目。若尚无可部署的前端应用，可在 Vercel 中从模板创建新项目或导入已有代码仓库；您也可使用 OceanBase 提供的 Next.js Vercel 示例项目进行体验。

步骤一：获取数据库连接信息

1. 登录 OB Cloud 云数据库控制台。在实例列表页面，展开目标事务型实例的信息，在目标租户下，单击 连接 > 获取连接串。

2. 在弹出框中选择 公网连接。

3. 在 使用公共网络连接 页面完成如下设置，生成连接串：

   1. （可选）若租户没有已生成的公网地址，在 步骤 1: 获取公网地址 下，单击 获取公网地址 获取公网地址。若已有公网地址，可跳过此步骤。生成地址后，单击 下一步。

   2. 在 步骤 2: 安全设置 下，完成以下配置后，单击 下一步：

      • 添加 IP 地址白名单组：单击 添加，选择 允许所有 IP 访问，单击 确定。

      • 下载证书：单击 下载 CA 证书 下载证书并完成认证。

   3. 在 步骤 3: 访问数据库 下，选择前提条件中创建的数据库和账号，并选择 MySQL CLI 作为连接方式。完成后，复制连接串，供后续配置使用。

步骤二：在 Vercel 中配置环境变量并部署

1. 访问 Vercel 控制台，选择 Import Project > Import。

   

2. 在 Let's build something new 下的对话框中输入示例项目代码，然后单击 Continue。

   https://github.com/sc-source/oceanbase-nextjs-vercel-demo.git
   

   

3. 在部署页面中，在 Environment Variables 中添加 DATABASE_URL 环境变量：

   配置项	说明
   Key	DATABASE_URL
   Value	mysql://<User>:<Password>@<Endpoint>:<Port>/<Database>

   请将 <User>、<Password>、<Endpoint>、<Port>、<Database> 替换为 步骤一 在 OB Cloud 控制台获取的连接信息（或从复制的连接串中对应取值）。
   例如：mysql://admin:YourPassword@xxx.oceanbase.cloud:3306/my_db

   说明

   若在 Import Project 流程中配置集成，可在向导中直接填写 DATABASE_URL；若在已有项目中配置，请在 Settings > Environment Variables 中添加后，再重新部署以使变量生效。

   

4. 部署项目。部署成功后，您的 Vercel 应用即可通过 DATABASE_URL 连接 OB Cloud 云数据库进行读写。