概述

百度智能云千帆AppBuilder（以下简称AppBuilder）是基于大模型的企业级大模型应用开发管理平台，提供开箱即用的RAG/Agent/工作流/UI Builder等应用开发工具链，预置了百度AI搜索、iRAG等应用开发特色组件，以及文档理解、图像理解、语音识别等传统AI组件，同时支持零代码、低代码、全代码开发方式，旨在降低大模型应用开发门槛，提速大模型应用落地“最后一公里”。

您可以在AppBuilder连接GaiaDB数据库，基于业务数据构建专属AI应用，赋能业务高效增长。本文档将以分步演示的形式，指导您在 20 分钟内完成GaiaDB集群创建配置与AppBuilder数据库集成，全流程遵循最佳实践，操作步骤直观高效。

如果您对应用的实现效果感兴趣，可以参考其中的一个案例：NL2SQL（将自然语言转化为SQL查询）案例，零代码搭建商品供应链数据查询助手。

操作步骤

按以下步骤实现在AppBuilder连接GaiaDB：

步骤一：创建GaiaDB集群

1. 登录GaiaDB管理控制台。
2. 在 GaiaDB 控制台的左上角，选择要在其中创建GaiaDB数据库集群的区域。
3. 在云原生数据库GaiaDB 列表页面，点击创建集群按钮。在集群创建页面配置参数，全部配置详情请见购买包年包月集群和购买按量付费集群。

说明：免费版及标准版集群支持预置TPC-H测试数据集。勾选后成功创建的集群包含此数据集，数据详情可参考预置数据集（TPC-H）。

4. 确认配置
   在右侧订单明细检查所选配置。确认配置信息后，点击去支付按钮进入付款页面。
5. 支付成功
   您选择“查看订单明细”查询订单，或选择“管理控制台”进入“云原生数据库GaiaDB-集群列表”。 系统会在后台创建云原生数据库GaiaDB集群 ，大概需要10～15分钟。创建成功后，您会收到创建云原生数据库GaiaDB集群成功的信息。
6. 查看集群
   购买成功后，返回“云原生数据库GaiaDB-集群列表”页面，可看到已创建的云原生数据库GaiaDB集群，以及集群状态、实例名称和实例id等信息。

步骤二：创建数据库和数据库普通账号

创建数据库和账号后才可以访问GaiaDB集群。本文档，将创建一个名为db1的数据库（或者您可以使用创建集群时勾选的TPC-H数据库）用于测试，并创建一个名为ac1的普通账号用于登录管理db1数据库。

1. 登录GaiaDB管理控制台。
2. 在控制台页面左上角，选择集群所在地域，进入“云原生数据库 GaiaDB列表”页面。
3. 找到上一步创建的集群，点击集群名称，进入集群详情页面。

4. 创建数据库

   1. 在左侧导航栏中单击数据库管理，切换至数据库管理页面。
   2. 点击创建数据库按钮，弹出创建数据库窗口。输入数据库名称（db1）、字符集（utf8mb3）、备注。
   3. 确认输入信息无误后，单击确定按钮。

5. 创建普通账号及授权

   1. 在左侧导航栏中单击账号管理。
   2. 在账号管理子页面，点击创建账号按钮。
   3. 进入创建账号页面，输入数据库账号（ac1）及密码。
   4. 下拉权限设置可配置全局权限和库权限，勾选左侧的库，并在右侧选择读写权限。
   5. 单击确定按钮。

步骤三：设置白名单并获取公网地址

连接AppBuilder的前提是GaiaDB开启公网访问允许AppBuilder访问的IP地址通行。

说明：当前AppBuilder仅支持公网连接数据库，后续将支持内网连接的方式。

1. 登录GaiaDB管理控制台。
2. 在控制台页面左上角，选择集群所在地域，进入“云原生数据库 GaiaDB列表”页面。
3. 找到第一步创建的集群，点击集群名称，进入集群详情页面。

4. 设置白名单

   1. 在左侧导航栏中单击安全管理。
   2. 在安全管理页面，您可以新增IP白名单分组或修改已有白名单分组。
   3. 在弹出的对话框中，新增AppBuilder访问的IP（180.76.247.16,106.13.117.180）。
   4. 点击确定后，即可添加成功。

5. 获取GaiaDB公网IP

   1. 在实例列表页，找到目标GaiaDB集群，单击集群ID。
   2. 在数据库连接，开启公网IP，如下图。您可以选择连接集群地址（推荐）或者主地址，地址的区别可参考连接地址。

您需要自行保存公网IP地址，用于后续远程连接数据库。

步骤四：在AppBuilder内连接GaiaDB数据库

在AppBuilder创建数据库的操作详细可参考创建数据库。本步骤详细描述对应的GaiaDB配置。

1. 登录AppBuilder控制台。
2. 点击左侧的个人空间，点击上方的数据库，点击右侧的创建数据库按钮。

3. 选择直连数据库，输入的数据源信息如下表。

字段	填写指南	GaiaDB配置示例
数据源类型	目前支持MySQL、SQL Server两种数据源类型，根据你的数据库类型下拉选择（已支持的数据库版本：MySQL 5.6/5.7/8.0, SQL Server：2022)	MySQL（GaiaDB 100%兼容MySQL）
数据库地址Host	您输入的数据源Host必须是公网地址，如果您的数据库不能通过公网访问	GaiaDB主地址或者集群地址的公网IP（步骤三开启的IP）
端口号	输入端口号	GaiaDB主地址或者集群地址的端口号，一般为3306
数据库名	输入您的数据库名	GaiaDB内创建的数据库（如db1，或者创建时勾选的tpch）
用户名	输入用户名	GaiaDB内创建的账号（如ac1）
密码	输入密码	GaiaDB内创建账号时输入的密码（如创建ac1设置的密码，如果忘记可以重新设置，参考管理数据库账号密码）

4. 点击连接测试，测试通过后才创建成功。同一个账号下的两个数据库不可连接同一个数据源。
5. 创建数据库后，您可以创建您的AI应用（参考自主规划Agent），并且选择直连您的业务数据（参考数据库）。

常见问题

为什么在AppBuilder尝试连接后报错ip address access denied？

您可以检查是否将AppBuilder的访问IP（180.76.247.16,106.13.117.180）加入至GaiaDB的白名单。如果已经添加，可以提交工单处理。

开启公网还要收费吗？

公网连接需要创建弹性公网EIP,这项服务会收取相应的费用。