国产开源数据框openGauss安装与jdbc连接

时间:2024-03-13 22:23:09

一、 openGauss 安装(企业版)

1. 获取安装包

1.1. 从 openGauss 开源社区下载对应平台的安装包。

通过软件包 | openGauss 登录 openGauss 开源社区,选择 2.0.0 版本对应平台企业版安装包(openGauss-2.0.0-CentOS-64bit-all.tar.gz)。 单击“下载”。

1.2. 检查安装包。

解压安装包,检查安装目录及文件是否齐全。在安装包所在目录执行以下命令:

tar -zxvf openGauss-2.0.0-CentOS-64bit-all.tar.gz
ls -1b

执行 ls 命令,显示类似如下信息:

<img src='https://pic.imgdb.cn/item/615130622ab3f51d9113b94a.png'>


2. 修改操作系统配置

2.1. 修改文件

如果安装的不是 Centos7.6,则要修改/etc/rehat-release 文件,将
CentOS Linux release 7.9.2003 (Core)修改为CentOS Linux release 7.6 (Core)

2.2. 关闭操作系统防火墙

步骤 1 修改/etc/selinux/config 文件中的“SELINUX”值为“disabled”。

使用 VIM 打开 config 文件。
vim /etc/selinux/config

修改“SELINUX”的值“disabled”,执行 :wq 保存并退出修改。

SELINUX=disabled

步骤 2 重新启动操作系统。

reboot

步骤 3 检查防火墙是否关闭。

systemctl status firewalld

若防火墙状态显示为 active (running),则表示防火墙未关闭,请执行步骤 4;
若防火墙状态显示为 inactive (dead),则无需再关闭防火墙。

步骤 4 关闭防火墙。

systemctl disable firewalld.service
systemctl stop firewalld.service

步骤 5 在其他主机上重复步骤 1 到步骤 4。


2.3. 设置字符集参数

将各数据库节点的字符集设置为相同的字符集,可以在/etc/profile 文件中添加”export LANG=XXX”(XXX 为 Unicode 编码)。
vim /etc/profile

2.4. 设置时区和时间

在各数据库节点上,确保时区和时间一致。

步骤 1 执行如下命令检查各数据库节点时间和时区是否一致。如果不一致,请执行步骤 2~步骤 3。

date

步骤 2 使用如下命令将各数据库节点/usr/share/zoneinfo/目录下的时区文件拷贝为/etc/localtime 文件。

cp /usr/share/zoneinfo/$地区/$时区/etc/localtime

说明:
地区 时区为需要设置时区的信息,例如:Asia/Shanghai。

步骤 3 使用 date -s 命令将各数据库节点的时间设置为统一时间,举例如下。

date -s "Sat Sep 27 16:00:07 CST 2020"


2.5. 设置网卡 MTU 值

将各数据库节点的网卡 MTU 值设置为相同大小。

步骤 1 执行如下命令查询服务器的网卡名称

ifconfig

步骤 2 使用如下命令将各数据库节点的网卡 MTU 值设置为相同大小。

对于 X86,MTU 值推荐 1500;对于 ARM,MTU 值推荐 8192。

ifconfig 网卡名称 mtu mtu值


3. 安装 openGauss

3.1. 创建 XML 配置文件

安装 openGauss 前需要创建 cluster_config.xml 文件。cluster_config.xml 文件包含部署
openGauss 的服务器信息、安装路径、IP 地址以及端口号等。用于告知 openGauss 如何
部署。用户需根据不同场景配置对应的 XML 文件。

配置数据库节点名称时,请通过 hostname 命令获取数据库节点的主机名称。

单节点配置文件

3.2.初始化安装环境

3.2.1. 准备安装用户及环境

步骤 1 以 root 用户登录待安装 openGauss 的任意主机,并按规划创建存放安装包的目录。

步骤 2 将安装包“openGauss-2.0.0-CentOS-64bit-all.tar.gz”和配置文件“cluster_config.xml”都上传至上一步所创建的目录中。

步骤 3 在安装包所在的目录下,解压安装包 openGauss-2.0.0-CentOS-64bit-all.tar.gz。安装包解压后,会有 OM 安装包和 Server 安装包。继续解压 OM 安装包,会在/opt/software/openGauss 路径下自动生成 script 子目录,并且在 script 目录下生成 gs_preinstall 等各种 OM 工具脚本。

步骤 4 进入到工具脚本存放目录下。
cd /opt/software/openGauss/script

步骤 5 为确保成功安装,执行命令检查 hostname 与 /etc/hostname 是否一致。

hostname
cat /etc/hostname

步骤 6 使用 gs_preinstall 需要 python3.6 的环境,一般自带的是 python2.7。

  • 安装 CentOS 开发工具 【用于允许您从源代码构建和编译软件】
    sudo yum -y “groupinstall development”

  • 下载 epel

    sudo yum install epel-release

  • 安装 python3

    sudo yum install python36

  • 更改默认 python

步骤 7 使用 gs_preinstall 准备好安装环境

采用交互模式执行前置,并在执行过程中自动创建 root 用户互信和 openGauss 用
户互信:

./gs_preinstall -U omm -G dbgrp -X /opt/software/openGauss/cluster_config.xml

3.2.2. 建立互信(使用脚本建立互信

步骤 1 创建一个执行互信脚本所需要的输入文本,并在此文件中添加 openGauss 中所有主机
IP。

vim hostfile

步骤 2 以需要创建互信的用户执行下面脚本建立互信。

./gs_sshexkey -f /opt/software/hostfile -W wangjingwei1

运行成功

3.3.执行安装

步骤 1 登录到 openGauss 的主机,并切换到 omm 用户。

su - omm

步骤 2 使用 gs_install 安装 openGauss。

gs_install -X /opt/software/openGauss/cluster_config.xml
在执行过程中,用户需根据提示输入数据库用户的密码,密码应具有一定的复杂度.

步骤 3 安装执行成功之后,需要手动删除主机 root 用户的互信,即删除 openGauss 数据库各
节点上的互信文件。

rm -rf ~/.ssh

安装完成

4. 安装验证

步骤 1 以 omm 用户身份登录服务器。

步骤 2 执行如下命令检查数据库状态是否正常,“cluster_state ”显示“Normal”表示数据
库可正常使用。

gs_om -t status

步骤 3 数据库安装完成后,默认生成名称为 postgres 的数据库。第一次连接数据库时可以连接到此数据库。其中 postgres 为需要连接的数据库名称,26000 为数据库主节点的端口号,即 XML 配置.文件中的 dataPortBase 的值。请根据实际情况替换。

gsql -d postgres -p 26000

连接成功后,系统显示类似如下信息表示数据库连接成功。

gsql ((openGauss x.x.x build 290d125f) compiled at 2021-03-08 02:59:43 commit 2143 last mr 131 Non-SSL connection (SSL connection is recommended when requiring high-security) Type "help" for help.

步骤 4 建立表,并插入内容进行查询

二、使用 jdbc 连接数据库

1. 确认连接信息

步骤 1 以操作系统用户 omm 登录数据库主节点。

步骤 2 使用“gs_om -t status --detail”命令查询 openGauss 各实例情况。

2. 配置服务端远程连接

步骤 1 以操作系统用户 omm 登录数据库主节点。

步骤 2 配置客户端认证方式

  • 需先本地连接数据库,并在数据库中使用如下语句建立“jack”用户:

    postgres=# CREATE USER jack PASSWORD 'Test@123';

  • 允许客户端以“jack”用户连接到本机,此处远程连接禁止使用

    “omm”用户(即数据库初始化用户)。下面示例中配置允许 IP 地址为 10.27.1.209 的客户端访问本机。

步骤 3 配置listen_addresses,listen_addresses 即远程客户端连接使用的数据库主节点 ip 或者主机名。

  • 使用如下命令查看数据库主节点目前的 listen_addresses 配置。

    gs_guc check -I all -c "listen_addresses"

  • 使用如下命令把要添加的 IP 追加到 listen_addresses 后面,多个配置项之间用英文逗号分隔。例如,追加 IP 地址 10.11.12.13。

    gs_guc set -I all -c"listen_addresses='localhost,***.***.***.***00,10.11.12.13'"

步骤 4 执行如下命令重启 openGauss。
gs_om -t stop && gs_om -t start

3. JDBC 包、驱动类和环境类

  • 在 openGauss 官网下载 JDBC 包,openGauss-2.0.0-JDBC.tar.gz,解压获得驱动 jar 包 postgresql.jar。

  • 在创建数据库连接之前,需要加载数据库驱动类“org.postgresql.Driver”。

  • 终端输入“java -version”,查看 JDK 版本,确认为 JDK1.8 版本。

4. 驱动加载

在代码中创建连接之前任意位置隐含装载:Class.forName("org.postgresql.Driver");

  • 在 windows 下运行代码进行连接时,使用 eclipse 装载驱动即可。
  • 在 centos 系统下连接数据库时,要将 postgresql.jar 驱动包设置到 java 的 classpath环境变量中。

    将 postgresql.jar 类库文件拷贝到...\Java\jdk1.7.0\jre\lib\ext 目录下。(这个路径根据 JDK 的版本和安装路径确定,下同)

    将 postgresql.jar 类库文件拷贝到...\Java\jre7\lib\ext目录下( 最好是,只要是 jre 文件夹,都复制一个 postgresql.jar 到 jre7\lib\ext 里去)

5. 连接数据库

JDBC 提供了三个方法,用于创建数据库连接。


1. DriverManager.getConnection(String url)
2. DriverManager.getConnection(String url, Properties info);
3. DriverManager.getConnection(String url, String user, String password);
  • 连接数据库并在表中插入数据

    连接时会以某一用户访问某一表,要先在数据库中对该用户进行授权。

查询此表进行验证

三、 遇到的问题

  1. 刚开始安装的极简版,发现有一个命令使用不了,后来改安装企业版就没遇到这个问题。

  2. centos 版本问题:在网上没有找到 centos7.6,只找到 7.9,运行时会报错,要修改/etc/rehat-release 文件,将
    CentOS Linux release 7.9.2003 (Core)修改为CentOS Linux release 7.6 (Core)

  3. 安装 python3

    • 安装 CentOS 开发工具 【用于允许您从源代码构建和编译软件】
      sudo yum -y “groupinstall development”

    • 下载 epel sudo yum install epel-release

    • 安装 python3 sudo yum install python36

    • 更改默认 python

  4. 连接问题

    连接 windows 主机时,远程连接也配置了,互信也建立了,总是报连接错误问题。后来选择连接虚拟机,连接虚拟机要先配 jdk,直接使用 yum 安装比较方便:

    • 搜索 jdk 安装包

      # yum search java|grep jdk
      
    • 下载 jdk1.8,下载后默认目录为:/uer/lib/jvm/

      # yum install java-1.8.0-openjdk
      
    • 验证安装

    后面要进行驱动加载,不加载的话使用不了下载的文件。要将 postgresql.jar 驱动包设置到 java 的 classpath环境变量中。

    将 postgresql.jar 类库文件拷贝到...\Java\jdk1.7.0\jre\lib\ext 目录下。(这个路径根据 JDK 的版本和安装路径确定,下同)

    将 postgresql.jar 类库文件拷贝到...\Java\jre7\lib\ext 目录下( 最好是,只要是 jre 文件夹,都复制一个 postgresql.jar 到 jre7\lib\ext 里去)