活动专区

活动公告

上车！GBase 8a开发者联盟发车了 技术福利、人脉资源全都有！

认证培训专区

认证培训资料

GBase 8s GDCA 认证培训课前准备

GBase 8a

其他

物化视图报错：references invalid table(s) or column(s) or function(s) or definer/invoker of view lack rights to use them

01-GBase 8s 事务型数据库 安装与卸载

GBase 8s

适配迁移

[GBase 8s 教程]GBase 8s 常用函数、表达式

## 前言

GBase 8s 是南大通用自主研发、支持共享存储集群、两地三中心部署的、成熟稳定的百 T 金融级事务型国产数据库。GBase 8s 适用于 OLTP 应用场景，包括金融、电信、政企、安全等行业的关键核心业务系统，在当前安全形势日益严峻的大背景下，GBase 8s 已成为去 IOE 的主流国产数据库产品，能够在 90% 以上的场景中替代 Oracle。

本文基于 GBase 8s GDCA培训文档《[GBase 8s 事务型数据库 安装与卸载](https://www.gbase.cn/community/post/1452)》介绍的方法安装部署GBase 8s数据库，采用默认安装路径为例，全面梳理安装完成后的核心目录结构、各目录作用、关键文件与核心工具，帮助社区用户快速熟悉GBase 8s数据库环境，高效完成日常运维、开发与问题排查工作。

&gt; 说明：本文GBase 8s  安装目录为 `/opt/gbase`，所有目录均基于该路径展开；不同版本目录命名略有差异，核心结构与功能完全一致。

## 一、环境变量前置说明

GBase 8s 数据库的运行、工具调用、实例管理，均依赖核心环境变量，安装完成后需为 `gbasedbt` 数据库超级用户配置环境变量。

例如：查看 gbasedbt 用户的`profile.gbaseserver`文件，得到如下环境变量设置信息：

```bash
# 数据库实例名 
GBASEDBTSERVER=gbaseserver 

# 数据库安装根目录，核心变量 
GBASEDBTDIR=/opt/gbase 

# 客户端连接配置文件路径
GBASEDBTSQLHOSTS=/opt/gbase/etc/sqlhosts.gbaseserver 

# 数据库实例主配置文件名 
ONCONFIG=onconfig.gbaseserver 

# 系统可执行文件路径，让系统可直接调用数据库命令
PATH=/opt/gbase8s/bin:$PATH 

# 数据库字符集 
DB_LOCALE=zh_CN.utf8 

# 数据库客户端本地化规则，与服务端字符集完全匹配，确保数据传输、客户端显示无乱码 
CLIENT_LOCALE=zh_CN.utf8 

# 关闭数据库额外字符集转换功能，中文 UTF-8 环境下规避乱码
unset GL_USEGLU
```

## 二、核心目录总览

GBase 8s 典型安装完成后，可以看到安装根目录下的目录和文件列表

![image.png](https://g1.cdn.gbase.cn/CommunityUploads/bluib6mUVob61lS_OHCSx/image.png)

这些目录和文件涵盖了数据库的运行程序、配置、数据、日志以及开发接口等核心组件。

下面将对各个目录和文件分类进行详细功能说明：

### 1、核心运行与配置目录

* **bin/   ( 日常操作核心：命令与工具）**
  * ​**作用**​：存放数据库的​**可执行命令和工具**​。
  * ​**内容**​：该目录存放数据库服务端程序、客户端交互工具、运维管理命令、数据备份恢复工具，是日常操作中最常用的目录，所有数据库核心操作均来自该目录下的可执行文件。
  * 核心工具与文件说明：

|    工具名    | 核心用途 |
|-------------|----------|
| `oninit` | 数据库实例启动命令，是启动数据库的核心工具 |
| `onmode` | 数据库运维核心命令，可完成实例关闭、日志切换、参数修改、强制 checkpoint、锁管理等操作 |
| `onstat` | 数据库状态监控工具，最常用的排查工具，可查看实例运行状态、锁情况、事务状态、缓冲区命中率、磁盘碎片、会话连接等核心指标 |
| `dbaccess` | GBase 8s 自带的 SQL 客户端工具，可交互式执行 DDL/DML 语句、存储过程、函数，是日常开发与运维的核心交互工具 |
| `dbexport`/`dbimport` | 数据库逻辑备份与恢复工具，可完成整库、单表的逻辑导出与导入，支持跨版本数据迁移 |
| `dbschema` | 数据库结构导出工具，可快速导出表、索引、存储过程、函数、视图的定义语句，用于结构备份与迁移 |
| `oncheck` | 数据校验与索引修复工具，可检测数据页一致性、索引损坏问题，支持数据页修复 |
| `ontape`/`onbar` | 数据库物理备份与恢复工具，支持全量、增量备份，是生产环境核心的备份恢复工具 |
| `dbload` | 数据批量加载工具，可快速将文本文件中的数据批量导入数据库表中，适用于大数据量初始化场景 |

* **etc/  （运维核心：配置与权限）**
  * ​**作用**​：存放数据库的​**配置文件**​。
  * ​**内容**​：该目录存放数据库实例的核心配置文件、客户端连接配置、系统环境脚本，是数据库运维的核心目录，主要配置文件：
    * `onconfig.&lt;实例名&gt;`：主参数文件，定义内存、磁盘路径、线程数等核心参数。
    * `sqlhosts.&lt;实例名&gt;`：网络配置，定义 IP 地址和端口号。
    * `GBaseInit_gbasedbt.sh`：用于初始化数据库实例的脚本。
* **lib/**
  * ​**作用**​：存放​**共享库文件**​（动态链接库）。
  * ​**内容**​：所有`*.so` 动态链接库文件，是 `bin` 目录下工具、第三方应用程序、JDBC/ODBC 驱动连接数据库的核心依赖。包含GBase 8s数据库服务端运行的核心库、客户端连接库、开发接口库、功能扩展库。

### 2、数据存储与扩展目录

* **gbaseserver\_dbs/**
  * ​**作用**​：存放数据库的​**物理数据文件**​（Chunks）。
  * ​**内容**​：在初始化实例时创建的 `rootdbs`、`datadbs`、`logdbs`、`tempdbs` `sbspace1`等文件都位于此目录下，存储着实际的表数据和日志信息。
* **extend/**
  * ​**作用**​：存放​**扩展功能模块**​。
  * ​**内容**​：包括空间数据支持（Spatial DataBlade）、时间序列数据支持（TimeSeries）以及其他可选的数据刀片模块。
* **tmp/**
  * ​**作用**​：存放​**临时文件**​。
  * ​**内容**​：数据库运行时产生的临时排序文件、共享内存映射文件等。如果数据库异常关闭，这里可能会残留一些临时文件。

### 3、开发与接口支持目录

* **incl/**
  * ​**作用**​：存放​**头文件**​。
  * ​**内容**​：供 C/C++ 开发者编译应用程序时引用的 `.h` 文件（如 ESQL/C 接口）。
* **SDK/**
  * ​**作用**​：​**软件开发工具包**​。
  * ​**内容**​：包含用于开发数据库应用程序的工具、示例代码和文档。
* **gls/**
  * ​**作用**​：​**全球化支持**​。
  * ​**内容**​：存放字符集转换表、语言环境定义等，用于支持多语言和不同字符集的显示与处理。
* **isa/**
  * ​**作用**​：​**智能警报系统**​。
  * ​**内容**​：用于配置数据库监控和报警规则的文件及脚本。
* **ssl/**
  * ​**作用**​：​**安全套接字层支持**​。
  * ​**内容**​：存放 SSL 证书、密钥以及加密通信相关的配置文件。

### 4、文档、消息与辅助目录

* **doc/**
  * ​**作用**​：存放​**产品文档**​。
  * ​**内容**​：安装指南、版本说明、基础操作手册等 HTML 或文本文件。
* **msg/**
  * ​**作用**​：存放​**错误消息文件**​。
  * ​**内容**​：定义了数据库报错信息的文本描述（例如 `Gbase.msg`），当数据库报错时，系统会从这里读取具体的错误解释。
* **demo/**
  * ​**作用**​：存放​**演示示例**​。
  * ​**内容**​：简单的 SQL 脚本或程序示例，帮助用户快速上手。
* **release/**
  * ​**作用**​：存放​**发布版本信息**​。
  * ​**内容**​：记录当前安装的 GBase 8s 具体版本号、补丁级别等信息。

### 5、安装相关日志与脚本

* **RUNasroot.installserver**
  * ​**作用**​：​**安装脚本**​。
  * ​**内容**​：这是一个 Shell 脚本，通常是在安装过程中由 root 用户执行的，用于设置文件权限、创建用户组等需要高权限的操作。
* **uninstall/**
  * ​**作用**​：​**卸载程序**​。
  * ​**内容**​：包含用于安全移除 GBase 8s 软件的脚本和工具。
* **日志文件**
  * `GBase_GLS_Install...log`：GLS（全球化支持）组件的安装日志。
  * `GBase_Install...log`：主数据库软件的安装日志。
  * `GBase_Software_Bundle_Install...log`：软件 bundles 的安装日志。
  * ​**作用**​：如果在安装过程中遇到问题，或者需要确认安装是否成功，可以查看这些日志文件。

## 三、关键注意事项

1. 所有数据目录的所属用户与用户组必须为 `gbasedbt:gbasedbt`，权限建议设置为 `660`，避免其他用户访问修改
2. 生产环境严禁将数据文件、日志文件放在 `/opt/gbase` 安装目录内，避免升级、重装数据库时导致数据丢失
3. 数据目录所在磁盘必须预留足够的空闲空间，建议至少预留 30% 以上的空闲空间，避免磁盘占满导致数据库宕机

## 四、总结建议

GBase 8s 安装完成后的目录结构逻辑清晰，对于日常运维，你最常接触的将是 `bin/`（执行命令）、`etc/`（修改配置）和 `gbaseserver_dbs/`（检查磁盘空间）。如果是开发人员，则主要关注 `incl/` 和 `SDK/`。

掌握数据库的目录结构，可帮助用户快速定位配置文件、日志文件、可执行工具，高效完成日常启停、运维管理、故障排查、数据备份恢复等工作，也是深入学习 GBase 8s 数据库的基础。



安装配置

GBase 8s 数据库安装完成后目录结构详解

GBase 8s 数据库安装完成后目录结构详解

评论

热门帖子