安裝或使用cx_Oracle時,須要用到Oracel的連接庫,如libclntsh.so.10.1,不然會有各類各樣的錯誤信息。html
安裝Oracle Instant Client就可獲得這個連接庫,避免安裝幾百兆之巨的Oracle Client。node
軟件下載地址:python
cx_Oracle的主頁:http://cx-oracle.sourceforge.net/linux
必需的Oracle連接庫的下載地址:http://www.oracle.com/technology/software/tech/oci/instantclient/index.htmlshell
常見的錯誤和解決方法:vim
一.win32二進制安裝windows
在windows下安裝cx_Oracle-5.0-10g.win32-py2.6.msi以後,導入時,報DLL加載失敗的錯誤,以下:bash
IDLE 2.6.1
>>> import cx_Oraclesession
Traceback (most recent call last):
File "<pyshell#0>", line 1, in <module>
import cx_Oracle
ImportError: DLL load failed: 找不到指定的程序。oracle
解決方法:
從Oracle站點下載instantclient-basic-win32-10.2.0.4.zip,解壓後,將其中的oci.dll文件複製到python安裝目錄的Lib/site-packages下,如 C:/Python26/Lib/site-packages
二.linux下二進制安裝
在linux_x86_64下,安裝cx_Oracle-5.0.1-10g-py24-1.x86_64.rpm時報錯。
[root@BJ-UPDATE-01 ~]# rpm -ivh cx_Oracle-5.0.1-10g-py24-1.x86_64.rpm
error: Failed dependencies:
libclntsh.so.10.1()(64bit) is needed by cx_Oracle-5.0.1-1.x86_64
解決方法:
參考http://cx-oracle.sourceforge.net/BUILD.txt
從Oracle站點下載basic-10.2.0.4.0-linux-x86_64.zip到/opt目錄並解壓,會看到libclntsh.so.10.1在/opt/instantclient_10_2目錄中
設置環境變量
vi /root/.bash_profile
增長以下兩行:
export ORACLE_HOME=/opt/instantclient_10_2
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$ORACLE_HOME
運行source /root/.bash_profile使改動生效
創建此連接庫的符號連接
cd $ORACLE_HOME
ln -s libclntsh.so.x.x libclntsh.so
從新安裝cx_Oracle
注意加--nodeps參數,不然還會報上述錯誤
[root@BJ-UPDATE-01 ~]# rpm -ivh --nodeps cx_Oracle-5.0.1-10g-py24-1.x86_64.rpm
#5.0.3版本不用加--nodeps參數
三.linux下源代碼安裝
設置環境變量及符號連接如上,在linux_x86_64下源代碼安裝,運行python setup.py build,編譯時錯誤信息以下:
Connection.c:1169: 警告:語句不起做用
Connection.c:1171: 錯誤:‘udt_Connection’ 沒有名爲 ‘environment’ 的成員
Connection.c:1172: 警告:傳遞參數 1 (屬於 ‘Environment_CheckForError’)時在不兼容的指針類型間轉換
Connection.c:1172: 警告:傳遞參數 2 (屬於 ‘Environment_CheckForError’)時在不兼容的指針類型間轉換
Connection.c:1172: 錯誤:提供給函數 ‘Environment_CheckForError’ 的實參太多
Connection.c:1176: 錯誤:‘udt_Connection’ 沒有名爲 ‘sessionHandle’ 的成員
解決方法:
5.0.3版本的未出現此錯誤,要注意ORACLE_HOME下要有include目錄,這個目錄中要有編譯須要的源文件,源文件在Oracle Instant Client這個客戶端中沒有包含。我是從windows客戶端的D:/oracle/product/10.2.0/client_1/oci/include這個目錄中拷貝的。
四.import錯誤
>>> import cx_Oracle
Traceback (most recent call last):
File "<stdin>", line 1, in ?
ImportError: /usr/lib/oracle/10.2.0.4/client64//lib/libnnz10.so: cannot restore segment prot after reloc: Permission denied
>>> import cx_Oracle
Traceback (most recent call last):
File "<stdin>", line 1, in ?
ImportError: /usr/lib/oracle/10.2.0.4/client64//lib/libclntsh.so.10.1: cannot restore segment prot after reloc: Permission denied
>>> import cx_Oracle
>>>
這是由於SELinux的限制,運行以下命令取消限制:
chcon -t texrel_shlib_t cd $ORACLE_HOME/libnnz10.so
chcon -t texrel_shlib_t cd $ORACLE_HOME/libclntsh.so.10.1
5、運行時錯誤
Traceback (most recent call last):
File "oracle_conn.py", line 9, in ?
connection = cx_Oracle.Connection(u"oracle/oracle123@CCIP")
cx_Oracle.InterfaceError: Unable to acquire Oracle environment handle
仍是SELinux的限制,設置SELinux爲disabled
關掉selinux:
運行命令: vim /etc/selinux/config
將selinux=enforcing或permissive改爲disabled
運行命令: setenforce 0
六. UNICODE的安裝包有問題
Traceback (most recent call last):
File "./oracle_conn.py", line 22, in ?
folderIds=cursor.fetchmany(10)
cx_Oracle.DatabaseError: OCI-22061: Message 22061 not found; No message file for product=RDBMS, facility=OCI; arguments: [T
目前發現5.0.3版的包在執行SQL時會致使報錯,不建議使用,換成非UNICODE的包就沒問題了。