跳到正文
AskTable

文档反馈

当前页面连接数据源/data/connect

0 / 5,000

反馈将发送给维护团队。

前往控制台
前往控制台
AskTable
前往控制台

配置与管理

连接数据源

连接数据库或上传文件，选择需要分析的数据。

先连接数据库或上传文件，再选择需要分析的表。AskTable 会读取数据结构，并在提问时查询相关数据。

开始前

项目要求
权限项目负责人或项目管理员；普通项目成员没有数据源配置写权限
前置数据库侧开好只读账号，且从 AskTable 服务器网络可达
入口左侧主导航 → 「更多」→ 「数据源」

页面标题是「数据源」，右上角按钮是「添加数据源」；搜索框可以按名称过滤列表。

操作步骤

选择类型

创建流程顶部有三个步骤：「选择类型」「配置连接」「添加数据表」。

类型卡片按三组排列，分组标题是「文件」「数据库」「大数据」。点中一张卡片直接进入下一步。

配置连接（数据库类）

填数据源名称、主机、端口、用户名、密码，再加一个库名输入框：

  • 数据源名称可以留空，留空时会自动生成。
  • 端口预填该引擎的常用端口，可以直接改。
  • 库名输入框的标题随引擎变化：多数引擎是数据库DB，Oracle 是 Service Name，Databend 另有计算集群。
  • 允许多库的引擎（例如 MySQL）可以在同一个框里填多个库名，用英文逗号分隔，留空表示全部数据库。

云端部署时主机字段下方会提示把 AskTable 服务器（47.100.25.242）加入数据库白名单。

点右下角「立即添加」，系统先自动测试一次连接，通过后进入下一步；失败时弹出连接失败对话框，正文是数据库返回的原始错误。

添加数据表

选表页标题是「选择数据表」，上方有「表」「视图」两个页签，搜索框可以按表名或视图名过滤，右侧是「排序」和「全选」。

勾选要同步的表后点「确认选择 (N)」；一张表都没勾时按钮不可点。想以后再选就点「跳过」，之后可以随时在数据源的详情页重新选表。

这一步下方有一个同步 Value Index（提升字段值检索精度）的勾选框，默认不勾选；说明文字写着构建耗时较长，建议仅在数据量较小或检索要求高时开启，也可以在创建后手动触发。它的作用见 AI 索引。

上传文件（Excel / CSV）

类型选「Excel / CSV」时，第二步变成上传页：填数据源名称，再把文件拖进虚线区或点击选择。

虚线区可以点击选择文件，也可以把文件拖进去；支持的格式是 .xlsx、.xls、.csv，一次可以传多个。已选文件列在下方，每条可以单独移除。

点「立即添加」完成创建，直接回到「数据源」列表页。

创建工作簿（第三种走法）

类型选「工作簿」会跳到独立的「新建工作簿」页，先填数据源名称，再从三种方式里选一个：

方式说明
「Excel 导入」上传 Excel 或 CSV，解析后建一个可编辑的工作簿
「从飞书多维表格同步」连接飞书应用，选表后建只读的同步工作簿
「空白工作簿」先建空簿，再手动加工作表和字段

支持的数据源类型

清单与创建页的类型卡片一一对应，括号里是卡片上显示的版本。

文件：「Excel / CSV」（.xlsx / .xls / .csv）、「工作簿」（Beta）

数据库：MySQL（5.7 / 8.0）、PostgreSQL（9/14/15/16）、PolarDB（MySQL 5.7 / 8.0）、PolarDB（PostgreSQL 14/15/16）、OceanBase（4.2.2）、达梦（DM8）、虚谷（V11 / V12）、TiDB（8.1.0）、Oracle（18c / 12c）、SQL Server（2012 / 2016 Web）、MogDB（5.0.0）、GaussDB（主备版）、TDSQL（MySQL）、TDSQL（PostgreSQL）、金仓 KingbaseES（V8）、GBase 8c（V5）、崖山 YashanDB（23.2）、DAP（Beta）

大数据：StarRocks（3.x）、ClickHouse（22.12）、Doris（3.0.5）、Hive（3.x）、MaxCompute（2025）、Google BigQuery、Hologres（r3.2.x）、AnalyticDB（MySQL）、AnalyticDB（PostgreSQL）、Databend（1.2）、SelectDB（4.0.4）、Greenplum（6.x）、GBase 8a（V9）、GaussDB(DWS)（8.x）

两处例外：「工作簿」虽然在「文件」分组里，选它不会进入通用表单，而是跳到独立创建页；「DAP」要额外填 URL、Secret Key 和 Dialect，见下面「跨安全域接数据（DAP）」。

国产信创数据库

信创数据库是逐个原生适配的，不是套通用驱动凑合。连接的填法和通用数据库一致：填名称、主机、端口、用户名、密码，再填库名。

数据库卡片上的版本说明
达梦（DM8）DM8需要企业版；未授权时连接测试返回 403，错误码 ACCESSOR_ENTERPRISE_ONLY
GaussDB主备版集中式形态，在「数据库」分组
GaussDB(DWS)8.x数仓形态，在「大数据」分组
金仓 KingbaseESV8在「数据库」分组
GBase 8cV5在「数据库」分组
GBase 8aV9在「大数据」分组
虚谷V11 / V12在「数据库」分组
崖山 YashanDB23.2在「数据库」分组
TDSQLMySQL / PostgreSQL两张卡片，按实际形态选
MogDB5.0.0在「数据库」分组
OceanBase4.2.2在「数据库」分组
TiDB8.1.0在「数据库」分组

Oracle 是个例外：库名输入框的标题变成 Service Name，要填服务名而不是库名。

跨安全域接数据（DAP）

机房隔离、物理网闸、不允许给数据库开外网端口时，不必把数据库暴露出来：在数据库侧部署轻量代理，让 AskTable 连代理而不是直连数据库。

在「选择类型」的「数据库」分组里选「DAP」（Beta）。它的表单比通用表单短，只有四项：

字段填什么
数据源名称可留空，留空时自动生成
URLDAP 代理的地址
Secret Key代理的访问密钥
Dialect代理背后数据库的方言，默认 PostgreSQL；决定 SQL 按哪种语法生成

填完点「立即添加」，系统先自动测一次连接，通过后进入选表步骤，之后的流程和普通数据库完全一样。

关键约束

项目值或默认在哪里改
单次上传文件数最多 10 个，超出时上传被拒绝表单校验，不可调
Excel 单文件大小默认 10 MB，超出时该文件被拒绝头像菜单 → 「设置」→ 「文件上传」→ Excel 最大文件大小（MB）
CSV 单文件大小默认 20 MB，超出时该文件被拒绝头像菜单 → 「设置」→ 「文件上传」→ CSV 最大文件大小（MB）
CSV 列数默认 50，超出时该文件被拒绝头像菜单 → 「设置」→ 「文件上传」→ CSV 最大字段数
Excel Sheet 数默认 20头像菜单 → 「设置」→ 「文件上传」→ Excel 最大 Sheet 数
Excel 单 Sheet 字段数默认 200头像菜单 → 「设置」→ 「文件上传」→ Excel 最大字段数
单数据源可选表数默认 100 张；超出时选表页会提示已选数量超过上限，并禁用「确认选择」头像菜单 → 「设置」→ 「数据源」→ 单数据源最大表数（云端部署生效）
达梦（DM8）需要企业版；未授权时连接测试返回 403，错误码 ACCESSOR_ENTERPRISE_ONLY联系管理员升级企业版
多库分隔符只能用英文逗号；格式不对时提交被拒绝表单校验，不可调

以上数值都是默认值，可在管理后台调整（表单校验类的除外）。

出问题怎么判断

现象判定条件处理
连接测试没过弹出的连接失败对话框里是数据库返回的原始报错逐项核对主机、端口、账号、密码、库名；云端部署时确认已把提示里的服务器地址加进数据库白名单
达梦连不上提示需要企业版，或接口返回 403 / ACCESSOR_ENTERPRISE_ONLY升级企业版后再连
提交被表单拦下校验不通过，会指出是主机地址为空、端口号不是数字、端口号超过 65536、数据库名为空或 Service Name 为空按提示补齐对应字段
文件加不进去文件超出大小或列数限制，被拒绝压缩或拆分文件，再重新上传
「确认选择」点不动一张表都没勾；或勾选数超过 100 张上限减少勾选；确需更多表请管理员调高单数据源最大表数
选表页一张表都没有库表列表为空确认账号对目标库有读权限；Oracle 要填对 Service Name
搜不到某张表列表里没有匹配结果切换「表」/「视图」页签，清空搜索关键词
连接成功但详情页一直同步中顶栏状态指示器显示为同步中等元数据解析完成；长时间不动点状态指示器看错误详情

下一步