从零上手 openGauss:Docker 部署 + 全场景连接教程

📅 2026/8/5 4:05:54
从零上手 openGauss:Docker 部署 + 全场景连接教程
本文首发于 栏轩·阁欢迎访问阅读原文获取更好的阅读体验。openGauss 是一款开源的关系型数据库管理系统由华为基于 PostgreSQL 内核开发深度融合了华为在数据库领域多年的技术积累。它具备高性能、高可用、高安全、易运维等特点支持 x86 和 ARM 架构广泛应用于金融、政府、电信等企业级核心场景。核心特性高性能支持多核并行、智能索引、LLVM 编译加速等技术TPC-C 性能优异高可用支持主备同步/异步复制、故障自动切换、两地三中心部署高安全全密态计算、RBAC 权限控制、审计日志、透明加密兼容性兼容 PostgreSQL 语法迁移成本低一、安装基于 Docker推荐使用 Docker 安装 openGauss 是最快捷的方式无需手动处理系统依赖和编译配置。官方文档参考 openGauss 官方容器化部署文档容器镜像安装 | openGauss文档 | openGauss社区Docker Compose 配置创建docker-compose.yml文件内容如下services:mt-opengauss:image:opengauss/opengauss-server:latestcontainer_name:mt-opengaussprivileged:true# 容器内需要内核参数调整须提权environment:GS_PASSWORD:Gauss123# 数据库超级用户 gaussdb 的密码必填GS_DB:fitarena# 初始化时自动创建的数据库名TZ:Asia/Shanghai# 时区设置为中国标准时间ports:-25433:5432# 宿主机 25433 端口映射到容器 5432volumes:-/volume/MilkTea/opengauss/data:/var/lib/opengauss# 持久化数据目录配置说明配置项说明image使用 openGauss 官方最新镜像privilegedopenGauss 需要调整内核参数如共享内存必须开启提权模式GS_PASSWORD必填环境变量设置数据库超级用户gaussdb的密码GS_DB可选容器启动时自动创建的数据库名称ports容器内部 openGauss 默认端口为5432映射到宿主机25433volumes将数据持久化到宿主机防止容器删除后数据丢失启动容器dockercompose up-d二、数据库连接方式1. 容器内连接直接进入容器使用gsql命令行工具连接数据库# 进入容器dockerexec-itmt-opengaussbash# 切换为操作系统超级用户 ommsu- omm# 使用 gsql 连接数据库默认端口 5432gsql-dpostgres-p5432连接成功后的输出如下提示-d postgres表示连接到 postgres 数据库openGauss 默认自带的系统数据库-p 5432指定容器内部端口。2. 宿主机连接使用 psqlopenGauss 兼容 PostgreSQL 协议因此可以直接使用psql客户端连接。安装 psql 客户端sudoaptupdatesudoaptinstall-ypostgresql-client连接命令PGPASSWORDGauss123psql-hlocalhost-p25433-Ugaussdb-dpostgres参数说明PGPASSWORD环境变量方式传入密码避免交互输入-h localhost宿主机地址-p 25433映射到宿主机的端口-U gaussdbopenGauss 默认的数据库超级用户名-d postgres要连接的数据库名称连接成功输出如下3. IntelliJ IDEA 连接IDEA 默认不支持 openGauss需要手动添加 JDBC 驱动。3.1 下载 openGauss JDBC 驱动访问 openGauss 官方下载页面获取最新的 JDBC 驱动 JAR 包openGauss软件 | openGauss下载 | openGauss软件包 | openGauss社区官网3.2 在 IDEA 中添加驱动打开Database工具窗口View → Tool Windows → Database点击 → Driver → PostgreSQL因为 openGauss 兼容 PG 协议选择 PG 模板修改更方便在驱动设置页面添加下载好的 openGauss JDBC JAR 包将Class设置为org.opengauss.Driver3.3 创建数据库连接添加新数据源填写连接信息HostlocalhostPort25433DatabasepostgresUsergaussdbPasswordGauss123JDBC URLjdbc:opengauss://localhost:25433/postgres⚠️注意JDBC URL 路径中必须指定数据库名称这里使用默认的postgres数据库。如果不指定会连接失败。点击Test Connection验证连接成功后即可使用 IDEA 的 Database 工具浏览和管理数据库。三、常用操作示例连接成功后可以尝试以下基本操作查看数据库列表\l创建数据库和表-- 创建数据库CREATEDATABASEmydb;-- 切换到 mydb\c mydb-- 创建表CREATETABLEuser_info(idSERIALPRIMARYKEY,nameVARCHAR(100)NOTNULL,emailVARCHAR(200),created_atTIMESTAMPDEFAULTCURRENT_TIMESTAMP);插入和查询数据-- 插入数据INSERTINTOuser_info(name,email)VALUES(Alice,aliceexample.com);INSERTINTOuser_info(name,email)VALUES(Bob,bobexample.com);-- 查询数据SELECT*FROMuser_info;注意IDEA 中数据库操作以连接配置里指定的库为准。即便在图形界面切换了数据库SQL 仍会在配置库中执行界面仅做展示更新。四、总结本文介绍了使用 Docker 快速部署 openGauss 的完整流程涵盖了以下内容内容说明✅ Docker Compose 部署一键启动 openGauss 容器✅ 容器内连接使用gsql命令行操作✅ 宿主机连接通过psql客户端远程连接✅ IDEA 集成手动配置 JDBC 驱动可视化操作✅ 基础 SQL 操作建库建表、数据增删查改openGauss 作为一款企业级开源数据库在国产数据库生态中占据重要地位。通过 Docker 可以快速上手体验后续可进一步探索主备部署、性能调优、全密态计算等高级特性。