gbase数据、南大通用产品文档：GBase8c配置设置函数

配置设置函数是可以用于查询以及修改运行时配置参数的函数。

current_setting(setting_name)
描述：当前的设置值。
返回值类型：text
备注：current_setting 用于以查询形式获取setting_name 的当前值。和SQL 语句SHOW
是等效的。比如：
gbase=# SELECT current_setting('datestyle');
current_setting
-----------------
ISO, MDY
(1 row)

set_working_grand_version_num_manually(tmp_version)
描述：通过切换授权版本号来更新和升级数据库的新特性。
返回值类型：void

shell_in(type)
描述：为shell 类型输入路由（那些尚未填充的类型）
。
返回值类型：void

shell_out(type)
描述：为shell 类型输出路由（那些尚未填充的类型）
。

GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
436
返回值类型：void

set_config(setting_name, new_value, is_local)
描述：设置参数并返回新值。
返回值类型：text
备注：
set_config 将参数setting_name 设置为new_value。
如果is_local 为true，
则new_value
将只应用于当前事务。如果希望new_value 应用于当前会话，可以使用false，和SQL 语句
SET 是等效的。例如：
gbase=# SELECT set_config('log_statement_stats', 'off', false);
set_config
------------
off
(1 row)

使用 LOGFILES 配置参数来指定在磁盘初始化期间数据库服务器创建的逻辑日志文件的数
目。
onconfig.std 值
LOGFILES 6
值
3 - 32,767（仅整数）
单位
逻辑日志文件的数目
生效
磁盘初始化期间且当您添加新的日志文件时。
您使用 onparms 实用程序之一添加一个新日
志。
用法
要更改逻辑日志文件的数目，请添加或删除逻辑日志文件。

GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 99 -
如果您使用 onparams 来添加或删除日志文件，则数据库服务器自动地更新 LOGFILES。

GBase 8s数据库安装手册
南大通用数据技术股份有限公司
20
指定要从表中开始捕获的数据。
如果捕获会话处于打开状态且处于活动状态（您已经运行了
cdc_activatesess() 函数），则数据捕获将立即在指定表中的指定列上开始。
否则，数据捕获将在激活打开捕获会话时开始。
运行此函数时，
DB_LOCALE 环境变量必须设置为与数据库区域设置相同的区
域设置。
将在与指定会话ID 和表关联的syscdctab 表中添加一行。
语法：
cdc_startcapture (
session_ID
,
MBZ
,
“database:owner.table_name"
,
"
column_name[, column_name] "
,
user_data )
参数：
表2-9.cdc_startcapture() 参数
参数
数据类型
描述
session_ID
INTEGER
The session ID of an open capture
session.
MBZ
BIGNIT
Must be 0. Reserved.
database:owner.table_name
LVARCHAR
The qualified name of the table
from which to capture data. The
qualified name includes the
following elements:
database The name of the
database in which the
table exists.
owner
The name of the
owner of the table.
table
The name of the
table.
column_name
LVARCHAR
A comma-separated list of
column names in the specified

GBase 8s数据库安装手册
南大通用数据技术股份有限公司
21
table, from which to capture
data.
user_data
INTEGER
The table identifier.
用法：
使用cdc_startcapture() 函数指定一个表和该表中的列，
从中开始捕获数
据。不能包含具有简单大型对象、用户定义数据类型或集合数据类型的列。
表标识符是应用程序中用于唯一标识将参与数据捕获的每个表的数字。
必须从客户端应用程序调用此函数。不能从数据库服务器中运行的用户定
义例程调用此函数。
返回值：
如果成功，则返回0。
如果不成功，则返回与错误代码相对应的整数，并使用错误信息更新
syscdcess 表。
3 更改数据捕获记录
本章节描述从打开的捕获会话读取函数的调用返回的CDC 记录。
CDC 记录格式
变更数据捕获（CDC）记录包含所有记录共有的标题，之后是CDC 记录类型
的特定标题。
CDC_REC_INSERT、CDC_REC_DELETE、CDC_REC_UPDBEF 和CDC_REC_UPDAFT
记录也包含列数据。
所有CDC 记录共用的标题描述了CDC 记录的大小和类型。
表3-1.所有CDC 记录公共消息头信息
区分
长度
描述
Header size
4 bytes
The number of bytes in the common and
CDC record-specific headers.

GBase 8s数据库安装手册
南大通用数据技术股份有限公司
22
Payload size
4 bytes
The number of bytes of data in the
record
after
the
common
and
CDC
record-specific headers.
Packet scheme
4 bytes
The packetization scheme number of
one of the packetization schemes
contained in the syscdcpacketschemes
table. The only packetization scheme is
66, CDC_PKTSCHEME_LRECBINARY.
Record number
4 bytes
The record number of one of the CDC
records contained in the syscdcrectypes
table.