配置 Datablau JDBC 客户端
客户端通过 Datablau JDBC Driver 连接安全网关,再由网关访问后端数据源。直连数据库不会自动经过此网关的访问策略。
连接参数
| 参数 | 设置 |
|---|---|
| JDBC URL | jdbc:datablau://[host]:[port] |
| Driver Class | com.datablau.jdbc.Driver |
| host | 实际网关部署地址 |
| port | 该代理数据源在网关中配置的服务端口 |
| 用户名、密码 | 按网关的 DAM 登录或虚拟账号模式提供 |
方括号表示需要替换的值,不应原样填入连接。使用管理员提供的驱动包,不将其他数据库原生驱动类名填成 Datablau 驱动类。
接入数据库工具
- 在 DBeaver 选择“数据库 → 驱动管理器”,新建自定义驱动定义。
- 添加 Datablau JDBC 驱动包,填写驱动类。
- 选择“数据库 → 新建数据库连接”,使用该驱动,设置网关 URL 和相应凭据。
- 测试连接,成功后查看目标数据库对象。
- 选择已知样本查询,按结果验证检查可见范围与脱敏效果。
如果工具使用驱动模板自动补充 URL,最终仍应核对实际生成的地址和端口。
连接参数应与 DAM 网关详情的“服务网关链接信息”和所选登录模式相符。连接后展开数据库、Schema、表和字段,选择已明确配置策略的字段测试;先确认正确连接,再检查脱敏,便于区分驱动问题与权限问题。
FineBI 接入准备
FineBI 接入除 JDBC 连接外,还涉及用户身份传递。由管理员按适配安装包部署 datablau-driver-jdbc-bridge.jar、配套线程上下文代理及 Datablau JDBC 插件,在实际启动配置中加入配套代理参数后启动服务,再建立 Datablau JDBC 数据源。
原集成方案通过桥接与线程上下文把当前 BI 用户传递到 JDBC。BI 登录名与 DAM 用户名一致时使用该 DAM 用户策略,两边密码可以不同;不一致时使用默认权限。因此必须检查实际登录用户对应的效果,不能只测试管理员连接成功。
安装目录、启动脚本和配套包应与部署方案一致,不复制其他环境的绝对路径。升级或调整插件后需要重新验证身份传递、连接和查询结果。
常见问题
| 现象 | 检查内容 |
|---|---|
| 找不到驱动类 | 驱动包是否加载、类名是否正确 |
| 连接被拒绝 | 网关启用状态、服务地址、端口和网络 |
| 认证失败 | 网关登录模式与凭据是否对应 |
| 看到的数据与预期权限不符 | 实际连接是否经过网关、实际访问身份和策略范围 |
| BI 用户结果相同 | 检查用户身份是否传递、用户名映射及默认权限 |
