碎碎念
此文章为macOS使用docker配置openGauss的简单指引。之所以选择3.0.0版本,是因为我测试了若干版本后,发现很多更高的版本都会出现docker运行容器闪退的问题,于是根据
https://blog.csdn.net/Katharsis_Tk/article/details/138305306
和@ysy同学提供的经验,更换3.0.0版本后正常,特别感谢!
但是,上述教程仍然存在一些问题,所以建议参考本文。
推荐使用适宜的网络环境,如果没有,可以更换国内镜像源。
STEP1 下载安装docker
有关docker desktop的安装可以参考上述文章的前半部分,这里不再赘述。
或者可以参考以下文章:
STEP2 拉取openGauss镜像
docker配置完成后,在后台打开docker desktop,然后打开终端输入以下命令,拉取3.0.0版本的镜像:
docker pull enmotech/opengauss:3.0.0
等待拉取完成即可。
STEP3 创建openGauss容器
docker run --name opengauss --privileged=true -d -e GS_PASSWORD=openGauss@123 -p 5432:5432 enmotech/opengauss:3.0.0
运行该命令会返回一串id。
作为测试,不推荐在此步修改GS_PASSWORD。
然后打开docker,验证一下是否处于运行状态
此步中,如果出现容器运行闪退的情况,请检查:
1.端口是否被占用;
2.openGauss版本号是否为3.0.0。
上述命令中,-p 5432:5432
的位置不可改变。冒号前代表宿主机(即本机电脑)的端口号,冒号后代表docker中对应的端口号。如果你需要自定义,仅推荐修改前者。
如果容器处于Running状态,并且Port(s)列也正确显示了端口映射情况,则此步正确完成。
STEP4 完成openGauss的基础配置
此步参考https://blog.csdn.net/Katharsis_Tk/article/details/138305306。
安装后的openGauss默认有一个用户gaussdb,账户密码就是刚刚设置的密码,这里是openGauss@123
打开终端执行以下步骤:
先切换到omm用户,然后使用gsql工具创建普通用户方便管理:
su - omm
gsql -d postgres -U gaussdb -W openGauss@123
CREATE USER myuser WITH PASSWORD "userpw1.";
其中,"myuser"和"userpw1."可以分别替换为你设定的账号和密码。
STEP5 配置DBeaver
可以前往https://dbeaver.io/download/下载对应版本的DBeaver
macOS可以直接使用brew下载(推荐)
brew install --cask dbeaver-community
使用brew下载需要静待其完成安装,然后在启动台处即可找到。
如果提示没有brew可以自行搜索安装homebrew,一个强大的包管理器。
然后,下载并解压对应架构的openGauss JDBC驱动。
如果你是windows系统或Intel芯片的mac系统,通常选择x86_64;如果你是M芯片的mac系统,选择AArch64。
在DBeaver中,点击菜单栏的“Driver Manager”,然后点击NEW创建新的驱动。
在创建新驱动页,依次点击Libraries,Add File,添加我们刚刚解压的驱动文件(通常为带版本号的这个jar文件)
然后点击Find Class
完成后,切换到Settings,按照如下设置完成后,点击OK即可。(ID不用改)
jdbc:opengauss://{host}:{port}/{database}
方便各位粘贴

然后,在主界面,右键如图所示的postgres,选择Edit connection,然后填写用户和密码。可以是默认的账户,也可以是刚刚你新设置的账户。如果填写默认账户,且你没有修改我给出的默认密码,则默认密码是openGauss@123
在此步中,请保证docker开启,并且openGauss容器处于运行状态。
现在,双击postgres,即可连接上openGauss了!