本文為您介紹如何在Windows和Linux/Unix系統上為PolarDB PostgreSQL版(相容Oracle)安裝、配置並使用ODBC驅動,以實現用戶端應用與資料庫的串連。
適用範圍
作業系統:
Windows:支援Windows7及以上版本,需Service Pack 1。
Linux/Unix:需安裝Libtool 1.5.10及以上版本和unixODBC-devel。
存取權限:
添加用戶端應用所在環境的IP地址至PolarDB叢集的白名單中。
下載驅動
系統版本 | 處理器架構 | ODBC驅動包 |
AliOS 8/ALinux 3/Anolis 8/CentOS 8 | X86_64 | |
ARM_64 | ||
AliOS 2/ALinux 2/Anolis 7/CentOS 7 | X86_64 | |
ARM_64 | ||
Unix/Linux 6 | X86_32 | |
Ubuntu 18 | X86_64 | |
Windows 7及以上 | X86_64 | |
X86_32 |
Windows系統使用ODBC驅動
安裝ODBC驅動
根據Windows作業系統的位元選擇對應的安裝包,下載地址請參見下載驅動。
右鍵安裝或使用管理員身份運行
polardb2_odbc_*_*.msi檔案,即可完成ODBC安裝。
使用ODBC串連PolarDB
在控制台中開啟管理工具。
在管理工具頁面,找到並運行ODBC資料來源。
在ODBC資料來源管理程式頁面,單擊添加。
選擇PolarDB Unicode(x64)作為資料來源的驅動程式,單擊完成。
在彈出的對話方塊中,輸入以下資訊。

參數
說明
Data Source
資料來源名稱。
Description
資料來源的描述。
Database
目標資料庫名稱。
SSL Mode
選擇SSL加密方式。
Server
目標資料庫連接地址,PolarDB叢集串連地址查看方式請參見查看或申請串連地址。
Port
目標資料庫的連接埠,預設為1521。
User Name
資料庫帳號。
Password
資料庫帳號的密碼。
單擊Test,如果串連串配置正確,則會提示串連成功。

單擊Save即可。
Unix或Linux系統使用ODBC驅動
此處以CentOS系統為例,其他動作系統,請根據實際情況調整相關命令。
安裝ODBC驅動
根據作業系統的架構和版本下載對應的ODBC驅動,下載地址請參見下載驅動。
安裝ODBC驅動。PolarDB提供的ODBC驅動壓縮包無需安裝,解壓後即可使用。解壓命令如下所示:
tar -zxvf polardb-odbc-*-*-*.tar.gz說明其中
polardb-odbc-*-*-*.tar.gz請替換為實際下載擷取的壓縮包名稱。執行以下命令,設定環境變數LD_LIBRARY_PATH的路徑指向。
export LD_LIBRARY_PATH=<PolarDB-ODBC/lib>:$LD_LIBRARY_PATH其中,<PolarDB-ODBC/lib/>路徑需替換為ODBC解壓目錄所在的實際路徑。
執行以下命令,設定環境變數ODBCINI的路徑指向。
export ODBCINI=</your odbc.init file path>
使用ODBC串連PolarDB
在Linux伺服器上安裝的Libtool,Libtool需要是1.5.1以上版本。
yum install -y libtool在Linux伺服器上安裝unixODBC-devel。
yum install -y unixODBC-devel編輯您配置的
odbc.ini檔案。vim $ODBCINI在
odbc.ini檔案中添加如下資訊。[POLARDB] Description = ODBC for POLARDB Driver = <PolarDB-ODBC/lib/psqlodbcw.so> Driver64 = <PolarDB-ODBC/lib/psqlodbcw.so> Database = <資料庫名稱> Servername = <資料庫連接地址> Password = <密碼> Port = <連接埠> Username = <使用者名稱> Trace = yes TraceFile = /tmp/odbc.log FileUsage = 1說明PolarDB叢集串連地址查看方式請參見查看或申請串連地址。
樣本中PolarDB-ODBC/lib/路徑需替換為ODBC解壓目錄所在的實際路徑。
串連PolarDB。
$isql -v POLARDB +---------------------------------------+ | Connected! | | | | sql-statement | | help [tablename] | | quit | | | +---------------------------------------+ SQL>
常見問題
更新日誌
13.02.0000.1(2025-02-10)
類型相容
DATE類型相容Oracle行為,支援包含時、分、秒資訊。INTERVAL類型相容Oracle行為,禁止直接查詢INTERVAL列,需先將其轉換為字串再進行查詢。
API適配
PGAPI_Columns等API已適配ROWID和DTS,不再展示相關的系統列和系統索引。PGAPI_Columns等API現已支援將SQL關鍵字作為列名的情境。