python cx_Oracle模組的安裝和使用

最近需要寫一個資料移轉指令碼，將單一Oracle中的資料移轉到MySQL Sharding叢集，在linux下安裝cx_Oracle感覺還是有一點麻煩的，整理一下，做個總結。

對於Oracle用戶端，不只需要安裝相應的python模組(這裡我用了Oracle官方的python模組——cx_Oracle)，還需要安裝Oracle Client，一般選擇Instant Client就足夠了，還需要配置tnsnames.ora(當然也可以簡單的通過host:port/schema訪問)。

安裝：

1. 首先確定版本。因為我們的Oracle資料是在是有點老，所以我選擇了一個比較老的版本——Oracle Instant Client 10.2.0.4。

2. 下載instantclient-basic。：http://www.oracle.com/technetwork/database/features/instant-client/index-097480.html。這裡要嚴重BS Oracle，居然要先註冊才能下載，這也算了，關鍵是註冊的時候，密碼居然要求有數字有字母，字母還要有大小寫，還必須至少8位。逼迫我搞了一個比我銀行密碼還要安全的密碼(好吧，現在我已經忘記我填了什麼了...)，下basic就可以了。

$wget http://download.oracle.com/otn/linux/instantclient/10204/basic-10.2.0.4.0-linux-x86_64.zip

3.安裝配置

$unzip instantclient-basic-linux.x64-10.2.0.4.0.zip$cd instantclient_10_2$cp * /usr/lib   #直接放到動態庫搜尋路徑中，不需要額外的環境配置或$unzip instantclient-basic-linux.x64-10.2.0.4.0.zip$cp -rf instantclient_10_2 /opt/$vi /etc/profile      export ORACLE_HOME=/opt/instantclient_10_2　　  export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$ORACLE_HOME$source /etc/profile

4.配置tnsnames.ora（可不用配置tns）

注意tnsnames.ora其實並不存在，是要自己建立的(這個也很噁心，我一開始以為還要安裝什麼東東。。)，我沒有使用這種方式，有興趣的可以google一下。

 

5.下載安裝cx_Oracle python模組

$wget http://downloads.sourceforge.net/project/cx-oracle/5.1.2/cx_Oracle-5.1.2-10g-py26-1.x86_64.rpm
$rpm -ivh cx_Oracle-5.1.2-10g-py26-1.x86_64.rpm 
$ls /usr/lib/python2.6/site-packages/cx_Oracle.so #有這個檔案表示安裝成功，根據python的位置，也可能在其他地方，自己找一下吧

6.驗證及問題解決

$python>>import cx_Oracle

若報錯：import cx_Oracle gave ImportError: libclntsh.so.10.1: cannot open shared object file: No such file or directory

表示沒有找到instant client的動態庫，check一下環境變數是否配置，是否生效，版本是否正確。

若報錯：ImportError: ./cx_Oracle.so: undefined symbol: PyUnicodeUCS4_Decode

Google的資訊：There is nothing wrong with Debian. Python supports two incompatible  modes of operation for Unicode, UCS2 (the default), and UCS4. Debian  uses the default, Redhat uses UCS4. You need to recompile the extension  for UCS-2 mode (i.e. using a Debian installation); this would fix the undefined symbol: PyUnicodeUCS4_Decode

所以重新編譯python

$./configure --prefix=/usr/local/python2.6.5 --enable-shared -enable-unicode=ucs4$make;make install

再次驗證，終於正常import了。

 

使用：

1.基本串連–使用Oracle tns alias

connection =cx_Oracle.connect("tp/tp@ocn_test")#查看tns alias命令cmd>tnsping ocn_testTNS Ping Utility forLinux: Version 9.2.0.8.0-Production on 27-SEP-201110:47:48Copyright (c) 1997, 2006, Oracle Corporation.  Allrights reserved.Used parameter files:/opt/……/sqlnet.oraUsed TNSNAMES adapter to resolve the aliasAttempting to contact (DESCRIPTION =(ADDRESS_LIST =(ADDRESS =(PROTOCOL =TCP)(HOST =10.20.36.19)(PORT =1520))) (CONNECT_DATA =(SID =ocntest)))OK (10msec)

2.使用者輸入密碼串連

pwd =getpass.getpass()connection =cx_Oracle.connect("tp",pwd,"ocn_test")

3.使用者直接在Python命令中輸入串連帳號資訊，格式如python script.py tp/tp@ocn_test

connection =cx_Oracle.connect(sys.argv[1])

4.使用Easy Connect文法，通過Drive串連資料庫

connection =cx_Oracle.connect('tp','tp','10.20.36.19:1521/ocntest')#orconnection =cx_Oracle.connect('tp/tp@10.20.36.19:1521/ocntest')

5.先使用DSN構成TNSNAME

tns_name =cx_Oracle.makedsn('10.20.36.19','1521',' ocntest ')connection =cx_Oracle.connect('tp','tp',tns_name)

6.登陸as SYSDBA

connection =cx_Oracle.connect('tp/tp@ocn_test', mode=cx_Oracle.SYSDBA)#or as SYSOPERconnection =cx_Oracle.connect('tp/tp@ocn_test', mode=cx_Oracle.SYSOPER)

 

在Linux伺服器執行Oracle操作時報了一個錯誤：

TNS:listener does not currently know of service requested in connect descriptor

解決方式：

問題分析見http://ora-12514.ora-code.com/，一番折騰，最後使用第5種串連方式，瞬間解決此問題。