2025年最新 Oracle 客户端下载与使用教程 – wiki基地

作者： /

这是一篇关于 2025 年最新 Oracle 客户端下载、安装及配置的详细教程。

2025 年最新 Oracle 客户端下载与使用教程

随着 2025 年 Oracle 推出了最新的 Oracle Database 26ai (及持续更新的 23ai/19c 长期支持版)，客户端的连接方式变得更加智能化和轻量化。无论你是开发人员、DBA 还是数据分析师，正确安装和配置 Oracle 客户端是连接数据库的第一步。

本教程将详细介绍 Oracle Instant Client（即时客户端） 和 Full Client（完整客户端） 的下载、安装、环境变量配置及常见问题解决。

1. 客户端版本的选择

在下载之前，请根据你的需求选择合适的版本：

  • Oracle Instant Client (推荐)：

    • 特点：轻量级（约 100MB+），无需运行安装程序，解压即用。
    • 适用场景：Java/Python/Node.js 开发、Navicat/DBeaver/PLSQL Developer 连接、轻量级 SQL*Plus 操作。
    • 版本：推荐使用 26ai 或 23ai (均向下兼容 19c 等旧版数据库)。

  • Oracle Full Client (完整版)：

    • 特点：体积庞大（数 GB），包含完整的管理工具（如 OUI, Net Configuration Assistant 等）。
    • 适用场景：需要在本地进行复杂的数据库管理、通过 GUI 配置网络服务的管理员。

2. 下载步骤

2.1 访问官方下载页

请务必通过 Oracle 官方渠道下载，以确保安全和稳定性。

2.2 选择操作系统与架构

  • Windows 用户：
    • 绝大多数情况请选择 Windows x64 (64-bit)。
    • 注意：如果你使用的第三方工具（如旧版 PL/SQL Developer 32位版）是 32 位的，则必须下载 32-bit 的 Oracle Client，否则会报错。
  • Linux/macOS 用户：选择对应的系统架构（x86-64 或 ARM64）。

2.3 下载文件 (以 Instant Client 为例)

在下载页面中，你通常需要下载以下两个包（Basic 包是必须的）：
1. Basic Package (instantclient-basic-windows.x64-26.x.x.x.x.zip)：包含运行 OCI、OCCI 和 JDBC-OCI 应用程序所需的所有文件。
2. SQL*Plus Package (instantclient-sqlplus-windows.x64-26.x.x.x.x.zip)：包含 SQL*Plus 命令行工具（可选，但强烈建议下载用于测试连接）。

提示：下载通常需要登录 Oracle 账号。如果没有，需免费注册一个。

3. 安装与配置 (Windows 环境)

由于 Instant Client 最为常用，以下重点介绍其配置方法。

3.1 解压文件

  1. 创建一个目录，例如 C:\Oracle\instantclient_26_1。
  2. 将下载的 Basic 压缩包解压到该目录。
  3. 将下载的 SQL*Plus 压缩包也解压到同一个目录（合并文件夹）。

3.2 配置环境变量

为了让系统识别 Oracle 客户端，需要设置环境变量。

  1. 打开环境变量设置：右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
  2. 设置 PATH：
    • 在“系统变量”中找到 Path，点击“编辑”。
    • 新建一条，填入你的解压路径：C:\Oracle\instantclient_26_1。
  3. 设置 TNS_ADMIN (关键)：
    • 新建一个系统变量，变量名：TNS_ADMIN。
    • 变量值：指向你存放 tnsnames.ora 配置文件的文件夹路径（建议就在客户端目录下建立一个 network\admin 子目录，例如 C:\Oracle\instantclient_26_1\network\admin）。
  4. 设置 NLS_LANG (解决乱码)：
    • 新建系统变量 NLS_LANG。
    • 常用值：SIMPLIFIED CHINESE_CHINA.AL32UTF8 (如果要支持中文且避免乱码，需与数据库字符集保持一致)。

3.3 配置 tnsnames.ora

在 TNS_ADMIN 指定的目录下，创建文本文件 tnsnames.ora，填入数据库连接信息：

“`ini

示例配置

MY_DB_ALIAS =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.1.100)(PORT = 1521))
(CONNECT_DATA =
(SERVER = DEDICATED)
(SERVICE_NAME = orclpdb1)
)
)
“`
* HOST: 数据库服务器 IP。
* PORT: 端口（默认 1521）。
* SERVICE_NAME: 数据库服务名（注意不是 SID，Oracle 12c+ 推荐使用服务名）。

4. 验证连接

4.1 命令行测试

打开 CMD 或 PowerShell，输入：
bash
sqlplus -v
如果显示版本号（如 SQL*Plus: Release 26.0.0.0.0），说明环境变量配置成功。

尝试连接数据库：
“`bash
sqlplus 用户名/密码@MY_DB_ALIAS

或者直接指定 IP

sqlplus 用户名/密码@//192.168.1.100:1521/orclpdb1
“`

4.2 第三方工具配置 (以 PL/SQL Developer 为例)

  1. 打开 PL/SQL Developer，不登录直接点击“取消”进入主界面。
  2. 点击 Configure -> Preferences。
  3. 找到 Oracle -> Connection。
  4. Oracle Home (Empty is autodetect): 填入解压路径 C:\Oracle\instantclient_26_1。
  5. OCI library (Empty is autodetect): 填入 C:\Oracle\instantclient_26_1\oci.dll。
  6. 重启软件，即可在登录界面的 Database 下拉框中看到 tnsnames.ora 中配置的别名。

5. 常见问题排查 (Troubleshooting)

  1. 报错 ORA-12154: TNS:could not resolve the connect identifier specified

    • 检查 TNS_ADMIN 环境变量是否正确指向了包含 tnsnames.ora 的文件夹。
    • 检查 tnsnames.ora 文件名是否有后缀（如 .txt 隐藏后缀）。
    • 检查连接别名拼写是否正确。

  2. 报错 System.Data.OracleClient requires Oracle client software version 8.1.7 or greater

    • 这是权限问题或目录未找到。确保 Oracle 目录有读取权限（右键文件夹 -> 属性 -> 安全 -> 添加 Authenticated Users 读取权限）。
    • 确保重启了电脑或重启了相关服务以加载新的环境变量。

  3. 报错 MSVCR140.dll 或 VCRUNTIME140.dll 丢失

    • Oracle Instant Client 依赖 Microsoft Visual C++ Redistributable。请去微软官网下载并安装 Visual C++ 2015-2022 Redistributable (x64)。

  4. PL/SQL Developer 无法加载 OCI.dll

    • 通常是因为架构不匹配。如果你的 PL/SQL Developer 是 32 位的（旧版常见），你必须下载 32-bit (x86) 的 Oracle Instant Client，即使你的 Windows 是 64 位的。建议升级使用 64 位版本的 PL/SQL Developer 15+。

通过以上步骤，你应该能够成功在 2025 年的环境下配置并使用 Oracle 客户端。如果是生产环境，建议定期关注 Oracle 官网的安全补丁更新。

滚动至顶部