Oracle Instant Client ODBC 安装说明

Oracle Instant Client ODBC 是一个独立软件包,安装简单,可提供 Oracle ODBC 驱动程序的全部功能(面向 Microsoft Transaction Server 的 Oracle 服务除外)。

ODBC 驱动程序支持 Oracle 标准客户端-服务器版本互操作,详情请参见支持文档 (ID 207303.1)。例如,Instant Client ODBC 19c 可连接至 Oracle Database 11.2 或更高版本。

安装 Oracle Instant Client Basic 和 Basic Lite

安装 Instant Client ODBC 前,请首先安装 Oracle Instant Client Basic 或 Basic Light 软件包(取决于您的语言环境要求)。您可以前往 OTN 下载适用于您操作系统的软件包,然后按照下载页面上的说明进行安装。例如,在 Windows 平台上,请将软件包解压至 C:\instantclient_19_3;在 Linux 或其他平台上,请将软件包解压至 /opt/oracle/instantclient_19_3。在 Linux 上,您还可以使用 yum 来安装 RPM 包。

有关 Oracle Instant Client 的更多信息,请参阅Oracle 调用接口程序员指南

安装 Oracle Instant Client ODBC

Linux 和 UNIX 平台

1. 如上所述,下载并安装 Instant Client Basic 或 Basic Light 软件包。

2. 下载 Instant Client ODBC 软件包,然后解压到与 Basic 或 Basic Light 软件包相同的目录下。如使用 RPM 软件包,请通过 yum 进行安装。

3. 如果尚未安装 unixODBC 驱动程序管理器,请安装。更多信息,请参见本文档中“推荐使用的 unixODBC 驱动程序管理器版本”部分。

4. 执行 Instant Client 目录下的 odbc_update_ini.sh

5. 根据您的语言环境设置 Oracle Globalization 变量。更多信息,请参阅 Oracle 数据库全球化支持指南。例如,在 Linux 平台上,您可以设置 export NLS_LANG=JAPANESE_JAPAN.JA16EUC 以采用 JA16EUC 日语字符。

用法: odbc_update_ini.sh <ODBCDM_Home> [<Install_Location> <Driver_Name> <DSN> <ODBCINI>]

参数 说明
ODBCDM_Home unixODBC 驱动程序管理器主目录路径
Install_Location* Oracle Instant Client 目录路径,默认路径为当前目录
Driver_Name* 驱动程序名称,用于标识当前 Oracle Instant Client 主目录中驻留的 Oracle ODBC 驱动程序。默认名称示例:"Oracle 19c ODBC driver"
DSN* 设置 ODBC DSN 名称,默认为 "OracleODBC-19c"
ODBCINI* .odbc.ini 文件的目录路径,默认为用户的主目录,例如 ~/.odbc.ini

* — 可选参数

Windows 平台

  1. 如上所述,安装 Instant Client Basic 或 Basic Light 软件包。
  2. 下载 Instant Client ODBC 软件包,然后解压到与 Basic 或 Basic Light 软件包相同的目录下。
  3. 执行 Instant Client 目录下的 odbc_install.exe。如果 Instant Client 是 11g 或更低版本,请使用管理员权限启动命令提示符。如需日语支持,请执行 odbc_install.exe JA 命令。

ODBC 应用的环境设置

ODBC 应用需加载 Oracle Instant Client ODBC 驱动程序的共享库文件(请参阅下一节)才能连接至 Oracle 数据库。在 Linux/Unix 平台上,请在 LD_LIBRARY_PATH 环境变量或者平台的等效变量中设置共享库的目录路径。此外还可以在 /etc/ld.so.conf 中配置该路径。在 Windows 平台上,请在 PATH 环境变量中设置目录路径。

请参阅《Oracle 调用接口程序员指南》的 OCI Instant Client 环境变量数据库连接字符串'主题,了解如何设置数据库连接字符串和相关环境变量,例如 TNS_ADMIN、TWO_TASK 和 LOCAL 等。

Oracle Instant Client ODBC 软件包内容

说明 Linux 和 UNIX 平台 Windows 平台
Oracle ODBC 驱动程序共享库 libsqora.so.XX.Y。例如 libsqora.so.19.1 sqora32.dll
安装文件 odbc_update_ini.sh odbc_install.exe、odbc_uninstall.exe
Oracle ODBC 驱动程序配置对话框窗口 (GUI) sqoras32.dll,sqresus.dll,sqresja.dll
帮助系统 help/ help/

修补 Oracle Instant Client ODBC

注意:修补之前,请先备份 Oracle ODBC 驱动程序共享库和其他文件。

在 Linux 和 UNIX 上 在 Linux/UNIX 上修补 Instant Client ODBC 驱动程序的方法如下:在已修补的 ORACLE_HOME 中生成 Instant Client ODBC 程序包和 Basic 或 Basic Light 程序包。请参阅 Oracle 调用接口程序员指南,了解修补和生成 Instant Client ODBC、Basic 和 Basic Light 软件包的步骤。随后,将新软件包解压到待修补的 Instant Client 目录中。这是建议使用的修补方法。

或者,您也可以从已修补的 ORACLE_HOME 中复制以下文件,来修补 Oracle Instant Client ODBC 驱动程序:

  • ODBC 驱动程序共享库文件:
    对于 19c: libsqora.so.19.1
    对于 18c: libsqora.so.18.1
    对于 12c: libsqora.so.12.1
    对于 11g: libsqora.so.11.1
  • 使用 Oracle Instant Client Basic 时需要的其他文件:
    对于 19c:libociei.so、libclntshcore.so.19.1、libclntsh.so.19.1、libnnz19.so、libons.so
    对于 18c:libociei.so、libclntshcore.so.18.1、libclntsh.so.18.1、libnnz18.so、libons.so
    对于 12c:libociei.so、libclntshcore.so.12.1、libclntsh.so.12.1、libnnz12.so、libons.so
    对于 11g:libclntsh.so.11.1、libociei.so、libnnz11.so
  • 使用 Oracle Instant Client Basic Light 时需要的其他文件:
    对于 19c:libclntsh.so.19.1、libclntshcore.so.19.1、libociicus.so、libnnz19.so、libons.so
    对于 18c:libclntsh.so.18.1、libclntshcore.so.18.1、libociicus.so、libnnz18.so、libons.so
    对于 12c:libclntsh.so.12.1、libclntshcore.so.12.1、libociicus.so、libnnz12.so、libons.so
    对于 11g:libclntsh.so.11.1、libociicus.so、libnnz11.so
 

Windows 平台: 从已修补的 ORACLE_HOME 或已解包的 Oracle Database Bundle 修补程序中手动复制 ODBC 驱动程序共享库文件和支持库文件,然后将这些文件复制到 Instant Client 目录中。请注意,生成 Instant Client ODBC 软件包这一方法在 Windows 平台上不可用。

请将以下文件复制到 Instant Client 目录中:

  • ODBC 驱动程序共享库文件:sqora32.dll、sqoras32.dll、sqresus.dll、sqresja.dll
  • 使用 Oracle Basic Instant Client 时需要的其他文件:
    对于 19c:oraociei19.dll、orannzsbb19.dll、oci.dll、oraons.dll、ociw32.dll、oraociei19.sym、orannzsbb19.sym、oci.sym、ociw32.sym
    对于 18c:oraociei18.dll、orannzsbb18.dll、oci.dll、oraons.dll、ociw32.dll、oraociei18.sym、orannzsbb18.sym、oci.sym、ociw32.sym
    对于 12c:oraociei12.dll、orannzsbb12.dll、oci.dll、oraons.dll、ociw32.dll、oraociei12.sym、orannzsbb12.sym、oci.sym、ociw32.sym
    对于 11g:oraociei11.dll、orannzsbb11.dll、oci.dll、ociw32.dll、oraociei11.sym、orannzsbb11.sym、oci.sym、ociw32.sym
  • 使用 Oracle Basic Light Instant Client 时需要的其他文件:
    对于 19c:oraociicus19.dll、orannzsbb19.dll、oci.dll、oraons.dll、ociw32.dll、oraociicus19.sym、orannzsbb19.sym、oci.sym、ociw32.sym
    对于 18c:oraociicus18.dll、orannzsbb18.dll、oci.dll、oraons.dll、ociw32.dll、oraociicus18.sym、orannzsbb18.sym、oci.sym、ociw32.sym
    对于 12c:oraociicus12.dll、orannzsbb12.dll、oci.dll、oraons.dll、ociw32.dll、oraociicus12.sym、orannzsbb12.sym、oci.sym、ociw32.sym
    对于 11g:oraociicus11.dll、orannzsbb11.dll、oci.dll、ociw32.dll、oraociicus11.sym、orannzsbb11.sym、oci.sym、ociw32.sym

注意:从 Oracle Database Bundle 修补程序复制时,以上某些文件可能不会被复制。这意味着该等文件未发生变更,无需修补。

卸载 Oracle ODBC Instant Client

Linux 和 UNIX 平台:

请按照以下步骤卸载 Instant Client ODBC:

  1. 从 unixODBC 驱动程序管理器的 odbcinst.ini 文件中删除 Oracle ODBC 驱动程序条目,默认名称示例:Oracle 19c ODBC driver。
  2. odbc.ini 文件中删除 Oracle ODBC 驱动程序的 DSN 条目,DSN 条目的默认名称是 [OracleODBC-19c]
  3. 删除 Instant Client ODBC 目录中的所有文件和目录。
 

Windows 平台:

请按照以下步骤卸载 Instant Client ODBC:

  1. 在 ODBC 数据源管理员 (odbcad32) 控制台中移除与 Oracle ODBC 驱动程序关联的 DSN。
  2. 从 Instant Client ODBC 目录执行 odbc_uninstall.exe
  3. 删除 Instant Client ODBC 目录中的所有文件和目录。

面向 Linux/UNIX 平台的 unixODBC 驱动程序管理器版本推荐:

Instant Client 18 和 19:

平台 unixODBC 驱动程序管理器版本
Linux 32 位 和 64 位 2.3.4
Solaris SPARC64 32 位和 64 位 2.3.4
Solaris 32 位和 64 位 2.3.4
AIX 5L 32 位和 64 位 2.3.4
HP IA64 32 位和 64 位 2.3.4
z/Linux 31 位和 64 位 2.3.4

Instant Client 12.1 和 12.2:

平台 unixODBC 驱动程序管理器版本
Linux 32 位 和 64 位 2.3.1
Solaris SPARC64 32 位和 64 位 2.3.1
Solaris 32 位和 64 位 2.3.1
AIX 5L 32 位和 64 位 2.3.1
HP IA64 32 位和 64 位 2.3.1
z/Linux 31 位和 64 位 2.3.1

Instant Client 11g:

平台 unixODBC 驱动程序管理器版本
Linux 32 位 和 64 位 2.2.11, 2.2.14
Solaris SPARC64 32 位和 64 位 2.2.11
Solaris 32 位和 64 位 2.2.11
AIX 5L 32 位和 64 位 2.2.11
HP IA64 32 位和 64 位 2.2.11
z/Linux 31 位和 64 位 2.2.11

Oracle ODBC 驱动程序资源

相关技术

注:为免疑义,本网页所用以下术语专指以下含义:

  1. 除Oracle隐私政策外,本网站中提及的“Oracle”专指Oracle境外公司而非甲骨文中国。
  2. 相关Cloud或云术语均指代Oracle境外公司提供的云技术或其解决方案。