add log 参数:添加新逻辑日志(SQL 管理 API)

随同 admin()task() 函数,使用 add log 参数来添加逻辑日志到 dbspace。

语法

元素 描述 关键考虑
after_current_flag 是在当前日志之后还是在最后的逻辑日志之后(缺省)添加新日志。 可能的值是:
  • 1 = 在当期日志之后添加新日志。
  • 0 = 在最后的日志之后添加新日志。
count 要创建的日志文件数。缺省是 1。 该数目必须不导致逻辑日志文件的总数目超过 32,767。
dbspace 要将逻辑日志文件插入其中的那个 dbspace 的名称。 仅当数据库服务器有足够的连续空间时,您才可添加日志文件到 dbspace。

您可在备份期间添加日志文件。

您不可添加日志文件到 blobspace 或 sbspace。

size 以 KB 为单位的新逻辑日志文件的大小。缺省是由 LOGSIZE 配置参数指定的大小。 这个值必须是一个大于或等于 200 KB 的无符号整数。

还请参阅 admin() 和 task() 参数大小规范

用法

新添加的日志文件有状态 A 且立即可用。使用 onstat -l 来查看逻辑日志文件的状态。运行这个函数之后,请尽快对包含该日志文件的 root dbspace 和 dbspace 进行 0 级备份。

缺省情况下,新日志文件被添加在最后的逻辑日志之后。请包括 1 作为第五个参数来将逻辑日志文件添加在当前日志文件之后。

这个函数类似于 onparams -a -d 命令,可添加单个的逻辑日志文件。然而,您可调用这个函数一次,添加多个逻辑日志文件到指定的 dbspace。

示例

下列示例中的命令在当前日志之后添加三个逻辑日志,每一个的大小都是 5 MB:

EXECUTE FUNCTION task ("add log","logdbs","5M",3,1);