事项	说明
订阅套餐	扣子付费套餐用户支持关联火山数据库。
数据隔离	仅存储线上数据，无测试数据。各个发布渠道数据互通，无隔离。暂不支持查看豆包渠道数据。
操作限制	不支持在智能体中直接添加火山数据库表，你可以通过工作流使用火山数据库。仅允许关联空间所有者对应火山引擎账号（包括主账号、子账号）中的火山数据库。仅支持关联包含主键的数据库表。

费用说明

在火山引擎侧创建云数据库 MySQL 版后，将产生相应费用，包括云数据库 MySQL 版产品费用和公网 IP 费用，由各个产品收取。

云数据库 MySQL 版根据实例规格、数据存储空间、备份存储空间、数据库代理服务、备份外网下载流量和外网流量等计费项进行收费，详情请参考云数据库 MySQL 版计费说明。
公网 IP 支持按照实际流量或带宽收费，详情请参考公网 IP 计费说明。

前提条件

已完成私有网络服务访问授权。授权方法，请参见跨服务访问授权。
已创建公网 IP 实例。具体操作，请参考申请公网 IP。
已创建私有网络。具体操作，请参考创建私有网络。

操作步骤

步骤 1：创建 MySQL 实例

在创建云数据库 MySQL 实例时，你可以根据实际的业务需求选择实例的规格、存储空间和网络配置。在关联火山数据库场景中，还需要配置白名单及用户账号信息。

登录云数据库 MySQL 版控制台。
在左侧导航栏，选择 MySQL > 实例列表，然后单击创建实例。
在创建实例页面，完成以下配置。
具体参数配置说明，请参考创建实例。其中，需设置白名单为 0.0.0.0/0，以允许扣子编程可以访问该数据库。详细说明，请参考创建白名单。
说明

设置白名单为 0.0.0.0/0，表示将允许所有地址访问该数据库。

根据页面提示，完成支付。

步骤 2：开启公网访问

为云数据库 MySQL 实例的连接终端绑定一个公网 IP 地址，以实现通过公网访问 MySQL 实例。在 MySQL 实例创建时会自动创建一个读写模式的连接终端，本文以该终端为例，为其绑定一个公网 IP 地址。关于连接终端的详细说明，请参考关于连接终端。

只有在开启公网访问功能之后，扣子编程才能连接并访问云数据库 MySQL 实例。你可以在目标云数据库 MySQL 实例的连接管理页签的终端列表区域，找到 MySQL **** 实例的连接终端，单击其公网字段中的绑定，选择提前准备好的公网 IP 地址完成绑定。具体操作，请参考开启公网访问。

步骤 3：创建数据库

创建云数据库 MySQL 实例后，你还需要创建一个数据库，用于存储和组织数据。创建数据库时，支持设置数据库的字符集等参数，以确保数据的正确存储。

在目标云数据库 MySQL 实例的数据库管理页签下，单击创建数据库，创建一个新数据库。本示例直接为数据库绑定创建 MySQL 实例时添加的高权限账号，你也可以为数据库创建一个普通账号。具体操作，请参考创建数据库和账号。

说明

使用普通账号时，需授予其对数据库的读写权限（DDL+DML），以确保该账号能够进行数据定义和数据操作。

步骤 4：创建数据库表

数据库工作台 DBW 是一款面向多类型数据库生命周期管理的统一云管平台。你可以通过数据库工作台 DBW 控制台创建数据库表。

在数据库工作台 DBW 控制台中，找到已创建的云数据库 MySQL 实例，登录其 SQL 窗口，通过可视化的界面创建数据库表。例如创建一个名为 test_table 数据库表，具体操作，请参考表管理。

说明

创建数据库表时，必须指定一个主键，否则在扣子编程关联火山数据库时，将无法获取到目标数据库表。
设置数据类型时，建议设置为数据映射表中支持的类型，避免关联火山数据库时因数据类型不匹配而导致读取数据库表失败或者出现某列数据值错误等问题。

步骤 5：关联火山数据库

完成上述操作后，你可以在扣子编程关联云数据库 MySQL 版。通过此操作，你可以将该数据库作为扣子编程资源的一种，加入到扣子编程资源库中。关联成功后，开发者便可在扣子编程的工作流中管理指定数据库表。

登录扣子编程。
在页面顶部选择目标工作空间，然后在左侧导航栏中单击资源库。
在页面右上角，选择 +资源 > 数据库。
在创建数据库对话框中，完成如下配置。
1. 单击关联火山数据库。
2. 选择目标数据库所在的火山引擎项目、地域。
3. 选择你在步骤 1：创建 MySQL 实例中创建的数据库实例，并输入其账号和密码。
  该账号需具备数据库的读写权限（DDL+DML）。
4. 单击认证。
  认证通过表示扣子编程连接云数据库 MySQL **** 实例成功。如果认证失败，请根据提示信息检查配置，例如账号密码是否正确、账号是否具备读写权限、数据库表是否存在主键、是否已配置公网 IP 地址等。
5. 选择你在步骤 3：创建数据库中创建的数据库。
6. 选择你在步骤 4：创建数据库表中创建的数据库表。
  如果你还未创建数据库表，也可以在下列列表中单击创建数据表。
7. 单击确认。

数据映射

关联火山数据库时，其数据类型将自动映射为扣子数据库的数据类型。建议在创建数据表时，根据下述表格设置数据类型，以避免映射失败。

火山数据库	扣子数据库
UNSIGNED BIGINT、UNSIGNED TINYINT、UNSIGNED INT、VARCHAR、TEXT、CHAR、LONGTEXT、MEDIUMTEXT、TINYTEXT、ENUM、SET、JSON、BLOB、LONGBLOB、MEDIUMBLOB、TINYBLOB、BINARY、VARBINARY、BIT、TIME、YEAR	STRING
DOUBLE、FLOAT、DECIMAL、NUMERIC、REAL	NUMBER
BIGINT、INT、INTEGER、SMALLINT、TINYINT、MEDIUMINT	INTEGER
BOOL、BOOLEAN	BOOLEAN
DATETIME、TIMESTAMP、DATE	TIME

常见问题

为什么关联时找不到自己创建的数据库实例？

在关联数据库时，仅允许关联空间所有者对应火山引擎账号（包括主账号、子账号）中的云数据库 MySQL 实例。如果你是某工作空间的成员，并在自己的火山引擎账号中创建了云数据库 MySQL 实例，但你的火山引擎账号和当前工作空间所有者的火山引擎账号不属于同一个主账号体系，那么你在该工作空间中无法关联自己创建的云数据库 MySQL 实例。