连接 DataEase 并预览 SQL 数据集

先完成公共连接准备和数据集初始化。下述按版本记录的观察使用概览中标明的 MatrixOne 二进制。

创建 MySQL 数据源

被测版本为 DataEase 2.10.17,内置 MySQL Connector/J 8.2.0。

  1. 在数据源管理中新建 MySQL 数据源,选择主机和端口连接方式。

  2. 填写 MO_HOST、端口 6001、数据库 bi_tutorial,以及用户名和密码。

  3. 本地隔离无 TLS 测试使用以下 JDBC 附加选项:

characterEncoding=UTF-8&connectTimeout=5000&useSSL=false&allowPublicKeyRetrieval=true&zeroDateTimeBehavior=convertToNull

远程连接请配置证书验证。allowPublicKeyRetrieval=true 允许认证公钥获取,仅应在适合的可信部署中使用,不能代替 TLS。zeroDateTimeBehavior=convertToNull 是驱动转换策略,不代表源数据日期合法。

  1. 验证并保存数据源,检查表列表。

  2. 新建 SQL 数据集,预览公共总计和分类查询。整体净额应为 410.000000,分类净额为 130.000000 和 280.000000。

  3. 将每日 SQL 另存为趋势数据集。构建图表前先核对总计;图表及仪表板需要继续验证,不在下述 API 验证范围内。

API 核对与限制

未修改的桌面模式服务通过实际 /de2api 路由验证:

操作

路由

配置要点

验证和保存数据源

/datasource/validate、/datasource/save

configuration 是 base64 编码的 JSON

发现表和视图

/datasource/getTables

提交已保存的 datasourceId

预览 SQL

/datasetData/previewSql

提交 datasourceId、base64 SQL 和 isCross: false

预览请求体示例:

{
  "datasourceId": "SAVED_DATASOURCE_ID",
  "sql": "BASE64_OF_THE_SQL_QUERY",
  "isCross": false
}

上述路由相对于 /de2api。预览响应可能只返回完整结果的前缀。完整行数请用 JDBC 查询或单独验证的导出核对,预览一致不等于全量一致。

已验证保存数据源、发现表和 SQL 预览 API,内置 JDBC 路径也返回完整预期结果。未覆盖图表仪表板、跨数据源执行或浏览器渲染。另一个指向其他测试库的数据源虽然验证成功,但预览出现未查明的 invalid connection;通过主数据源执行带库名前缀的 SQL 可用。此观察尚未归因,不能认定为引擎缺陷或所有数据库均可用。桌面模式元数据库、缓存及 /opt 路径问题应作为部署问题单独排查。