gbase数据、南大通用产品文档：GBase8slvarchar 指针和 var binary 库函数

下列库函数在 GBase 8s ESQL/C 中可用与范围 lvarchar 指针或 var binary 主机变
量的数据缓冲区。

函数名
意义
请参阅
ifx_var_alloc()
为数据缓冲区分配内存。
ifx_var_alloc() 函数
ifx_var_dealloc(
)
释放数据缓冲区的内存。
ifx_var_dealloc() 函
数
ifx_var_flag()
确定是 ESQL/C 还是应用程序处理数
据缓冲区的内存分配。
ifx_var_flag() 函数
ifx_var_getdata(
)
返回数据缓冲区的内容。
ifx_var_getdata() 函
数
ifx_var_getlen()
返回数据缓冲区的长度。
ifx_var_getlen() 函
数
ifx_var_isnull()
检查数据缓冲区中的数据是否为空。
ifx_var_isnull() 函
数
ifx_var_setdata(
)
设置数据缓冲区的数据。
ifx_var_setdata() 函
数
ifx_var_setlen()
设置数据缓冲区的长度。
ifx_var_setlen() 函
数
ifx_var_setnull(
)
将数据缓冲区中的数据设置为空值。
ifx_var_setnull() 函
数

这些 lvarchar 指针和 var binary 还是在 sqlhdr.h 头文件中定义，
因此您不需要在您
的使用它们的 GBase 8s ESQL/C 程序中包含特定的头文件。

GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 281 -

语法:

使用 onspaces -a 可向 sbspace 添加 chunk 。
元素
用途
关键注意事项
-a
指示要添加的 chunk
一个实例中至多包含 32766 个 chunk 。可
以将所有的这些 chunk 放置到一个存储空
间或分割在多个存储空间中
-m pathname
offset
指定镜像新 chunk 的
chunk 的可选路径名和偏
移量。另见此表中的
pathname 和 offset 条目
有关背景信息，请参阅 GBase 8s 管理员指
南 中的 管理磁盘空间 一章中的 向
sbspace 添加 chunk
-Mo mdoffset 指示应存储元数据的磁盘
空间或设备中的偏移量
（千
字节）
值可以是 0 到 chunk 大小之间的整数。您
不能指定导致元数据空间结束处超过 chunk
结束处的偏移量。

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

元素
用途
关键注意事项
有关背景信息，请参阅 GBase 8s 管理员指
南 中的 管理磁盘空间 一章中的 缩放
sbspace 元数据的大小
-Ms mdsize
指定在初始 chunk 中分配
的元数据区域的大小
（千字
节）。剩下的是用户数据空
间
值可以是 0 到 chunk 大小之间的整数。
有关背景信息，请参阅 GBase 8s 管理员指
南中的 管理磁盘空间 一章中的 缩放
sbspace 元数据的大小
-o offset
在 -a 选项之后，offset
指示为到达新 blobspace
或 dbspace 的初始 chunk
所发生的磁盘分区或未缓
冲设备中的偏移量（千字
节）
无符号整数。开始偏移量必须大于等于 0 。
开始偏移量加 chunk 大小不能超过最大
chunk 大小。最大偏移量为 2 或 4 千兆字
节，这与平台有关。
有关更多消息，请参阅 GBase 8s 管理员指
南 中的 管理磁盘空间 一章中的 在UNIX™
上分配原始磁盘空间
-p pathname
指示正在创建的 sbspace
初始 chunk 的磁盘分区或
未缓冲设备。
Chunk 必须是现有的未缓
冲设备或已缓冲文件
Chunk 名最多可以有 128 字节。
指定路径名
时，可以使用完整路径名或相对路径名。然
而，如果使用相对路径名，这必须相对于是
初始化数据库服务器的当前目录的目录。
有关路径名语法，请参阅操作系统文档
-U
指定应将整 chunk 用于存
储用户数据
-M 和 -U 选项是互斥的。
有关背景信息，
请参阅GBase
8s 管理员指南
中的管理磁盘空间一章中的 向 sbspace 添
加 chunk
-s size
指定新 sbspace chunk 的
大小（千字节）
无符号整数。大小必须等于或大于 1000 字
节，并且必须是页大小的倍数。开始偏移量

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

元素
用途
关键注意事项
加 chunk 大小不能超过最大 chunk 大小。
最大偏移量是 4 太字节
sbspace
给出 chunk 将添加至的
sbspace 的名称
请参阅GBase 8s 管理员指南 中的管理磁盘
空间一章中的 向 sbspace 添加 chunk 。
语法必须符合 Identifier 段；请参阅
《GBase 8s SQL 指南：语法》。

该命令有等同的 SQL 管理 API 命令。

checkpoint_segments
参数说明：设置checkpoint_timeout 周期内所保留的最少WAL 日志段文件数量。每个
日志文件大小为16MB。
该参数属于SIGHUP 类型参数，请参考表15-1 中对应设置方法进行设置。
取值范围：整型，最小值1
提升此参数可加快大数据的导入速度，但需要结合checkpoint_timeout、shared_buffers
这两个参数统一考虑。这个参数同时影响WAL 日志段文件复用数量，通常情况下pg_xlog
文件夹下最大的复用文件个数为2 倍的checkpoint_segments 个，复用的文件被改名为后续
即将使用的WAL 日志段文件，不会被真正删除。
默认值：64

GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
1204