当前位置：首页 > news >正文

cx_Oracle.DatabaseError: DPI-1047: 64-bit Oracle Client library cannot be loaded: 解决方案

news 来源：原创 2024/5/7 19:39:06

2019独角兽企业重金招聘Python工程师标准>>>

ODPI-C安装

要在您自己的项目中使用ODPI-C，请从GitHub下载其源代码。如果您希望将ODPI-C构建为共享库，则会提供示例Makefile。否则，将ODPI-C源代码添加到项目中。在Windows上，需要Visual Studio 2008或更高版本。在macOS上，需要Xcode 6或更高版本。在Linux上，需要GCC 4.4或更高版本。

使用ODPI-C的项目需要安装Oracle客户端库。这些库提供必要的网络连接，允许应用程序访问Oracle数据库实例。它们还为ODPI-C应用程序提供基本和高级连接管理和数据功能。

最简单的Oracle客户端是免费的Oracle Instant Client。只需要“基本”或“基本灯”包。任何Oracle数据库安装或完整Oracle客户端安装中也提供Oracle客户端库。

ODPI-C在运行时显式加载可用的Oracle客户端库。这允许使用ODPI-C的代码只构建一次，然后使用可用的Oracle Client 18,12或11.2库运行。如果未找到Oracle客户端库，则会引发错误“DPI-1047：无法加载Oracle客户端库”。

在Windows上，首先在ODPI-C库（或应用程序二进制文件）所在的同一目录中查找Oracle客户端库。如果找不到它们，则Oracle客户端库目录应包含在PATH环境变量中。

在非Windows平台上，如果没有Oracle客户端位于标准操作系统搜索路径（例如$LD_LIBRARY_PATH）中，则 $ORACLE_HOME搜索。

以下各节说明如何确保在各种平台上正确安装和配置Oracle客户端，以便ODPI-C能够找到它。

ODPI-C已经在Linux，Windows和macOS上进行了测试。其他平台也应该有效，但尚未经过测试。

Oracle客户端和Oracle数据库互操作性¶

ODPI-C可以使用Oracle Client 18,12或11.2库。

Oracle的标准客户端 - 服务器网络互操作性允许不同版本的Oracle客户端和Oracle数据库之间的连接。有关认证配置，请参阅Oracle Support的Doc ID 207303.1。总之，Oracle Client 18和12.2可以连接到Oracle Database 11.2或更高版本。Oracle Client 12.1可以连接到Oracle Database 10.2或更高版本。Oracle Client 11.2可以连接到Oracle Database 9.2或更高版本。创建连接的技术限制可能更灵活。例如，Oracle Client 12.2可以成功连接到Oracle Database 10.2。

由于单个ODPI-C二进制文件可以使用多个客户端版本并访问多个数据库版本，因此在您的预期发布环境中测试应用程序非常重要。较新的Oracle客户端支持新功能，例如12.1或更高版本客户端可用的oraaccess.xml外部配置文件，会话池改进，18或更高版本客户端的呼叫超时以及其他增强功能。

该函数dpiContext_getClientVersion()可用于确定正在使用的Oracle客户端版本，该函数 dpiConn_getServerVersion()可用于确定连接正在访问哪个Oracle数据库版本。然后可以使用它们来相应地调整应用程序行为。尝试使用特定客户端/服务器组合不支持的某些Oracle功能可能会导致运行时错误。这些包括：

尝试访问当前Oracle客户端库不支持的属性时，您将收到错误“ORA-24315：非法属性类型”
尝试对Oracle Database 12c使用Oracle Client 11.2的隐式结果时，您将收到错误“ORA-29481：无法将隐式结果返回给客户端”
尝试使用Oracle Client 11.2获取阵列DML行计数时，您将收到错误“DPI-1050：Oracle客户端库必须为12.1或更高版本”

Linux的¶

ODPI-C需要Oracle客户端库，可以在Oracle Instant Client或Oracle数据库安装中找到，也可以在完整的Oracle客户端安装中找到。这些库必须是32位或64位，与您的应用程序和ODPI-C库（如果单独创建）匹配。

在Linux上，ODPI-C首先使用标准库搜索顺序搜索名为“libclntsh.so”的库。如果找不到，则会搜索“libclntsh.so.18.1”，“libclntsh.so.12.1”，然后搜索“libclntsh.so.11.1”。如果找不到库，则$ORACLE_HOME/lib/libclntsh.so检查。如果没有找到库，则返回错误。

Oracle Instant ClientZip¶

使用Oracle Instant Client zip文件运行ODPI-C应用程序：

下载Oracle 18,12或11.2“Basic”或“Basic Light”zip文件：64位或32位，与您的应用程序架构相匹配。

将程序包解压缩到应用程序可访问的单个目录中。例如：

mkdir -p /opt/oracle
cd /opt/oracle
unzip instantclient-basic-linux.x64-12.2.0.1.0.zip

libaio使用sudo或root用户安装软件包。例如：
```
sudo yum install libaio
```
在某些Linux发行版上，会调用此包libaio1。
如果计算机上没有其他Oracle软件会受到影响，请将Instant Client永久添加到运行时链接路径。例如，使用sudo或root用户：
```
sudo sh -c "echo /opt/oracle/instantclient_12_2 > /etc/ld.so.conf.d/oracle-instantclient.conf"
sudo ldconfig
```
或者，将环境变量设置LD_LIBRARY_PATH为Instant Client版本的相应目录。例如：
```
export LD_LIBRARY_PATH=/opt/oracle/instantclient_12_2:$LD_LIBRARY_PATH
```
如果您打算同定位可选的Oracle配置文件，如tnsnames.ora，sqlnet.ora或oraaccess.xml与即时客户端，然后创建一个network/admin子目录，如果它不存在。例如：
```
mkdir -p /opt/oracle/instantclient_12_2/network/admin
```
这是与此Instant Client链接的应用程序的默认Oracle配置目录。

或者，Oracle配置文件可以放在另一个可访问的目录中。然后将环境变量 TNS_ADMIN设置为该目录名称。

Oracle Instant ClientRPM¶

使用Oracle Instant Client RPM运行ODPI-C应用程序：

下载适用于您的应用程序架构的Oracle 18,12或11.2“Basic”或“Basic Light”RPM：64位或32位。
使用sudo或root用户安装下载的RPM。例如：
```
sudo yum install oracle-instantclient12.2-basic-12.2.0.1.0-1.x86_64.rpm
```
Yum会自动安装所需的依赖项，例如libaio。
如果计算机上没有其他Oracle软件会受到影响，请将Instant Client永久添加到运行时链接路径。例如，使用sudo或root用户：
```
sudo sh -c "echo /usr/lib/oracle/12.2/client64/lib > /etc/ld.so.conf.d/oracle-instantclient.conf"
sudo ldconfig
```
或者，将环境变量设置LD_LIBRARY_PATH为Instant Client版本的相应目录。例如：
```
export LD_LIBRARY_PATH=/usr/lib/oracle/12.2/client64/lib:$LD_LIBRARY_PATH
```
如果您打算共同定位可选的Oracle配置文件，例如tnsnames.ora，sqlnet.ora或oraaccess.xml使用Instant Client，则network/admin在lib/其下创建一个子目录（如果它不存在）。例如：
```
sudo mkdir -p /usr/lib/oracle/12.2/client64/lib/network/admin
```
这是与此Instant Client链接的应用程序的默认Oracle配置目录。

或者，Oracle配置文件可以放在另一个可访问的目录中。然后将环境变量 TNS_ADMIN设置为该目录名称。

本地数据库或完整Oracle客户端¶

ODPI-C应用程序可以使用本地Oracle数据库或完整Oracle客户端安装中的Oracle Client 18,12或11.2库。

这些库必须是32位或64位，与您的应用程序和ODPI-C库（如果单独创建）匹配。

通过运行Oracle环境脚本来设置所需的Oracle环境变量。例如：
```
source /usr/local/bin/oraenv
```
对于Oracle Database XE 11.2，运行：
```
source /u01/app/oracle/product/11.2.0/xe/bin/oracle_env.sh
```
可选的Oracle配置文件，例如tnsnames.ora， sqlnet.ora或者oraaccess.xml可以放在其中 $ORACLE_HOME/network/admin。

或者，Oracle配置文件可以放在另一个可访问的目录中。然后将环境变量 TNS_ADMIN设置为该目录名称。

窗口¶

在Windows上，ODPI-C首先在包含ODPI-C库（或应用程序）的目录中查找Oracle客户端库“OCI.dll”，然后使用标准库搜索顺序进行搜索。

Oracle客户端库需要存在正确的Visual Studio可再发行组件。

Oracle 18和12.2需要VS 2013
Oracle 12.1需要VS 2010
Oracle 11.2需要VS 2005 64位或VS 2005 32位

Oracle Instant ClientZip¶

使用Oracle Instant Client zip文件运行ODPI-C应用程序：

下载Oracle 18,12或11.2“Basic”或“Basic Light”zip文件：64位或32位，与您的应用程序架构相匹配。
例如，将程序包解压缩到应用程序可访问的单个目录中C:\oracle\instantclient_12_2。
设置环境变量PATH以包括您在步骤2中创建的路径。例如，在Windows 7上，PATH在控制面板 - >系统 - >高级系统设置 - >高级 - >环境变量 - >系统变量 - >路径中更新。
如果您打算共同定位可选的Oracle配置文件，例如tnsnames.ora，sqlnet.ora或oraaccess.xml与Instant Client，则创建network\admin子目录（如果它不存在），例如 C:\oracle\instantclient_12_2\network\admin。

这是与此Instant Client链接的应用程序的默认Oracle配置目录。

或者，Oracle配置文件可以放在另一个可访问的目录中。然后将环境变量 TNS_ADMIN设置为该目录名称。

如果要将Instant Client与应用程序打包在一起，可以将Instant Client库移动到与ODPI-C库（或应用程序）相同的目录中。有关所需的最小Instant Client文件集，请参阅Instant Client文档。没有必要设置PATH。这仅适用于Windows。

本地数据库或完整Oracle客户端¶

Oracle库必须是32位或64位，与您的应用程序和ODPI-C库（如果单独创建）匹配。

要使用本地Oracle数据库（或完整Oracle客户端）18,12或11.2安装中的客户端库来运行ODPI-C应用程序：

设置环境变量PATH以包含包含OCI.dll的路径（如果尚未设置）。例如，在Windows 7上， PATH在控制面板 - >系统 - >高级系统设置 - >高级 - >环境变量 - >系统变量 - >路径中更新。
可选的Oracle配置文件，例如tnsnames.ora， sqlnet.ora或者oraaccess.xml可以放在network/adminOracle软件的子目录中。

或者，Oracle配置文件可以放在另一个可访问的目录中。然后将环境变量 TNS_ADMIN设置为该目录名称。