返回首页

gbase数据、南大通用产品文档:GBase8s获取实用程序的版本信息

更新日期:2024年09月11日

许多 GBase 8s 命令行实用程序都允许使用 -V 和 -version 选项来获取版本信息。这两
选项主要用于调试。
-V 选项显示了软件版本号和序列号。
-version 选项扩展 -V 选项,
显示关于创建操作系统、
创建号码以及创建日期的更多信息。


-V 和 -version 选项不能与任何其他实用程序选项一起使用。例如:onstat
-version 命
令可能显示以下输出。
onstat -version

Program: onstat
Build Version: 8.7
Build Host: connla
Build OS: SunOS 5.6
Build Number: 009
Build Date: Sat Nov 20 03:38:27 CDT 2011

GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 298 -
GLS Version: glslib-4.50.xC2
onstat -V 命令可能显示以下信息:
GBase 8s Version 8.7 Software Serial Number RDS#N000000

可以使用 onspaces -c -S 选项创建 sbspace 或临时 sbspace 。
语法:

元素
用途
关键注意事项
-S sbspace
给出要创建的 sbspace 名 Sbspace 名称必须唯一,
且不能超过 128 字
节。它必须以字母或下划线开始,且必须只
包含字母、数字、下划线或 $ 字符。
语法必须符合 Identifier 段;请参阅
《GBase 8s SQL 指南:语法》
- c
创建 sbspace
最多可创建 32767 个任意


GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 410 -

元素
用途
关键注意事项
类型的存储空间
-m pathname
offset
指定到镜像新 sbspace 的
初始 chunk 的 chunk 的
可选路径名和偏移量。
另见
此表中的 -p pathname 和
-o offset 条目
有关更多信息,请参阅 GBase 8s 管理员指
南 中的 数据存储一章中的 sbspace 以及
管理磁盘空间 一章中的 创建sbspace
-Mo mdoffset
指示将存储元数据的磁盘
分区或设备中的偏移量
(千
字节)
限制:
值可以是 0 到 chunk 大小之间的整
数。您不能指定导致元数据空间结束处超过
chunk 结束处的偏移量。
参考:有关更多信息,请参阅GBase
8s 管理
员指南 中的 管理磁盘空间 一章中的 缩放
sbspace 元数据大小
-Ms mdsize
指定初始 chunk 中分配的
元数据区域的大小(千字
节)
剩下的是用户数据空间
限制:值可以是 0 到 chunk 大小之间的整

-o offset
指示为到达新的 sbspace
的初始 chunk 而发生的磁
盘分区或设备中的偏移量
(千字节)
限制:无符号整数。开始偏移量必须大于等
于 0 。开始偏移量加 chunk 大小不能超过
最大 chunk 大小。对具有 2 千字节页大小
的系统,
最大 chunk 大小是 4 太字节 ,

具有 4 千字节页大小的系统,最大 chunk
大小是 8 太字节 。
参考:有关更多信息,请参阅 GBase 8s 管
理员指南中的 管理磁盘空间 一章中的 在
UNIX™ 上分配原始磁盘空间
-p pathname
指示 sbspace 初始 chunk Chunk 必须是现有的未缓冲设备或已缓冲文

GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 411 -

元素
用途
关键注意事项
的磁盘分区或未缓冲设备
件。指定路径名时,可以使用完整路径名或
相对路径名。然而,如果使用相对路径名,
这必须相对于是初始化数据库服务器时的当
前目录的目录。
参考:有关路径名语法,请参阅操作系统文

-s size
指示新 sbspace 初始
chunk 的大小(千字节)
限制:无符号整数。大小必须等于或大于
1000 千字节,并且必须是页大小的整倍数。
开始偏移量加 chunk 大小不能超过最大
chunk 大小。
最大 chunk 大小为 2 或 4 太字节。
这与平
台有关。
-t
创建用于存储临时智能大
对象的临时 sbspace 。您
可以指定元数据区域的大
小和偏移量
限制:
不能镜像临时 sbspace 。
您可以指定
任何 -Df 选项(LOGGING=ON 选项除外,它
不会生效)
参考:
有关更多信息,
请参阅 使用 -t 选项
创建临时 sbspace
-Df default
list
列出存储在 sbspace 中智
能大对象的缺省规范
限制:用逗号分隔标记,
如果未提供标记,

么优先使用系统缺省值。在命令行上,该列
表必须括在双引号(")中。
参考:有关标记及其参数的列表,请参阅 表
1

使用 -t 选项创建临时 sbspace
本示例创建 1000 千字节的临时 sbspace :
onspaces -c -S tempsbsp -t -p ./tempsbsp -o 0 -s 1000

GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 412 -

您可以选择在 SBSPACETEMP 配置参数中指定临时 sbspace 的名称。重新启动数据库服
务器,从而使它可使用临时 sbspace 。
使用 -Df 选项创建 Sbspace
使用可选的 -Df 选项创建 sbspace 时,可以指定几个缺省规范,这些规范影响存储在
sbspace 中的智能大对象的行为。
缺省规范必须用逗号分隔的列表表示。
该列表无需包含所
有标记。标记列表必须括在双引号(") 中。表 1 中的表描述了标记及其缺省值。
Sbspace 特征的四个继承级别是系统、sbspace、列以及智能大对象。有关更多信息,请参
阅 GBase 8s 管理员指南 中 数据存储在哪里 一章中的 智能大对象。
标记

缺省值
描述
ACCESSTIME
ON 或 OFF
OFF
设置为 ON 时,数据库服务器跟踪对存储在
sbspace 中的所有智能大对象的访问时间。
有关更改智能大对象存储特征的信息,请参阅
GBase 8s DataBlade API 程序员指南
AVG_LO_SIZE Windows™ :
4 到 2**31
UNIX™: 2
到 2**31
8
指定存储在 sbspace 中智能大对象的平均大小
(千字节)
数据库服务器使用该值计算元数据区域的大小。
不要一起指定 AVG_LO_SIZE 和 -Ms 。可以一起
指定 AVG_LO_SIZE 和元数据偏移量(-Mo) 。
如果智能大对象的大小超过 2**31,那么指定
2**31。
如果智能大对象的大小小于 2
(在 UNIX
上)
或小于 4
(在 Windows 中)

那么指定 2 或
4 。
如果耗尽 sbspace 中元数据和保留区域中的空
间,那么返回错误 131 。要将额外的 chunk 分
配给仅由元数据区域构成的 sbspace,请使用
-Ms 选项。
有关更多信息,请参阅 GBase
8s 管理员指南 中
的 管理磁盘数据 一章中的 创建智能大对象
BUFFERING
ON 或 OFF
ON
指定存储在 sbspace 中智能大对象的缓冲方式

GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 413 -

标记

缺省值
描述
如果设置为 ON ,那么对于智能大对象 I/O 操
作,数据库服务器使用共享内存常驻部分中的缓
冲池。如果设置为 OFF,那么数据库服务器使用
共享内存虚拟部分中的轻量级 I/O 缓冲区
(轻量
级 I/O 操作)。
BUFFERING
=
OFF 与 LOCK_MODE
=
RANGE 不兼容,
会产生冲突。
有关更多信息,请参阅 GBase 8s 性能指南中的
在内存上配置影响 一章中的 轻量级 I/O
LOCK_MODE
RANGE 或
BLOB
BLOB
指定存储在 sbspace 中的智能大对象的锁定方

如果设置为 RANGE ,
那么只锁定智能大对象中一
定范围内的字节。如果设置为 BLOB ,那么锁定
整个智能大对象。
LOCK_MODE = RANGE 与BUFFERING = OFF 不兼容,
会产生冲突。
有关更多信息,请参阅 GBase
8s 性能指南 中的
锁定 一章中的 智能大对象
LOGGING
ON 或 OFF
OFF
指定存储在 sbspace 中的智能大对象的登录状

如果设置为 ON,
那么数据库服务器将更改记录到
sbspace 中的用户数据区域。
在打开 sbspace 的
日志记录时,对 sbspace 进行 0 级备份。
当关闭日志记录时,显示以下消息:您正在关闭
智能大对象日志记录

GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 414 -

标记

缺省值
描述
有关更多信息,请参阅 GBase
8s 管理员指南 中
的 数据存储和记录 一章中的 智能大对象。 有
关 onspaces
-ch 消息的信息,请参阅 数据库服
务器日志中的消息
EXTENT_SIZE 4 到 2**31 无
指定创建表时首次分配给存储在 sbspace 中的
智能大对象的磁盘空间的大小(千字节)
让系统选择 EXTENT_SIZE 值。
为减少智能大对象
中 extent 的数量,请使用
mi_lo_specset_estbytes (DataBlade API) 或
ifx_lo_specset_estbytes (GBase 8s ESQL/C)
对系统指示智能大对象的大小合计。系统尝试向
智能大对象分配单个 extent。
有关更多信息,请参阅GBase
8s 管理员指南中的
数据存储在哪里 一章中的 智能大对象。有关更
改智能大对象存储特征的信息,请参阅 GBase
8s
DataBlade API 程序员指南 或 GBase 8s ESQL/C
程序员手册。
MIN_EXT_SIZE 2 到 2**31 Windows :
4UNIX: 2
指定分配给每个智能大对象的最小空间量(千字
节)
将显示以下信息:正在更改 sbspace 最小
extent 大小:旧值 value1 新值value2 。
有关调整该值的信息,请参阅 GBase 8s 性能指
南 中的 在 I/O 利用率上的配置影响 一章中的
智能大对象。有关 onspaces -ch 消息的信息,
请参阅 数据库服务器日志中的消息
NEXT_SIZE
4 到 2**31 无
指定当前 sbspace 中初始 extent 已满时,
下次
分配给智能大对象的磁盘空间 extent 大小(千

GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 415 -

标记

缺省值
描述
字节)
让系统选择 NEXT_SIZE 值。
要减少智能大
对象中 extent 的数量,请使用
mi_lo_specset_estbytes 或
ifx_lo_specset_estbytes 对系统指示智能大对
象的大小合计。系统尝试向智能大对象分配单个
extent。
有关更多信息,请参阅 GBase
8s 管理员指南 中
的 数据存储在哪里 一章中的 智能大对象。
有关
获取智能大对象大小的信息,请参阅 GBase 8s
DataBlade API 程序员指南 或 GBase 8s ESQL/C
程序员手册。

以下示例使用以下规范创建 20 兆字节的镜像 sbspace(eg_sbsp):
主 chunk 和镜像 chunk 的偏移量为 500 千字节
元数据区域的偏移量为 200 千字节
平均期望智能大对象大小为 32 千字节
将更改记录到 sbspace 的用户数据区域中的智能大对象中
仅限于 UNIX:
% onspaces -c -S eg_sbsp -p /dev/raw_dev1 -o 500 -s 20000
-m /dev/raw_dev2 500 -Mo 200 -Df "AVG_LO_SIZE=32,LOGGING=ON"
更改 -Df 设置
作为数据库服务器管理员,您可以使用下列方法之一重设或更改 -Df 设置:
要更改 sbspace 的缺省值设置,使用 onspaces -ch 选项。有关更多信息,请参阅 onspaces
-ch: 更改 sbspace 缺省规范。
要重设特定表的以下 -Df 缺省设置,请使用 SQL 语句 CREATE TABLE 或 ALTER
TABLE:
l LOGGING
l ACCESSTIME
l EXTENT_SIZE
l NEXT_SIZE
有关 ALTER TABLE 和 CREATE TABLE 语句的更多信息,请参阅 《GBase 8s SQL 指
南:语法》。

GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 416 -

程序员可以使用 DataBlade API 和 GBase 8s ESQL/C 函数重设这些 -Df 缺省设置。有关
智能大对象的存储特征的信息,请参阅 GBase 8s DataBlade API 程序员指南 和 GBase 8s
ESQL/C 程序员手册。
使用 onspaces -g 选项
onspaces -g 选项不用于 sbspace 。数据库服务器对于 sbspace 使用不同于 blobspace 的另
一种方法确定 I/O 操作中要传送的页数。数据库服务器可以自动确定在智能大对象的 I/O
操作中的传送的 chunk 大小。
有关更多信息,
请参阅 GBase 8s 性能指南 中 I/O 活动 一
章中的 sbspace extent 大小。
该命令有等同的 SQL 管理 API 命令。

功能
将gcChangeInfo.xml 中指定数据节点添加到VC 或RC 中。集群安装成功后会自动
调用此命令,将安装成功的数据节点添加到集群中,而无需用户手动执行addnodes
命令。执行成功后再次调用该命令将会报错退出,提示用户节点已添加到集群。
注意
该命令为系统内部命令,系统在安装集群后会自动调用,不建议用户使用。
语法
gcadmin addnodes gcChangeInfo.xml [vc_name | single_vc_add_to_rc]
表4- 15 参数说明
参数名称


gcChangeInfo.xml
gcChangeInfo.xml 为要添加的数据节点信息,其中仅需包含一
即可,
使用多个rack 指定多个节点信息与一个rack 指
定所有节点信息效果相同。集群安装成功后会生成该文件,并
使用该文件自动调用addnodes 命令。
vc_name
指定vc name 则将节点添加到该vc 中。
single_vc_add_to_rc
在兼容模式下,将新增节点添加到RootCluster 中作为
freenoede。
示例
步骤1:修改gcChangeInfo.xml 文件:
$ cat gcChangeInfo.xml






步骤2:将freenode 添加到vc1 中:
$ gcadmin addnodes gcChangeInfo.xml vc1
gcadmin add nodes ...

GBase 8a MPP Cluster 产品手册
4 管理员指南
文档版本953(2022-09-15)
南大通用数据技术股份有限公司
182
flush statemachine success
gcadmin addnodes to vc [vc1] success
添加后,集群状态信息如下:
$ gcadmin showcluster vc vc1
CLUSTER STATE:
ACTIVE
VIRTUAL CLUSTER MODE:
NORMAL
===============================================
|
GBASE VIRTUAL CLUSTER INFORMATION
|
===============================================
|
VcName
| DistributionId |
comment
|
-----------------------------------------------
|
vc1
|
1
| vc1comments |
-----------------------------------------------
==========================================================================
======
|
VIRTUAL CLUSTER DATA NODE INFORMATION
|
==========================================================================
======
| NodeName |
IpAddress
| DistributionId | gnode | syncserver | DataState |
--------------------------------------------------------------------------------
|
node1
|172.168.83.11
|
1
| OPEN
|
OPEN
|
0
|
--------------------------------------------------------------------------------
|
node2
|172.168.83.12
|
1
| OPEN
|
OPEN
|
0
|
--------------------------------------------------------------------------------
|
node3
|172.168.83.15
|
| OPEN
|
OPEN
|
0
|
3 data node