数据连接

导入到新数据表

1. 输入数据表名称。并配置数据表，选择可直接上传Excel或自定义表头。

   • 直接上传Excel：阿里云百炼将自动识别上传文件中的表头，并据此来创建数据表结构，并将其余内容作为数据记录导入该表。

   • 自定义表头：列名为必填参数，描述为选填参数，类型为必填参数。

     重要

     • 数据表的结构（列名、描述以及类型）一旦确定，无法修改。

     • 上传文件的表结构必须与待导入数据文件的结构（列数、列名）完全一致，否则导入会失败。例如，待导入的数据表有2列，这里的表结构必须配置2个字段，且列名需一一对应。可通过点击新增字段或操作列的删除，来增加或删减字段。

     • 为帮助模型理解各字段含义（如 age 表示年龄），请在“描述”中提供清晰的自然语言说明。

     • 若字段类型设为 image_url，请确保链接是公开可访问的图片URL。知识库会用此链接抓取图片并为其生成向量索引，用于以图搜图等场景。

       image_url格式示例：https://example.com/downloads/pic.jpg

       创建知识库时，image_url类型字段用于生成图片索引。阿里云百炼会访问目标图片并提取其特征，然后通过图片Embedding转换为向量并保存。知识库检索时，会用该向量与用户上传图片的向量进行相似度比对。

2. 点击图标选择并上传文件（XLSX或XLS格式）。

   文件必须包含表头，否则会导入失败。

   目前平台不支持直接导入JSON、CSV、YAML格式文件。请自行用相应工具将其转换为XLSX或XLS格式再导入。

3. 点击确定，开始导入。完成后，左侧的数据表导航树中将出现新数据表。

导入到现有数据表

1. 在左侧的数据表列表中选择相应的数据表，然后点击导入数据。

2. 导入类型选择覆盖上传或增量上传。

   点击界面上的下载模板，可获取一个仅包含表头的空白文件。您可直接在该文件中插入新数据，然后将其用于覆盖上传或增量上传。

3. 点击图标选择并上传文件（XLSX或XLS格式）。

   文件必须包含表头，且与当前数据表的表头结构一致，否则会导入失败。

   目前平台不支持直接导入JSON、CSV、YAML格式文件。请自行用相应工具将其转换为XLSX或XLS格式再导入。

新建公网数据源

1. 为确保知识库能正常接收RDS数据，请为RDS实例设置EventBridge白名单。

   若未正确设置白名单，创建数据源时会提示Communications link failure。

   如何设置EventBridge白名单

   1. 访问RDS控制台，点击左侧导航栏中的实例列表，然后点击包含数据表的RDS实例。接着，点击左侧导航栏中的数据库连接，点击外网地址旁的设置白名单。

   2. 点击添加白名单分组，并将以下 EventBridge 公网 IP 地址全部添加至白名单分组中。

      • 39.105.55.188,39.105.110.43,47.95.35.213,47.95.33.100,39.106.255.198,47.93.177.159,47.95.32.154,39.107.99.72

   3. 点击确定，白名单生效。

2. 填写数据源相关配置：

   配置项	说明
   数据源名称	数据源名称在同一个业务空间中应是唯一的。即使数据源创建失败，该名称也无法再次使用。
   数据库实例	填写RDS实例ID。请前往RDS控制台，点击左侧导航栏中的实例列表获取。
   数据库地址	填写RDS实例的外网地址。您可以在RDS实例的数据库连接界面获取该信息：前往RDS控制台，点击左侧导航栏中的实例列表，然后点击包含数据表的RDS实例。接着，点击左侧导航栏中的数据库连接，即可查看该实例对应的外网地址。 若该 RDS 实例未开通外网地址，请先按照界面指引完成 RDS 外网地址开通。 高可用系列RDS请勿使用数据库代理连接区域的代理连接地址或内网地址。
   数据库端口	填写RDS实例的外网端口。该信息同样可以在RDS实例的数据库连接界面获取。
   数据库用户名	数据库账号类型需为高权限账号，关于账号说明和获取方式请参见创建账号。 使用普通账号创建数据源时会提示There is no permission:RELOAD。

3. 点击创建数据源，提交新建任务。系统将自动配置 RDS 数据源，期间业务空间将被锁定，无法同时创建其他数据源。

   首次提交任务时，请根据界面指引开通EventBridge服务关联角色，请使用主账号操作。如需使用RAM用户，需主账号为该RAM用户配置必要权限。

   在请求高峰时段，创建数据源过程可能需要几分钟，请耐心等待。

   状态	说明
   创建成功	表示数据源创建成功。请选择该数据源并执行下一步。
   创建失败	表示数据源创建失败。请检查各项参数是否正确，修改后点击重试重新创建数据源。您可点击删除，删除创建失败的数据源。

新建私网数据源

1. 填写数据源相关配置：

   配置项	说明
   数据源名称	数据源名称在同一个业务空间中应是唯一的。即使数据源创建失败，该名称也无法再次使用。
   所属地域	选择RDS实例所在地域。请前往RDS控制台，点击左侧导航栏中的实例列表获取。
   数据库实例	填写RDS实例ID。请前往RDS控制台，点击左侧导航栏中的实例列表获取。
   数据库地址	填写RDS实例的内网地址。您可以在RDS实例的数据库连接界面获取该信息：前往RDS控制台，点击左侧导航栏中的实例列表，然后点击包含数据表的RDS实例。接着，点击左侧导航中的数据库连接，即可查看该实例对应的内网地址。 高可用系列RDS请勿使用数据库代理连接区域的代理连接地址或内网地址。
   数据库端口	填写RDS实例的内网端口。该信息同样可以在RDS实例的数据库连接界面获取。
   数据库用户名	数据库账号类型需为高权限账号，关于账号说明和获取方式请参见创建账号。 使用普通账号创建数据源时会提示There is no permission:RELOAD。

2. 连通性检测：点击开始检测，对阿里云百炼与数据源之间的网络连通性进行检查。

   首次检测时，请根据界面指引开通EventBridge服务关联角色，请使用主账号操作。如需使用RAM用户，需主账号为该RAM用户配置必要权限。

   VPC ID	应填写RDS实例的VPC ID。该信息同样可以在RDS实例的数据库连接界面获取。 VPC ID 显示在该页面的网络类型区域中。
   VSwitch ID	将鼠标悬浮于RDS实例的VPC ID上即可显示VSwitch ID。 RDS MySQL高可用系列实例可能拥有多个 VSwitch ID，请完整填写该实例关联的所有 VSwitch ID。 在 RDS 控制台左侧菜单选择数据库连接，在网络类型信息区域将鼠标悬浮于 VPC ID 上，即可在下方查看 VSwitch ID。
   安全组ID	可直接使用托管安全组；如需使用指定安全组，该安全组应为直接创建，非由第三方产品或服务间接创建。您可以前往ECS控制台的安全组界面创建安全组。该安全组需满足以下要求： 安全组的地域需与上方所属地域保持一致； 安全组的网络需选择RDS所在的VPC，即在创建安全组页面的网络下拉框中选择RDS实例所在的VPC； 安全组类型支持普通安全组和企业级安全组。 安全组的网络入方向未设置任何访问限制； 正确示例： 安全组详情页中，安全组ID 以 sg 开头（此处部分信息已脱敏），组内连通策略 为 组内互通，安全组类型 为 普通安全组。访问规则 区域选中 入方向 Tab，当前入方向未设置任何访问规则限制（0 条）。 错误示例：安全组入方向配置了 5 条允许规则（优先级均为 1）：所有 ICMP-IPv4（端口 -1/-1）、自定义 TCP 端口 RDP(3389)、自定义 TCP 端口 SSH(22)、自定义 TCP 端口 HTTPS(443)、自定义 TCP 端口 HTTP(80)，访问来源均为 0.0.0.0/0。入方向虽然允许任意 IP 访问，但仅开放了特定端口。

3. 连通性检测通过后，点击确认，提交新建任务。系统将为您自动配置RDS数据源，期间当前业务空间会被锁定，禁止同时创建其他数据源。

   在请求高峰时段，创建数据源过程可能需要几分钟，请耐心等待。

   状态	说明
   创建成功	表示数据源创建成功。请选择该数据源并执行下一步。
   创建失败	表示数据源创建失败。请检查各项参数是否正确，修改后点击重试重新创建数据源。您可点击删除，删除创建失败的数据源。

新建公网数据源

1. 为确保知识库能正常接收数据，请为您的自建MySQL配置EventBridge白名单。

   若未正确配置白名单，创建数据源时会提示Communications link failure。

   如何设置EventBridge白名单

   1. 访问ECS控制台，点击左侧导航栏中的安全组，找到与您自建MySQL关联的安全组，然后点击操作栏中的管理规则。

   2. 在安全组详情页，点击增加规则，将以下EventBridge公网IP地址全部添加至该安全组中，并且需要放行所有流量和全部端口。

      不可使用由第三方产品或服务间接创建的安全组。

      • 39.105.55.188,39.105.110.43,47.95.35.213,47.95.33.100,39.106.255.198,47.93.177.159,47.95.32.154,39.107.99.72

   3. 点击确定，安全组生效。

   4. 在您的MySQL中，创建一个允许全部来源流量的数据库账号（也可以使用已有账号）然后执行以下GRANT授权命令。

      请根据您的实际情况，将下方命令中的user1替换为您的实际数据库账号。

      -- 创建用户（合并为单条语句），请将user1替换为您的实际数据库账号
      CREATE USER 'user1'@'%' IDENTIFIED BY 'user1的密码';
      -- 授予基础权限（合并为单条语句），请将user1替换为您的实际数据库账号
      GRANT ALL PRIVILEGES ON *.* TO 'user1'@'%' WITH GRANT OPTION;
      -- 刷新权限（仅需一次）
      FLUSH PRIVILEGES;

   5. 通过修改MySQL配置文件开启Binlog和GTID。以Linux系统为例，MySQL配置文件一般位于：/etc/my.cnf 或 /etc/mysql/my.cnf。

      [mysqld]
      log-bin=mysql-bin
      server-id=1
      binlog_format=ROW
      gtid_mode=ON
      enforce_gtid_consistency=ON

   6. 重启MySQL，配置文件生效。

2. 填写数据源相关配置：

   配置项	说明
   数据源名称	数据源名称在同一个业务空间中应是唯一的。即使数据源创建失败，该名称也无法再次使用。
   数据库地址	填写您自建MySQL的公网地址。
   数据库端口	填写您自建MySQL的端口。
   数据库用户名	填写您在前面加白步骤中执行过GRANT授权的数据库账号。

3. 点击创建数据源，提交新建任务。系统将为您自动配置自建MySQL数据源，期间当前业务空间会被锁定，禁止同时创建其他数据源。

   首次提交任务时，请根据界面指引开通EventBridge服务关联角色，请使用主账号操作。如需使用RAM用户，需主账号为该RAM用户配置必要权限。

   在请求高峰时段，创建数据源过程可能需要几分钟，请耐心等待。

   状态	说明
   创建成功	表示数据源创建成功。请选择该数据源并执行下一步。
   创建失败	表示数据源创建失败。请检查各项参数是否正确，修改后点击重试重新创建数据源。您可点击删除，删除创建失败的数据源。

新建私网数据源

1. 为确保知识库能正常接收数据，请为您的自建MySQL配置EventBridge白名单。

   若未正确配置白名单，创建数据源时会提示Communications link failure。

   如何设置EventBridge白名单

   1. 在您的MySQL中，创建一个允许全部来源流量的数据库账号（也可以使用已有账号）然后执行以下GRANT授权命令。

      请根据您的实际情况，将下方命令中的user1替换为您的实际数据库账号。

      -- 创建用户（合并为单条语句），请将user1替换为您的实际数据库账号
      CREATE USER 'user1'@'%' IDENTIFIED BY 'user1的密码';
      -- 授予基础权限（合并为单条语句），请将user1替换为您的实际数据库账号
      GRANT ALL PRIVILEGES ON *.* TO 'user1'@'%' WITH GRANT OPTION;
      -- 刷新权限（仅需一次）
      FLUSH PRIVILEGES;

   2. 通过修改MySQL配置文件开启Binlog和GTID。以Linux系统为例，MySQL配置文件一般位于：/etc/my.cnf 或 /etc/mysql/my.cnf。

      [mysqld]
      log-bin=mysql-bin
      server-id=1
      binlog_format=ROW
      gtid_mode=ON
      enforce_gtid_consistency=ON

   3. 重启MySQL，配置文件生效。

2. 填写数据源相关配置：

   配置项	说明
   数据源名称	数据源名称在同一个业务空间中应是唯一的。即使数据源创建失败，该名称也无法再次使用。
   所属地域	请选择您自建MySQL所部署ECS实例所在地域。该信息可以前往ECS控制台获取。
   数据库地址	填写您自建MySQL的私网地址。您可以在ECS的实例界面获取该信息：前往ECS控制台，点击左侧导航栏中的实例，即可查看对应实例的私网地址。
   数据库端口	填写您自建MySQL的端口。
   数据库用户名	填写您在前面加白步骤中执行过GRANT授权的数据库账号。

3. 连通性检测：点击开始检测，对阿里云百炼与数据源之间的网络连通性进行检查。

   首次提交任务时，请根据界面指引开通EventBridge服务关联角色，请使用主账号操作。如需使用RAM用户，需主账号为该RAM用户配置必要权限。

   VPC ID	填写您自建MySQL所部署ECS实例所在VPC的实例ID（vpc-xxxxxx）。该信息同样可以前往ECS控制台获取。 在左侧导航栏选择实例与镜像 > 实例，在实例列表中找到目标实例，在专有网络列中即可查看对应的 VPC ID 和交换机 ID。
   VSwitch ID	实例VPC ID下方即是VSwitch ID（vsw-xxxxxx）。
   安全组ID	可直接使用托管安全组；如需使用指定安全组，该安全组应为直接创建，非由第三方产品或服务间接创建。您可以前往ECS控制台的安全组界面创建安全组。该安全组需满足以下要求： 安全组的地域需与上方所属地域保持一致； 安全组的网络需选择ECS所在的VPC； 安全组类型支持普通安全组和企业级安全组。 入方向未设置任何访问限制；

4. 连通性检测通过后，点击创建数据源，提交新建任务。系统将为您自动配置MySQL数据源，期间当前业务空间会被锁定，禁止同时创建其他数据源。

   在请求高峰时段，创建数据源过程可能需要几分钟，请耐心等待。

   状态	说明
   创建成功	表示数据源创建成功。请选择该数据源并执行下一步。
   创建失败	表示数据源创建失败。请检查各项参数是否正确，修改后点击重试重新创建数据源。您可点击删除，删除创建失败的数据源。