求助：基于环境变量的Python连接Oracle数据库脚本开发

前置准备 #

• 先在系统环境变量中配置以下Oracle连接凭据（避免明文硬编码）：
  • ORACLE_USER: 数据库用户名
  • ORACLE_PASSWORD: 数据库密码
  • ORACLE_DSN: 数据库连接串，格式为主机地址:端口号/服务名（例如127.0.0.1:1521/ORCL）
• 安装依赖库：

  pip install cx_Oracle pandas openpyxl
  

  （openpyxl是pandas导出xlsx格式必需的依赖）

修正后的完整脚本 #

import os
import pandas as pd
import cx_Oracle

# 从环境变量读取数据库凭据
db_user = os.environ.get("ORACLE_USER")
db_pwd = os.environ.get("ORACLE_PASSWORD")
db_dsn = os.environ.get("ORACLE_DSN")

# 建立数据库连接
conn = cx_Oracle.connect(user=db_user, password=db_pwd, dsn=db_dsn)

# 执行查询并直接转为DataFrame
query = "SELECT * FROM example_db"
df_ora = pd.read_sql(query, conn)

# 指定导出路径（这里示例为用户桌面，可自行修改）
export_path = os.path.join(os.environ["USERPROFILE"], "Desktop", "查询结果.xlsx")

# 导出为xlsx格式文件
df_ora.to_excel(export_path, index=False, engine="openpyxl")

# 关闭数据库连接
conn.close()

print(f"文件已成功导出至：{export_path}")

关键问题修正与解释 #

1. 数据库连接部分
   • cx_Oracle.connect()需要传入用户名、密码、DSN三个参数，通过os.environ.get()读取环境变量，避免明文暴露凭据。用get()而非直接索引os.environ[]，能避免环境变量未配置时直接抛出异常。
2. 查询结果处理
   • pd.read_sql()执行查询后会直接返回DataFrame，不需要再用pd.DataFrame()重复转换，原脚本中的sql_query属于未定义的冗余错误代码。
3. Excel导出部分
   • 替换to_csv()为to_excel()以生成xlsx文件；用os.path.join()拼接路径，避免系统路径分隔符差异导致的错误；index=False表示不导出DataFrame的索引列，更符合报表需求；engine="openpyxl"指定xlsx导出引擎。
4. 资源释放
   • 数据库连接使用完毕后调用conn.close()释放资源，避免连接泄漏。

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