【经验分享】在Kylin桌面版操作系统中配置openGauss的ODBC数据源

引言

openGauss是一款开源的关系型数据库管理系统，它提供了强大的功能和性能，可以满足各种企业级应用的需求。与此同时，ODBC（Open Database Connectivity）是一个标准的数据库访问接口，它允许应用程序通过统一的方式与不同的数据库进行通信。本文将介绍如何在银河麒麟桌面操作系统进行openGauss的ODBC数据源配置。

环境准备

• VMware 17.0.2

• openGauss_5.0.0

• MobaXterm 22.1

• 服务器名称：node0，IP地址：192.168.192.139

• unixODBC-2.3.0

• 银河麒麟桌面操作系统V10 (SP1)

nwh@nwh-pc:~/桌面$ cat /etc/os-release
NAME="Kylin"
VERSION="银河麒麟桌面操作系统V10 (SP1)"
VERSION_US="Kylin Linux Desktop V10 (SP1)"
ID=kylin
ID_LIKE=debian
PRETTY_NAME="Kylin V10 SP1"
VERSION_ID="v10"
HOME_URL="http://www.kylinos.cn/"
SUPPORT_URL="http://www.kylinos.cn/support/technology.html"
BUG_REPORT_URL="http://www.kylinos.cn/"
PRIVACY_POLICY_URL="http://www.kylinos.cn"
VERSION_CODENAME=kylin
UBUNTU_CODENAME=kylin
PROJECT_CODENAME=V10SP1
KYLIN_RELEASE_ID="2303"

设置应用保护

• 安全中心，设置应用保护

build-essential 包

• 安装 build-essential 包

nwh@nwh-pc:~/桌面$ sudo apt-get install -y build-essential
正在读取软件包列表... 完成
正在分析软件包的依赖关系树
正在读取状态信息... 完成
下列软件包是自动安装的并且现在不需要了：
archdetect-deb dmeventd libaio1 libdebian-installer4 libdevmapper-event1.02.1 liblvm2cmd2.03 localechooser-data lvm2 user-setup
使用'sudo apt autoremove'来卸载它(它们)。
将会同时安装下列软件：
cpp-10 g++ g++-10 g++-9 gcc-10 libasan6 libc-dev-bin libc6-dev libcrypt-dev libgcc-10-dev libstdc++-10-dev libstdc++-9-dev linux-libc-dev
建议安装：
gcc-10-locales g++-multilib g++-10-multilib gcc-10-doc g++-9-multilib gcc-9-doc gcc-10-multilib glibc-doc manpages-dev libstdc++-10-doc libstdc++-9-doc
推荐安装：
manpages manpages-dev
下列【新】软件包将被安装：
build-essential cpp-10 g++ g++-10 g++-9 gcc-10 libasan6 libc-dev-bin libc6-dev libcrypt-dev libgcc-10-dev libstdc++-10-dev libstdc++-9-dev linux-libc-dev
升级了 0 个软件包，新安装了 14 个软件包，要卸载 0 个软件包，有 3 个软件包未被升级。
需要下载 56.7 MB 的归档。
解压缩后会消耗 224 MB 的额外空间。
获取:1 http://archive.kylinos.cn/kylin/KYLIN-ALL 10.1-2303-hwe-updates/main amd64 libc-dev-bin amd64 2.31-0kylin9.2 [301 kB]
......

创建目录

nwh@nwh-pc:~$ mkdir -p odbc/etc
nwh@nwh-pc:~$ ls
公共的 视频 文档 音乐 bashrc.txt MPPODBC.txt openGauss-5.0.0-ODBC.tar.gz unixODBC-2.3.0.tar.gz unixODBC-2.3.7pre.tar.gz
模板 图片 下载 桌面 GaussMPP.txt odbc unixODBC-2.3.0 unixODBC-2.3.5.tar.gz
nwh@nwh-pc:~$ cd odbc/
nwh@nwh-pc:~/odbc$ ls
etc

安装unixODBC

解压 unixODBC-2.3.0.tar.gz

nwh@nwh-pc:~$ tar -zxf unixODBC-2.3.0.tar.gz
nwh@nwh-pc:~$ ll
总用量 14676
drwx------ 21 nwh nwh 4096 8月 4 00:03 ./
drwxr-xr-x 3 root root 4096 8月 1 21:21 ../
drwxr-xr-x 2 nwh nwh 4096 8月 1 21:24 公共的/
drwxr-xr-x 2 nwh nwh 4096 8月 1 21:27 模板/
drwxr-xr-x 2 nwh nwh 4096 8月 1 21:24 视频/
drwxr-xr-x 2 nwh nwh 4096 8月 1 21:24 图片/
drwxr-xr-x 2 nwh nwh 4096 8月 1 21:24 文档/
drwxr-xr-x 2 nwh nwh 4096 8月 1 21:24 下载/
drwxr-xr-x 2 nwh nwh 4096 8月 1 21:24 音乐/
drwxr-xr-x 2 nwh nwh 4096 8月 1 21:27 桌面/
-rw------- 1 nwh nwh 64 8月 1 22:02 .bash_history
-rw-r--r-- 1 nwh nwh 220 4月 15 2020 .bash_logout
-rw-r--r-- 1 nwh nwh 3854 4月 27 15:27 .bashrc
-rw-rw-r-- 1 nwh nwh 184 8月 1 21:59 bashrc.txt
drwxrwxr-x 14 nwh nwh 4096 8月 3 23:42 .cache/
drwx------ 14 nwh nwh 4096 8月 3 23:43 .config/
drwx------ 3 nwh nwh 4096 8月 1 21:24 .dbus/
-rw-r--r-- 1 nwh nwh 23 8月 1 21:24 .dmrc
-rw-rw-r-- 1 nwh nwh 83 8月 1 21:59 GaussMPP.txt
drwx------ 3 nwh nwh 4096 8月 1 21:24 .gnupg/
-rw-rw-r-- 1 nwh nwh 413 8月 3 23:42 .imwheelrc
drwxrwxr-x 2 nwh nwh 4096 8月 1 21:24 .kylin-os-manager-config/
drwxrwxr-x 3 nwh nwh 4096 8月 1 21:24 .local/
drwxr-xr-x 5 nwh nwh 4096 8月 3 23:44 .log/
-rw-rw-r-- 1 nwh nwh 129 8月 1 21:59 MPPODBC.txt
-rw-rw-r-- 1 nwh nwh 9455102 8月 1 22:00 openGauss-5.0.0-ODBC.tar.gz
drwx------ 2 nwh nwh 4096 8月 1 21:24 .presage/
-rw-r--r-- 1 nwh nwh 807 4月 15 2020 .profile
drwxr-xr-x 2 nwh nwh 4096 8月 1 22:01 .qaxsafe/
drwxrwxr-x 2 nwh nwh 4096 8月 1 21:24 .sogouinput/
-rw-r--r-- 1 nwh nwh 0 8月 1 21:27 .sudo_as_admin_successful
-rw-rw-r-- 1 nwh nwh 25 8月 1 21:33 .ukui-screensaver-default.conf
drwxr-xr-x 19 nwh nwh 4096 4月 20 2010 unixODBC-2.3.0/
-rw-rw-r-- 1 nwh nwh 1804749 8月 1 22:01 unixODBC-2.3.0.tar.gz
-rw-rw-r-- 1 nwh nwh 1633390 8月 1 22:01 unixODBC-2.3.5.tar.gz
-rw-rw-r-- 1 nwh nwh 1669682 8月 1 22:01 unixODBC-2.3.7pre.tar.gz
-rw------- 1 nwh nwh 103 8月 3 23:41 .Xauthority
-rw-r--r-- 1 nwh nwh 13 4月 27 15:38 .xsession
-rw------- 1 nwh nwh 125000 8月 4 00:03 .xsession-errors
-rw------- 1 nwh nwh 184349 8月 1 22:02 .xsession-errors.old

修改configure文件

找到LIB_VERSION，将它的值修改为"1:0:0"，这样将编译出*.so.1的动态库，与psqlodbcw.so的依赖关系相同。

编译configure

nwh@nwh-pc:~/unixODBC-2.3.0$ ./configure --prefix=/home/nwh/odbc/
checking for a BSD-compatible install... /usr/bin/install -c
checking whether build environment is sane... yes
checking for a thread-safe mkdir -p... /usr/bin/mkdir -p
checking for gawk... no
checking for mawk... mawk
checking whether make sets $(MAKE)... yes
checking for gawk... (cached) mawk
checking for bison... no
checking for byacc... no
checking for style of include used by make... GNU
checking for gcc... gcc
checking for C compiler default output file name... a.out
checking whether the C compiler works... yes
checking whether we are cross compiling... no

......

安装

nwh@nwh-pc:~/unixODBC-2.3.0$ make && make install

替换客户端openGauss驱动程序

下载ODBC驱动包

下载openEuler 20.03 LTS环境下的ODBC驱动包

下载ODBC驱动包：https://opengauss.org/zh/download/

解压ODBC驱动包

nwh@nwh-pc:~$ mkdir -p install
nwh@nwh-pc:~$ tar -zxf openGauss-5.0.0-ODBC.tar.gz -C install/
nwh@nwh-pc:~$ ls
公共的 图片 音乐 GaussMPP.txt odbc unixODBC-2.3.0.tar.gz
模板 文档 桌面 install openGauss-5.0.0-ODBC.tar.gz unixODBC-2.3.5.tar.gz
视频 下载 bashrc.txt MPPODBC.txt unixODBC-2.3.0 unixODBC-2.3.7pre.tar.gz
nwh@nwh-pc:~$ cd install/
nwh@nwh-pc:~/install$ ls
lib odbc

解压后会得到两个文件夹：lib与odbc；

在odbc文件夹中还会有一个lib文件夹。/odbc/lib中会有“psqlodbca.la”，“psqlodbca.so”，“psqlodbcw.la”和“psqlodbcw.so”四个文件，将这四个文件拷贝到“/home/nwh/odbc/lib”目录下；

将openGauss-5.0.0-ODBC.tar.gz解压后lib目录中的库拷贝到“/home/nwh/odbc/lib”目录下。

nwh@nwh-pc:~/install$ pwd
/home/nwh/install
nwh@nwh-pc:~/install$ ls
lib odbc
nwh@nwh-pc:~/install$ cd odbc/
nwh@nwh-pc:~/install/odbc$ ls
lib
nwh@nwh-pc:~/install/odbc$ cd lib/
nwh@nwh-pc:~/install/odbc/lib$ cp * /home/nwh/odbc/lib/
nwh@nwh-pc:~/install/odbc/lib$ cd ..
nwh@nwh-pc:~/install/odbc$ cd ..
nwh@nwh-pc:~/install$ cd lib/
nwh@nwh-pc:~/install/lib$ cp * /home/nwh/odbc/lib/
nwh@nwh-pc:~/install/lib$
nwh@nwh-pc:~/odbc/lib$ pwd
/home/nwh/odbc/lib
nwh@nwh-pc:~/odbc/lib$ ls
libodbccr.la libodbccr.so.1 libodbcinst.la libodbcinst.so.1 libodbc.la libodbc.so.1 psqlodbca.la psqlodbcw.la
libodbccr.so libodbccr.so.1.0.0 libodbcinst.so libodbcinst.so.1.0.0 libodbc.so libodbc.so.1.0.0 psqlodbca.so psqlodbcw.so
nwh@nwh-pc:~/odbc/lib$ ls
libcom_err_gauss.so libgssrpc_gauss.so libkrb5support_gauss.so.0 libodbcinst.so.1 libpgport_tool.so libssl.so
libcom_err_gauss.so.3 libgssrpc_gauss.so.4 libkrb5support_gauss.so.0.1 libodbcinst.so.1.0.0 libpgport_tool.so.1 libssl.so.1.1
libcom_err_gauss.so.3.0 libgssrpc_gauss.so.4.2 libodbccr.la libodbcinst.so.2 libpq.a psqlodbca.la
libconfig.so libk5crypto_gauss.so libodbccr.so libodbcinst.so.2.0.0 libpq_ce.a psqlodbca.so
libconfig.so.4 libk5crypto_gauss.so.3 libodbccr.so.1 libodbc.la libpq_ce.so psqlodbcw.la
libcrypto.so libk5crypto_gauss.so.3.1 libodbccr.so.1.0.0 libodbc.so libpq_ce.so.5 psqlodbcw.so
libcrypto.so.1.1 libkrb5_gauss.so libodbccr.so.2 libodbc.so.1 libpq_ce.so.5.5
libgssapi_krb5_gauss.so libkrb5_gauss.so.3 libodbccr.so.2.0.0 libodbc.so.1.0.0 libpq.so
libgssapi_krb5_gauss.so.2 libkrb5_gauss.so.3.3 libodbcinst.la libodbc.so.2 libpq.so.5
libgssapi_krb5_gauss.so.2.2 libkrb5support_gauss.so libodbcinst.so libodbc.so.2.0.0 libpq.so.5.5
nwh@nwh-pc:~/odbc/lib$

配置数据源

配置ODBC驱动文件

在“/home/nwh/odbc/etc/odbcinst.ini”文件中追加以下内容。nwh@nwh-pc:~/odbc/etc$ vim odbcinst.ini
nwh@nwh-pc:~/odbc/etc$ vim odbcinst.ini
[GaussMPP]
Driver64=/home/nwh/odbc/lib/psqlodbcw.so
setup=/home/nwh/odbc/lib/psqlodbcw.so

配置数据源文件

在“/home/nwh/odbc/etc/odbc.ini”文件中追加以下内容。

nwh@nwh-pc:~/odbc/etc$ vim odbc.ini
[og]
Driver=GaussMPP
Servername=192.168.192.139 （数据库Server IP）
Database=gaussdb （数据库名）
Username=testuser （数据库用户名）
Password=openGauss!666 （数据库用户密码）
Port=15400 （数据库侦听端口）

配置环境变量

nwh@nwh-pc:~$ vim ~/.bashrc

在配置文件中追加以下内容。

export LD_LIBRARY_PATH=/home/nwh/odbc/lib:$LD_LIBRARY_PATH
export PATH=/home/nwh/odbc/bin:$PATH
export ODBCSYSINI=/home/nwh/odbc/etc
export ODBCINI=/home/nwh/odbc/etc/odbc.ini

执行如下命令使设置生效。

nwh@nwh-pc:~$ source ~/.bashrc

测试数据源配置

nwh@nwh-pc:~/odbc/bin$ isql -v og
+ ---------------------------------------+
| Connected! |
| |
| sql-statement |
| help [tablename] |
| quit |
| |
+ ---------------------------------------+
SQL>

在弹出的对话框中点击“允许”按钮。

总结

ODBC连接成功，就可以使用ODBC提供的函数来执行SQL查询和操作。ODBC提供了一组标准的接口函数，可以执行各种数据库操作，如执行SQL查询、插入、更新和删除数据等。通过这些函数，可以在openGauss数据库中进行各种数据操作，满足应用程序需求。

通过使用ODBC接口，可以在openGauss中实现高效的数据访问和跨平台连接。ODBC为开发人员提供了标准化的接口，并提供了一套丰富的函数来执行数据库操作。这种灵活性和可扩展性使得openGauss与ODBC的结合成为了开发企业级应用和在多平台上连接数据库的理想选择。

开始使用openGauss和ODBC吧，开启高效数据管理的新篇章！

非常感谢在本文相关形成过程中 openGauss 数据库官网来杯拿铁(刘恒)老师给予的支持。

附录

在VMware 17.0.2虚拟机中安装openEuler-22.03-LTS-SP2：https://www.modb.pro/db/1682365146923606016

Navicat连接openGauss_5.0.0 企业版数据库