更新日期：2024年09月11日
摘要：
将完整的结果集检索到客户端。以便后续的gbase_stmt_fetch()调用能返
回缓冲数据。
语法：
int gbase_stmt_store_result(GBASE_STMT *stmt);
参数：
返回值：
如果成功完成了对结果的缓冲处理，返回0。如果出现错误，返回非0 值。
错误
CR_COMMANDS_OUT_OF_SYNC
以不恰当的顺序执行了命令。
CR_OUT_OF_MEMORY
内存溢出。
CR_SERVER_GONE_ERROR
GBase 服务器不可用。
CR_SERVER_LOST
在查询过程中，与服务器的连接丢失。
CR_UNKNOWN_ERROR
出现未知错误。
GBase 8a 程序员手册C API 篇
- 70 -
南大通用数据技术股份有限公司
5 GBase C API 应用示例
在包含至少一台共享磁盘（SD）辅助服务器的高可用性集群中，当发生流量控制时指定。
onconfig.std 值
SDS_FLOW_CONTROL 0
值
0 = 当当前日志位置与最近响应日志之间的差异超过日志缓冲区大小的 12 倍时，激活流
量控制。
-1 = 禁用流量控制。禁用流量控制可能导致日志文件的交换和数据丢失。
GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 133 -
start_value,end_value = start_value 和 end_value 确定当前日志位置与最后响应日志
页之间的滞后量。start_value 必须大于 end_value。这些值必须包括下列单位之一：
l K（KB）
l M（MB）
l G（GB）
例如，设置 SDS_FLOW_CONTROL
128M,100M，当日志之间的滞后为 128
MB 时启动流量控制，
当滞后降至 100 MB 时停止流量控制。
生效
编辑 onconfig 文件并重启数据库服务器之后。
当您通过运行 onmode -wf 命令在 onconfig 文件中动态地重置该值时。
用法
流量控制提供一种限制主服务器上日志活动的方法，以便集群中的 SD 辅助服务器不在处
理事务上落后太远。当启用流量控制时，且当当前日志位置与最后响应日志页之间日志大
小的差异超过 start_value 时，
主服务器上的日志活动受到限制。
当流量控制是活动的时，
连接到主服务器的用户可感觉到响应时间变慢。
当日志之间的滞后大于 start_value 时启
动流量控制，当日志滞后降至 stop_value 时停止流量控制。
仅在主服务器上设置 SDS_FLOW_CONTROL 配置参数。集群中的所有 SD 辅助服务器都受到
SDS_FLOW_CONTROL 配置参数的影响。日志通常按照被接收的顺序发送到 SD 辅助服务器。
您必须对数据库使用事务日志记录以利用需要日志记录的数据库服务器进程中所列的所有
功能。
数据库服务器管理的每个数据库均有日志记录状态。日志记录状态指示数据库是否使用事
务日志记录以及（如果使用）数据库运用哪一种日志缓冲机制。要查明数据库的事务日志
记录状态，请按监视数据库的日志记录方式中的说明，使用数据库服务器实用程序。数据
库日志记录状态将指示下列日志记录类型中的任意一种：
未缓冲的事务日志记录
已缓冲的事务日志记录
符合 ANSI 的事务日志记录
无日志记录
所有逻辑日志记录在数据库服务器将其写入磁盘上的逻辑日志之前，均经过共享内存中的
逻辑日志缓冲区。但是，数据库服务器清仓逻辑日志缓冲区的时刻对于已缓冲的事务日志
记录和未缓冲的事务日志记录是不同的。
GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 281 -
未缓冲的事务日志记录
如果事务是对使用未缓冲日志记录的数据库进行的，那么逻辑日志缓冲区中的记录可保证
在落实处理期间写入磁盘。当应用程序在 COMMIT 语句之后（对于分布式事务，在
PREPARE 语句之前）重获控制权时，逻辑日志记录在磁盘上。一旦落实缓冲区中的任何
事务（即，将落实记录写入逻辑日志缓冲区），数据库服务器就立即清仓记录。
当数据库服务器清仓缓冲区时，仅将已使用的页写入磁盘。已使用的页包含那些仅部分已
满的页，但这样就浪费了一些空间。由于这个原因，相比在同一数据库服务器上的所有数
据库均使用已缓冲的日志记录这种情况而言，磁盘上的逻辑日志文件会更快地填满。
未缓冲的日志记录对于大多数数据库而言是最好的选择，因为它保证所有已落实的事务可
得以恢复。在发生故障的情况下，仅丢失在发生故障时未落实的事务。但是，有了未缓冲
的日志记录，数据库服务器会更频繁地将逻辑日志缓冲区清仓到磁盘，而缓冲区将包含更
多部分已满的页，因此它比已缓冲的日志记录会更快地填充逻辑日志。
已缓冲的事务日志记录
如果事务是对使用已缓冲日志记录的数据库进行的，那么记录尽可能久地保留（已缓冲）
在逻辑日志缓冲区中。直至发生以下情况之一，这些记录才会从共享内存中的逻辑日志缓
冲区刷新到磁盘上的逻辑日志：
缓冲区已满。
具有未缓冲日志记录的数据库上的落实清空了缓冲区。
出现检查点。
连接关闭。
如果您使用已缓冲日志记录并且发生了故障，那么不能期望数据库服务器恢复那些在发生
故障时位于逻辑日志缓冲区中的事务。因此，可能会丢失一些已落实的事务。作为对该风
险的补偿，变更期间的性能会稍有提高。只要您在发生故障的情况下可重新创建更新，那
么已缓冲日志记录最适合用于频繁更新的数据库（这时更新速度很重要）。您可调整逻辑
日志缓冲区的大小以便为您的系统在性能和因系统故障而丢失事务的风险之间找到可接受
的平衡。
符合 ANSI 的事务日志记录
符合 ANSI 标准的数据库日志记录状态表明数据库所有者使用 MODE ANSI 关键字。符
合 ANSI 标准的数据库对事务处理强制执行 ANSI 规则，始终使用未缓冲的事务日志记
录。您无法更改符合 ANSI 标准的数据库的缓冲状态。
无数据库日志记录
如果您关闭了数据库的日志记录，那么将不记录事务，但会记录其他操作。有关更多信息，
请参阅 始终记录的活动。通常，当您要装入数据或仅运行查询时，将关闭数据库的日志记
录。
GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 282 -
如果您对恢复源感到满意，可以决定不对数据库使用事务日志记录，从而减少数据库服务
器处理量。例如，如果要将许多行从可恢复的源（如磁带或 ASCII 文件）装入数据库，那
么可能不需要事务日志记录，并且在不使用事务日志记录的情况下装入会进行得更快。但
是，如果其他用户在数据库中是活动的，那么您直到重新启动日志记录（这必须等待 0 级
备份）后才会拥有其事务的逻辑日志记录。
具有不同日志缓冲状态的数据库
数据库服务器上的所有数据库使用相同的逻辑日志和相同的逻辑日志缓冲区。因此，对具
有不同逻辑缓冲状态的各数据库的事务可写入相同的逻辑日志缓冲区。在这种情况下，如
果事务是对具有已缓冲日志记录的数据库和对具有未缓冲日志记录的数据库而存在的，那
么数据库服务器在缓冲区已满时或在具有未缓冲日志记录的数据库的事务完成时清空缓冲
区。
X/Open DTP 环境中的数据库日志记录
X/Open 分布式事务处理 (DTP) 环境中的数据库必须使用未缓冲日志记录。未缓冲日志记
录确保数据库服务器逻辑日志始终处于一致状态，并且可与事务管理器同步。如果在
X/Open DTP 环境中打开用已缓冲日志记录创建的数据库，数据库状态会自动更改为未缓
冲日志记录。
数据库服务器支持符合 ANSI 标准和不符合 ANSI 标准的数据库。
有关更多
信息，请参阅事务管理器。