DataHub项目解决Oracle数据库NNE加密连接问题

背景介绍

在数据集成领域，DataHub作为一个流行的元数据管理平台，经常需要与各类数据库系统建立连接。近期在DataHub项目中，用户反馈了一个与Oracle数据库连接相关的重要问题：当Oracle数据库启用了原生网络加密(Native Network Encryption，简称NNE)功能时，DataHub的元数据采集功能无法正常建立连接。

问题分析

Oracle数据库的NNE功能提供了传输层的数据加密，确保数据在网络传输过程中的安全性。然而，在DataHub的Oracle数据源连接实现中，默认使用的是python-oracledb的"瘦模式"(thin mode)，这种模式不支持NNE加密连接。

错误信息显示为"DPY-4011: the database or network closed the connection"，这是典型的当客户端尝试使用不支持的加密方式连接Oracle数据库时出现的错误。经过深入分析，发现需要启用python-oracledb的"厚模式"(thick mode)才能支持NNE加密连接。

技术解决方案

DataHub项目团队通过以下方式解决了这个问题：

1. 在Oracle数据源配置中新增了thick_mode参数，默认为False以保持向后兼容性
2. 当thick_mode设置为True时，要求提供Oracle客户端库路径lib_dir
3. 在建立连接前，先调用oracledb.init_oracle_client()初始化厚模式客户端

这种实现方式既解决了NNE加密连接问题，又保持了与旧版本的兼容性。用户只需在配置文件中简单设置即可启用厚模式：

source:
  type: oracle
  config:
    # 其他配置...
    thick_mode: true
    lib_dir: "/path/to/oracle/client"

实现细节

在技术实现层面，主要修改了Oracle数据源的连接逻辑：

1. 在配置模型中增加了厚模式相关参数
2. 在创建SQLAlchemy引擎前，检查是否需要初始化厚模式
3. 正确处理厚模式下的连接参数传递
4. 确保在SQLAlchemy 1.4版本下的兼容性

值得注意的是，虽然SQLAlchemy 2.0原生支持通过连接参数启用厚模式，但考虑到DataHub当前使用的是SQLAlchemy 1.4，所以采用了直接调用python-oracledb初始化函数的方式。

总结

DataHub项目通过这次改进，完善了对Oracle数据库NNE加密连接的支持，提升了平台与企业级数据库系统的兼容性。这一改进特别适合对数据安全要求较高的企业环境，使得DataHub能够在保证数据传输安全性的同时，顺利完成元数据采集任务。

对于需要使用这一功能的用户，建议在升级到包含此修复的版本后，按照文档正确配置厚模式参数，并确保Oracle客户端库的路径设置正确。这一改进体现了DataHub项目对用户反馈的快速响应和对企业级需求的重视。