CREATE LS

描述

该语句用于创建一个用户日志流。

使用限制及注意事项

• 对于 V4.2.5 版本，V4.2.5 BP2 及以上版本支持创建日志流操作。

• 在 V4.x 之前版本中，OceanBase 数据库仅支持租户的同构 Zone 模式。在 V4.2.5 版本中，从 V4.2.5 BP5 版本开始支持租户的异构 Zone 模式。其中：

  • 同构 Zone 模式下，需要通过指定 Unit Group 来创建日志流。
  • 异构 Zone 模式下，需要通过指定 UNIT_LIST 来创建日志流。

  有关同构 Zone 模式和异构 Zone 模式的详细区别，参见 数据分布。

• 当前仅支持创建普通的用户日志流，不支持创建广播日志流。

• 创建日志流操作仅支持在主租户上完成。且待创建日志流的租户的 STATUS 和 SWITCHOVER_STATUS 需要为 NORMAL。

• 创建日志流时：

  • 同构 Zone 模式下，要求目标 UNIT_GROUP 的状态必须为 ACTIVE，且视图 DBA_OB_UNITS 中目标 UNIT_GROUP_ID 的值不能为 0。
  • 异构 Zone 模式下，要求目标 UNIT_LIST 的状态必须为 ACTIVE，且指定的目标 UNIT_LIST 不能为空。

• 为待创建的日志流指定 PRIMARY_ZONE 时，需要保证指定的 Zone 在租户的 ZONE_LIST 中。对于日志流而言，设置日志流的 PRIMARY_ZONE 与设置租户的 PRIMARY_ZONE 略有不同，日志流仅允许设置一个 Zone，例如 z1 或z2，不能像租户一样设置 z1,z2、z1; z2 或 RANDOM。

• 负载均衡相关的配置项建议为关闭状态，即值为 False，否则：

  • 当租户级配置项 enable_rebalance 为开启状态，即值为 True 时，创建的日志流会被系统从目标 UNIT_GROUP 中迁移到其他 UNIT_GROUP 中。

  • 当租户级配置项 enable_transfer 为开启状态，即值为 True 时，创建的日志流可能会被删除。

权限要求

执行该语句的用户需要拥有 ALTER SYSTEM 权限。有关 OceanBase 数据库权限的详细介绍，请参见 MySQL 模式下的权限分类 和 Oracle 模式下的权限分类。

语法

ALTER SYSTEM CREATE LS
    {UNIT_GROUP [=] unit_group_id} | {UNIT_LIST [=] (unit_id_list) }
    [,PRIMARY_ZONE [=] 'zone_name'] 
    [TENANT [=] 'tenant_name'];

参数说明

示例

相关文档

有关创建日志流的详细操作，参见 创建日志流。