返回首页

gbase数据、南大通用产品文档:GBase8sdefragment 参数:

更新日期:2024年09月11日

动态地对分区 extent 取消
分片(SQL 管理 API)
随同 admin() 或 task() 函数,
使用 defragment 参数来对表或索引取消分片以合并不相
邻的 extent。
对表取消分片使得数据行离得更近,以避免分区标题页移除问题,并可提高性能。
在对分区取消分片之前,您应回顾对分区取消分段。
语法
使用下列语法,您或可指定 defragment 参数,或可指定 defragment partnum 参数:



GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 729 -
元素
描述
关键考虑
database
包括您想要取消分片的表或索
引的数据库名。

owner
表所有者的用户 ID。

table
要取消分片的表名。

partition_number
要取消分片的一个或多个分区
号。
要指定多于一个分区,请使用逗号分
隔的分区号列表。

用法
使用 defragment 参数来对特定的表取消分片。使用 defragment partnum 参数来对一个
或多个磁盘分区取消分片。
关于取消分片的信息存储在共享内存中。使用 oncheck -pt 和 -pT:显示表或分片的
tblspaces 命令来显示关于特定的表或分片的 extent 数目信息。使用 onstat -g
defragment 命令:打印磁盘碎片整理的分区 extent 。
如果取消分片需要减少 extent 的数目,减少最少 1
extent,则需要返回 0(成功),即
使在分区中有许多 extent。
如果分区有单个 extent,则取消分片需要返回 0 来表明需要成功,即使无 extent 合并。

示例
要对 stores_demo 数据库中的 customer 表取消分片,请使用下列函数之一:
EXECUTE FUNCTION task("defragment","stores_demo:gbasedbt.customer");
EXECUTE FUNCTION admin("defragment","stores_demo:gbasedbt.customer");
要对索引取消分片,您必须指定该索引的分区号,如这两个函数示例所示:
EXECUTE FUNCTION task("defragment partnum","2097154");
EXECUTE FUNCTION admin("defragment partnum","2097154");
要对分区列表取消分片,请使用下列函数之一:
EXECUTE FUNCTION task("defragment partnum", "16777217,28477346");
EXECUTE FUNCTION admin("defragment partnum", "16777217,28477346");

功能说明
用于错误数据与溯源信息检索。
语法格式
SHOW [ GCLUSTER ] LOAD LOGS task_id LIMIT {[offset,] row_count};
表5- 148 参数说明
字段名称
含义说明
GCLUSTER
可选参数,
增加这个参数显示全部coordinator 节点上的信
息。
Task_id
要追溯的加载任务的进程id。
offset
信息起始。
Row_count
记录条数。
表5- 149 查询结果信息表定义
字段名称
含义说明
TASK_ID
加载ID
DB_NAME
加载库名
TB_NAME
加载表名
ERR_DATA_IP
产生错误数据的节点IP
FILE_NAME
加载文件名
FILE_OFFSET
错误数据偏移量
RECORD_LEN
错误数据行长
ERR_COLUMN
错误数据列号
ERR_REASON
错误数据具体原因
ERR_DATA
错误数据

GBase 8a MPP Cluster 产品手册
5 数据库管理指南
文档版本953(2022-04-10)
南大通用数据技术股份有限公司
1187
说明

show 语法查询默认是返回offset 从0 到length 10 的10 条错误数据
与溯源信息查询,如果想查询更多的数据可以调整offset,length。

show 语法查询当前coordinator 节点错误数据与溯源信息进行检
索,使用show load logs task_id limit offset, row_count 进行查询,返
回row_count 条查询结果。

查询所有coordinator 节点错误数据与溯源信息进行检索,
使用show
gcluster load logs task_id limit offset, row_count 进行查询,返回
row_count 条查询结果。

ERR_DATA 的长度定义为4096 个字节。可以涵盖绝大多数场景,
对于超过长度的错误数据,显示时做截断处理,实际读取4096 个
字节。

show 查询功能,只能查询当前汇总目录内的加载错误数据与溯源
信息。即如果用户对gbase_loader_logs_dir 做了变更后,将查询不
到原指定目录中的数据。

Show 语法增加用户查询权限控制功能,默认仅能查询当前用户指
定加载任务的错误数据与溯源信息,有process 权限的用户可以查
询其他用户指定加载任务的错误数据与溯源信息。
例如:
show load logs 100
显示task_id 100 任务的前10 条错误数据信息
show load logs 100 limit 5
显示task_id 100 任务的前5 条错误数据信息
show load logs 100 limit 0,5 显示task_id 100 任务的前5 条错误数据信息
show load logs 100 limit 1,5 显示task_id 100 任务的从第1 条开始的后面5 条错误
数据信息
show gcluster load logs 101 显示所有coordinator 节点上task_id 101 任务的前10
条错误数据信息
示例

示例1:查询task_id 为131076 次加载的前10 条错误数据与溯源信息。
show load logs 131076;
图5- 4 所示

GBase 8a MPP Cluster 产品手册
5 数据库管理指南
文档版本953(2022-04-10)
南大通用数据技术股份有限公司
1188

示例2:查询task_id 为131076 次加载的第1506750 条开始的后5 条错误数
据相关信息。
图5- 5 所示

client_min_messages
参数说明:
控制发送到客户端的消息级别。
每个级别都包含排在它后面的所有级别中的
信息。级别越低,发送给客户端的消息就越少。
该参数属于USERSET 类型参数,请参考表15-1 中对应设置方法进行设置。
须知:
当client_min_messages 和log_min_messages 取相同值时,其值所代表的级别不同。
取值范围:枚举类型,有效值有debug、debug5、debug4、debug3、debug2、debug1、
info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表15-1。在实际设
置过程中,如果设置的级别大于error,为fatal 或panic,系统会默认将级别转为error。
默认值:notice