Linux Qt 6安装Oracle QOCI SQL Driver插件(适用WSL)

本文参考 QOCI for the Oracle Call Interface (OCI)

除一般的 Linux 系统外,本文也适用于 WSL 2。

在开始之前,如果没有安装 QOCI 插件,则试图链接 Oracle 数据库时会报错:

Failed to create wl_display (No such file or directory)

qt.qpa.plugin: Could not load the Qt platform plugin "wayland" in "" even though it was found.

"QOCI driver not available."

qt.sql.qsqldatabase: QSqlDatabase: QOCI driver not loaded

qt.sql.qsqldatabase: QSqlDatabase: available drivers: QMIMER QPSQL QODBC QSQLITE QMARIADB QMYSQL

QSqlError("", "Driver not loaded", "Driver not loaded")

  1. 安装 CMake 等依赖。在 Oracle Instant Client Downloads for Linux x86-64 (64-bit),以 ZIP 安装为例,下载 Base - one of these packages is required - Basic Package (ZIP)、Tools - optional packages - SQL*Plus Package (ZIP)、Development and Runtime - optional packages - SDK Package (ZIP),展开网页内的Installation Instructions - Instant Client Installation for Linux x86-64 (64-bit) 教程操作,解压到/opt/oracle目录下(需要 sudo 权限)。其中,后两者均包含META-INFinstantclient_23_5两个目录,解压时合并目录,或使用cp -r命令合并目录。合并后目录结构如下:

BASIC_LICENSE legacy.so libclntsh.so.23.1 libocci.so libociei.so sqlplus

BASIC_README libclntsh.so libclntshcore.so libocci.so.10.1 libocijdbc23.so ucp.jar

SDK_LICENSE libclntsh.so.10.1 libclntshcore.so.12.1 libocci.so.11.1 libsqlplus.so ucp11.jar

SDK_README libclntsh.so.11.1 libclntshcore.so.18.1 libocci.so.12.1 libsqlplusic.so uidrvci

SQLPLUS_LICENSE libclntsh.so.12.1 libclntshcore.so.19.1 libocci.so.18.1 libtfojdbc1.so xstreams.jar

SQLPLUS_README libclntsh.so.18.1 libclntshcore.so.20.1 libocci.so.19.1 network

adrci libclntsh.so.19.1 libclntshcore.so.21.1 libocci.so.20.1 ojdbc11.jar

fips.so libclntsh.so.20.1 libclntshcore.so.22.1 libocci.so.21.1 ojdbc8.jar

genezi libclntsh.so.21.1 libclntshcore.so.23.1 libocci.so.22.1 pkcs11.so

glogin.sql libclntsh.so.22.1 libnnz.so libocci.so.23.1 sdk

保证目录内包含了sqlplussdk(sqlplus 可选,sdk 必需)。如果安装传统的 Oracle Client 21c 并使用 WSL,则需要 X11 依赖,如果采用的是 Qt Online Installer 安装的 Qt,则在安装程序阶段就已经安装过了相关依赖,故在此不作赘述。

  1. 如果以上操作完成后/opt/oracle/instantclient_23_5目录内已包含链接libclntsh.solibocci.so则不需依照教程重新链接(ln -s)一遍。将
bash 复制代码
export LD_LIBRARY_PATH=/opt/oracle/instantclient_19_3:$LD_LIBRARY_PATH
export PATH=/opt/oracle/instantclient_19_3:$PATH

添加到.bash_profile(如果用zsh可以直接添加到.zshrc)并source之。

  1. 执行
bash 复制代码
mkdir build-sqldrivers
cd build-sqldrivers
qt-cmake -G Ninja /opt/Qt/6.8.0/gcc_64/bin/qt-cmake -G Ninja /opt/Qt/6.8.0/Src/qtbase/src/plugins/sqldrivers -DCMAKE_INSTALL_PREFIX=/opt/Qt/6.8.0/gcc_64 -DOracle_ROOT=/opt/oracle/instantclient_23_5
cmake --build .
sudo cmake --install .

默认 CMake configuration 为"RelWithDebInfo"。
4. 重新 CMake、编译项目。如果存在其他问题,可执行

bash 复制代码
sudo chmod +x /opt/Qt/6.8.0/gcc_64/plugins/sqldrivers/libqsqlite.so
/opt/Qt/6.8.0/gcc_64/plugins/sqldrivers/libqsqloci.so

至此 QOCI 插件成功安装。
注意:如果 Qt 版本小于 6.8.0,则第三步第三行命令应改为:

bash 复制代码
/opt/Qt/6.8.0/gcc_64/bin/qt-cmake -G Ninja /opt/Qt/6.8.0/Src/qtbase/src/plugins/sqldrivers -DCMAKE_INSTALL_PREFIX=/opt/Qt/6.8.0/gcc_64 -DOracle_INCLUDE_DIR=/opt/oracle/instantclien
t_23_5/sdk/include -DOracle_LIBRARY=/opt/oracle/instantclient_23_5/libclntsh.so

其中Oracle_INCLUDE_DIR为存放oci.h等头文件的目录。

相关推荐
努力学习的小廉1 小时前
深入了解linux网络—— 自定义协议(上)
linux·服务器·网络
十碗饭吃不饱1 小时前
sql报错:java.sql.SQLSyntaxErrorException: Unknown column ‘as0‘ in ‘where clause‘
java·数据库·sql
灵性花火1 小时前
记录Qt的多个bug
qt·bug
bcgbsh1 小时前
Linux开机启动脚本(cron 的 @reboot 特性)
linux·cron
呆呆小金人1 小时前
SQL入门: HAVING用法全解析
大数据·数据库·数据仓库·sql·数据库开发·etl·etl工程师
听风吹雨yu1 小时前
RK3588从数据集到训练到部署YoloV8
linux·yolo·开源·rk3588·rknn
iconball2 小时前
个人用云计算学习笔记 --19 (MariaDB服务器)
linux·运维·笔记·学习·云计算
Lynnxiaowen2 小时前
今天我们开始学习python3编程之python基础
linux·运维·python·学习
Chandler243 小时前
一图掌握 操作系统 核心要点
linux·windows·后端·系统
奥特曼狂扁小怪兽3 小时前
Qt 自定义无标题栏窗口:FramelessWidget 实现与解析
开发语言·qt