连接 DataEase 并预览 SQL 数据集¶
先完成公共连接准备和数据集初始化。下述按版本记录的观察使用概览中标明的 MatrixOne 二进制。
创建 MySQL 数据源¶
被测版本为 DataEase 2.10.17,内置 MySQL Connector/J 8.2.0。
在数据源管理中新建 MySQL 数据源,选择主机和端口连接方式。
填写
MO_HOST、端口6001、数据库bi_tutorial,以及用户名和密码。本地隔离无 TLS 测试使用以下 JDBC 附加选项:
characterEncoding=UTF-8&connectTimeout=5000&useSSL=false&allowPublicKeyRetrieval=true&zeroDateTimeBehavior=convertToNull
远程连接请配置证书验证。allowPublicKeyRetrieval=true 允许认证公钥获取,仅应在适合的可信部署中使用,不能代替 TLS。zeroDateTimeBehavior=convertToNull 是驱动转换策略,不代表源数据日期合法。
验证并保存数据源,检查表列表。
新建 SQL 数据集,预览公共总计和分类查询。整体净额应为
410.000000,分类净额为130.000000和280.000000。将每日 SQL 另存为趋势数据集。构建图表前先核对总计;图表及仪表板需要继续验证,不在下述 API 验证范围内。
API 核对与限制¶
未修改的桌面模式服务通过实际 /de2api 路由验证:
操作 |
路由 |
配置要点 |
|---|---|---|
验证和保存数据源 |
|
|
发现表和视图 |
|
提交已保存的 |
预览 SQL |
|
提交 |
预览请求体示例:
{
"datasourceId": "SAVED_DATASOURCE_ID",
"sql": "BASE64_OF_THE_SQL_QUERY",
"isCross": false
}
上述路由相对于 /de2api。预览响应可能只返回完整结果的前缀。完整行数请用 JDBC 查询或单独验证的导出核对,预览一致不等于全量一致。
已验证保存数据源、发现表和 SQL 预览 API,内置 JDBC 路径也返回完整预期结果。未覆盖图表仪表板、跨数据源执行或浏览器渲染。另一个指向其他测试库的数据源虽然验证成功,但预览出现未查明的 invalid connection;通过主数据源执行带库名前缀的 SQL 可用。此观察尚未归因,不能认定为引擎缺陷或所有数据库均可用。桌面模式元数据库、缓存及 /opt 路径问题应作为部署问题单独排查。