GBase 8s开发与管理

本文介绍了如何在同一台机器上使用 Docker 容器搭建GBase 8s主备集群环境。

拉取镜像

拉取GBase 8s的最新镜像

docker pull liaosnet/gbase8s

或者

docker pull liaosnet/gbase8s:v8.8_3513x25_csdk_x64

注：在tag为v8.8_3513x25_csdk_x64及之后的版本中，可通过参数方式自动创建集群

拉取镜像成功后，可通过docker images查看拉取镜像的版本。

阅读全文»

从oracle迁移到GBase 8s数据库的过程中，有类似

select t.*
from t
order by dbms_random.value

进行随机排序查询的写法。
GBase 8s默认不支持dbms_random之类的函数，这些函数存在称为datablade的扩展包中，以下示例在库中注册excompat。

1，使用gbasedbt用户登陆，切换到 $GBASEDBTDIR/extend/excompat.1.0 目录下

  cd $GBASEDBTDIR/extend/excompat.1.0

2，临时取消当前的DB_LOCALE和CLIENT_LOCALE环境变量

  unset DB_LOCALE
  unset CLIENT_LOCALE

3，使用 blademgr 注册 excompat.1.0，以下是各步骤及说明

  blademgr                               # 进入 blademgr，提示符如： 数据库服务名>
  服务名> show databases                  # 显示可加载模块的库
  服务名> list testdb                     # 假设我们需要在testdb库中注册，先查看该有是否有注册模块
  服务名> register excompat.1.0 testdb    # 注册模块，要求有二次确认
  服务名> quit                            # 退出注册模块

4，使用 dbms_random_random 函数

-- 注意：该写法（order by 函数）并不是所有版本都支持
select t.* from systables t order by dbms_random_random();

-- 该写法均支持
select dbms_random_random(), t.*
from systables t
order by 1;

按实际需要修改写法。

GBase 8s数据类型与java.sql.Types对应关系

对应版本：3.6.3_3

备注：
1，此文档基于jdbc包3.6.3_3和数据库版本3.6.3_3;
2，JSON,BSON,RAW,CLOB2等别名参考实际类型。

更新日期：2025-10-24

简介：

Django 是一个由 Python 编写的一个开放源代码的 Web 应用框架。
使用 Django，只要很少的代码，Python 的程序开发人员就可以轻松地完成一个正式网站所需要的大部分内容，并进一步开发出全功能的 Web 服务 Django 本身基于 MVC 模型，即 Model（模型）+ View（视图）+ Controller（控制器）设计模式，MVC 模式使后续对程序的修改和扩展简化，并且使程序某一部分的重复利用成为可能。

系统要求：
1，操作系统使用22.04.3 LTS
2，unixodbc及unixodbc-dev已经安装
3，GBase 8s CSDK 64bit（客户端连接工具）已经安装
4，Python版本是3.10.12（系统自带）
5，Django版本使用4.2.15
6，需要pyodbc
7，使用django_gbasedbtdb 1.11.5版本

阅读全文»

近期的客户想实现数据库自重启功能（即故障后自动重启），该功能需要在自动启动的基础上进行改进。
关于systemd方式实现自启动的方法可参考之前的文档：https://gbasedbt.com/index.php/archives/161/
以下仍是通过systemd方式实现GBase 8s数据库的自启动、自重启与关闭。
注意：自启动、自重启仅适用于单机，而不要用于集群环境
适用于操作系统: RHEL7/CENTOS7, 以及基于RHEL7内核的系统。

systemd需要的一个配置文件目录为

1，service 文件所在位置 /usr/lib/systemd/system/

阅读全文»

GBase 8s的数据库CLOB是一种文本智能大对象类型，一般情况下可以使用fileclob函数进行插入数据，或者在程序中使用绑定变量的方式插入。
在GBase 8s的SQLMODE=Oracle模式中，实现了直接insert操作，但SQLMODE=GBase模式中没有实现
以下介绍自己实现在SQLMODE=GBase模式下实现直接insert clob的操作的方法
注意：数据库版本的不同，可能实现的方法略有不同
从扩展中创建dbms_lob_* 函数，使用到的：

阅读全文»

GBase 8s中没有ip类型字段（如inet），对于判断字符串是否是IP地址，需要自己编写相应的函数。
如下，实现检查输入的字符串是否为IPv4地址（-1否），且转换成数值类型：

阅读全文»

GBase 8s HAC集群允许配置为自动切换、CM控制的FOC切换及手工切换三种方式。
在自动切换中，主节点故障或者网络超时，备节点都将自动提升为主节（DRAUTO值为2）或者标准节点（DRAUTO值为1）。当原主节点需要恢复时，可直接启动（oninit -vy）、物理恢复方式（oninit -PHY后onmode -d secondary 主节点服务名称）或者备份恢复（脑裂时）。

在CM控制的切换中，主节点故障或者网络超时，备节点都将由CM控制提升为主节点。当原主节点需要恢复时，需要通过物理恢复的方式然后加入集群（oninit -PHY后onmode -d secondary 主节点服务名称）或者备份恢复（脑残时）。

在手工切换中，主节点故障或者网络超时，备节点需要手工提升为主节点，有两种方式：

• 1）备节点切换为标准模式，然后提升为主节点（onmode -d standard后onmode -d primary 对端服务名称）；
• 2）通过指令直接提升（onmode -d make primary 服务名称 [force]）

当原主节点需要恢复时，需要通过物理恢复的方式然后加入集群（oninit -PHY后onmode -d secondary 主节点服务名称）。

如果数据库集群无故障，只是需要进行主备节点切换时，也需要考虑当前的切换方式。可通过模拟主节点故障的方式进行切换，也可以通过强制切换的方式（onmode -d make primary 服务名称 force），恢复时按照故障时的恢复方式进行。

GBase 8s 数据库切换分为自动切换、由CM控制的按FOC规则的切换、手工切换。

自动切换

全自动切换用于HAC集群中，由于集群只有两个节点，数据库相互之前进行状态检查，发现异常时，能按DRAUTO的配置方式进行自动切换。
在HAC集群中：
DRAUTO参数配置为2时

• 1，当出现主节点故障时，备节点将自动提升为主节点。原主节点可通过直接启动的方式加入HAC集群，并自动成为HAC集群的备节点（限制条件：主节点的逻辑日志没有覆盖掉原主节点故障时的逻辑日志，即未出现逻辑日志绕圈）。
• 2，当出现备节点与主节点网络超时，备节点也将自动升级为主节点。如果原主节点保持运行，当网络恢复时，会形成双主现象（即脑裂），主节点会要求原主节点关闭，由于脑裂已经形成，无法能过直接启动的方式恢复HAC集群，仅能通过重建HAC集群的方式进行恢复。

阅读全文»

同样的GBase 8s数据库版本，自定义的java udr在Kylin V10SP1 服务器版（aarch64架构）下创建、运行正常，而在Kylin V10SP1 桌面版（aarch64架构）下时创建正常但运行UDR异常，报错如下：

(38000) - Unknown throwable: (java.lang.NoClassDefFoundError: Could not initialize class sun.security.ec.CurveDB).
Error in line 1
Near character position 62

阅读全文»