gbase数据、南大通用产品文档：GBase8a加载日志汇总与查询

日志汇总与查询功能，将一次加载的错误数据日志与溯源信息日志汇总至加载发
起节点，并提供相应的查询，检索日志的功能。本功能依赖表GNS 功能的开启。
通过变量gbase_loader_logs_dir 指定日志文件汇总路径，默认汇总至加载发起节
点的gcluster 日志目录($GCLUSTER_HOME/log/gcluster/)下的loader_logs 目录，
并在该路径下建一个以本次TASK_ID 命名的子文件夹，将汇总日志存放于该子
文件夹下。加载完成时，在该子文件夹下创建一个以TASK_ID_loader_result.log
命名的日志，并将本次加载的结果信息写入该日志文件。该变量支持set 方式修
改和配置文件方式修改。
图5- 2 日志文件汇总路径
通过变量gbase_loader_logs_collect 变更控制集群加载日志汇总功能的开关，有效
值[0,1]，默认值为1，表示开启汇总功能，该变量支持set 方式修改与配置文件方
式修改。
对于集群加载，如果gbase_loader_logs_collect 为1，错误数据与溯源信息汇总到
加载发起节点，并存储到gbase_loader_logs_dir 指定目录，否则不进行错误数据
与溯源信息日志的汇总。
注意

对于日志的命名，汇总功能不变更日志的文件名，遵循现有命名规则；

对于日志的个数，汇总功能也不对日志文件进行合并，即汇总功能只是将
各个数据加载节点产生的日志文件汇总至加载发起节点。
图5- 3 所示

GBase 8a MPP Cluster 产品手册
5 数据库管理指南
文档版本953（2022-09-15）
南大通用数据技术股份有限公司
1178

约束设计
DEFAULT 和NULL 约束

【建议】如果能够从业务层面补全字段值，那么，就不建议使用DEFAULT 约束，避
免数据加载时产生不符合预期的结果。

【建议】给明确不存在NULL 值的字段加上NOT NULL 约束，优化器会在特定场景下
对其进行自动优化。

【建议】给可以显式命名的约束显式命名。除了NOT NULL 和DEFAULT 约束外，其
他约束都可以显式命名。
局部聚簇
Partial Cluster Key（局部聚簇，简称PCK）是列存表的一种局部聚簇技术，在GBase 8c
中，使用PCK 可以通过min/max 稀疏索引实现事实表快速过滤扫描。PCK 的选取遵循以下
原则：

【关注】一张表上只能建立一个PCK，一个PCK 可以包含多列，但是一般不建议超过

GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
52
2 列。

【建议】在查询中的简单表达式过滤条件上创建PCK。这种过滤条件一般形如col op
const，其中col 为列名，op 为操作符=、>、>=、<=、<，const 为常量值。

【建议】在满足上面条件的前提下，选择distinct 值比较多的列上建PCK。
唯一约束

【关注】行存表、列存表均支持唯一约束。

【建议】从命名上明确标识唯一约束，例如，命名为“UNI+构成字段”。
主键约束

【关注】行存表、列存表均支持主键约束。

【建议】从命名上明确标识主键约束，例如，将主键约束命名为“PK+字段名”。
检查约束

【关注】行存表支持检查约束，而列存表不支持。

【建议】从命名上明确标识检查约束，例如，将检查约束命名为“CK+字段名”。

ifx_lo_stat() 函数返回关于打开的智能大对象的状态的信息。

语法
mint ifx_lo_stat(LO_fd, LO_stat)
mint LO_fd;
ifx_lo_stat_t **LO_stat;
LO_fd
表示您想要取得其状态信息的打开的智能大对象的 LO 文件描述符。
LO_stat
指向指向 ifx_lo_stat() 分配并以状态信息完成的 LO-status 结构的指针的指针。

用法

ifx_lo_stat() 函数分配 LO-status 结构 ifx_lo_stat_t，并以 LO_fd
文件描述符标识的智能大对象的状态信息初始化。要访问该状态信息，对于
LO-status 结构，请使用 GBase 8s ESQL/C 访问器函数。

请使用 ifx_lo_stat_free() 函数来释放 LO-status 结构。

返回代码
0
函数成功。

GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 799 -
<0
函数不成功，且返回值指示失败的原因。