【经验分享】在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 企业版数据库