使用AWS Glue Python Shell通过python-oracledb瘦模式更新本地Oracle表报错DPY-4027

核心问题根源 #

python-oracledb的thin模式不直接支持JDBC格式的URL。当你把JDBC URL传给oracledb.connect()时，库会默认将其识别为TNS别名，进而尝试查找tnsnames.ora配置文件，这就是触发DPY-4027错误的原因。其他作业能正常使用该URL，是因为它们依赖的是JDBC驱动（如Java作业），和python-oracledb的连接逻辑完全不同。

排查步骤 #

• 检查连接字符串格式：确认你传入connect()的参数是否为JDBC格式（例如jdbc:oracle:thin:@//host:port/service_name），如果是，必须转换为python-oracledb兼容的格式。
• 验证thin模式状态：确保代码中显式启用thin模式（oracledb.init_oracle_client(lib_dir=None)），或通过环境变量PYTHON_ORACLEDB_THIN=1强制启用，避免意外切换到依赖tnsnames.ora的厚模式。
• 清理Glue环境变量：在Glue作业配置中检查是否存在TNS_ADMIN变量，若有则移除，该变量会触发库去查找tnsnames.ora。

代码优化建议 #

正确的thin模式连接写法 #

方式1：拆解JDBC URL参数传入

import oracledb

# 从JDBC URL提取核心信息
db_host = "你的本地Oracle主机地址"
db_port = 1521  # 替换为实际端口
db_service = "你的Oracle服务名"
db_user = "数据库用户名"
db_password = "数据库密码"

# 强制启用thin模式
oracledb.init_oracle_client(lib_dir=None)

# 建立连接
conn = oracledb.connect(
    user=db_user,
    password=db_password,
    host=db_host,
    port=db_port,
    service_name=db_service
)

# 执行更新操作示例
with conn.cursor() as cursor:
    update_sql = "UPDATE 目标表 SET 字段名 = :1 WHERE 条件字段 = :2"
    # 使用绑定变量避免SQL注入，提升性能
    cursor.execute(update_sql, ("更新值", 目标ID))
    conn.commit()

conn.close()

方式2：转换为python-oracledb兼容的DSN字符串

将JDBC URL的jdbc:oracle:thin:@//前缀替换为@，直接作为DSN参数传入：

import oracledb

oracledb.init_oracle_client(lib_dir=None)

# 转换JDBC URL：jdbc:oracle:thin:@//host:port/service_name → //host:port/service_name
dsn = "//你的本地Oracle主机地址:1521/你的Oracle服务名"
conn = oracledb.connect(
    user="数据库用户名",
    password="数据库密码",
    dsn=dsn
)

# 后续更新逻辑同上

Glue作业配置优化 #

• 在作业参数中添加--additional-python-modules python-oracledb==1.4.0（指定稳定兼容版本，避免版本冲突）。
• 在环境变量中设置PYTHON_ORACLEDB_THIN=1，无需在代码中调用init_oracle_client即可强制启用thin模式。
• 移除所有与TNS_ADMIN相关的环境变量配置，防止触发tnsnames.ora查找逻辑。

内容的提问来源于stack exchange，提问作者Data girl