Apache Zeppelin JDBC 笔记本¶
先完成公共连接准备和数据集初始化。下述按版本记录的观察使用概览中标明的 MatrixOne 二进制。
配置解释器¶
安装 Apache Zeppelin,被测版本为 0.12.0,MySQL Connector/J 为 8.4.0。
在 JDBC 解释器依赖设置中安装
com.mysql:mysql-connector-j:8.4.0,或按上游说明将驱动 JAR 加入 JDBC 解释器类路径。依赖变更后重启解释器。配置以下 JDBC 解释器属性:
default.driver = com.mysql.cj.jdbc.Driver
default.url = jdbc:mysql://MO_HOST:6001/bi_tutorial?useSSL=false&connectionCollation=utf8mb4_general_ci&serverTimezone=UTC
default.user = MO_USER
default.password = REPLACE_WITH_PASSWORD
common.max_count = 100000
zeppelin.jdbc.maxRows = 100000
此 URL 复现本地无 TLS 测试。远程连接请选择验证 CA 和主机名的 Connector/J SSL 选项。serverTimezone=UTC 是驱动设置,也需确认业务报表时区。
重测将解释器结果限制调至 100,000 行,并将服务端
zeppelin.interpreter.output.limit设为 10,485,760 字节。请按工作负载设置,不能由这些上限推断所有结果完整。重启相应服务或解释器并核对有效配置。新建绑定 JDBC 解释器的笔记本,执行一段以
%jdbc开头、内容为SELECT 1;的段落。
保存分析¶
创建并保存以下段落:
%jdbc
SELECT category, COUNT(*) AS paid_orders,
COUNT(DISTINCT customer_id) AS buyers,
SUM(net_amount) AS net_amount, SUM(quantity) AS units
FROM bi_tutorial.order_metrics
GROUP BY category ORDER BY category;
核对 A=130.000000、B=280.000000。另建公共每日趋势及累计净额 SQL 段落,保存并重新打开笔记本,再次执行。这样 SQL 和核对结果可以一起审阅。原始结果正确后可使用笔记本表格或图表控件;兼容性测试未覆盖浏览器图表渲染。
结果格式边界¶
已验证实际保存的笔记本段落与 JDBC 解释器执行。单元格含换行的边界用例破坏了以制表符和换行分隔的原始 TABLE 消息,但 JDBC 数值正确。包含制表符或换行的数据应采用适当转义或导出方式,此格式差异不应归为 MatrixOne 查询结果错误。
把笔记本结果当成完整数据集前,检查行数及字节输出限制。JDBC URL 选项不能解决笔记本截断或格式问题。