创建表

您可以使用 CREATE TABLE 语句来创建表。

本节主要介绍非分区表的创建，分区表的创建及使用请参见 创建分区表。

创建非分区表

创建非分区表是指创建只有一个分区的表。

创建非分区表的示例语句如下：

obclient> CREATE TABLE table_name1(w_id int,
w_ytd decimal(12,2),
w_tax decimal(4,4),
w_name varchar(10),
w_street_1 varchar(20),
w_street_2 varchar(20),
w_city varchar(20),
w_state char(2),
w_zip char(9),
unique(w_name, w_city),
primary key(w_id)
);

obclient> CREATE TABLE table_name2 (c_w_id int NOT NULL,
c_d_id int NOT null,
c_id int NOT null,
c_discount decimal(4, 4),
c_credit char(2),
c_last varchar(16),
c_first varchar(16),
c_middle char(2),
c_balance decimal(12, 2),
c_ytd_payment decimal(12, 2),
c_payment_cnt int,
c_credit_lim decimal(12, 2),
c_street_1 varchar(20),
c_street_2 varchar(20),
c_city varchar(20),
c_state char(2),
c_zip char(9),
c_phone char(16),
c_since date,
c_delivery_cnt int,
c_data varchar(500),
FOREIGN KEY (c_w_id) REFERENCES table_name1(w_id),
primary key (c_w_id, c_d_id, c_id)
);

示例中创建了 2 个表，并同时对表中的列定义了一些约束信息，包括在不同列上创建的主键和外键等。更多主键、外键等的介绍，请参见 定义列的约束类型。

创建表的列时请选择正确的数据类型，有关 SQL 数据类型的详细描述，请参见 数据类型。

创建复制表

复制表是 OceanBase 数据库中的一种特殊表结构，支持在任意一个副本读取数据的最新修改，适合于对写入频率要求较低，读延时和读负载均衡要求较高的场景。

在创建复制表之后，该表的副本会分布在租户下的所有 OBServer 节点上。这些副本中，有一个被选为 Leader，可以接受读写请求，而其他副本只能接受读请求。

复制表功能在 OceanBase 数据库 V3.x 版本上就已经存在，而对于 V4.x 版本，由于 OceanBase 数据库的架构有了比较大的变化，V4.x 复制表为了适应单机日志流的新架构，构建了基于分区的可读版本号校验以及基于日志流的 Lease 授予机制，用于保证强一致性读的正确性。

另外，V4.x 版本的复制表功能完善了切主不 Kill 事务的能力，在用户或负载均衡发起 Leader 切换时，未提交的复制表事务不会像 V3.x 版本一样无法继续，而是可以在切主后继续执行。对比 V3.x 版本，V4.x 的复制表功能也有着更好的写事务性能和更强的容灾能力，副本宕机对于读操作的影响更低。

复制表使用限制

• 复制表：

  • 创建复制表限制：sys 租户、meta 租户没有广播日志流，不支持创建复制表。

  • 写入性能受节点数影响：因为复制表写，需要同步到所有副本，所以节点数量越大，对写入性能影响越大。

    • 规避方式：尽量避免复制表的写跟读在同一个事务，复制表事务的纯写或者纯读都没问题。

  • 属性转换：

    • 复制表与 TableGroup 互斥，修改复制表的 TableGroup 属性会报错；普通表转为复制表时，如果普通表属于某个 TableGroup，属性变更命令将报错。
    • 复制表转换依赖负载均衡及 transfer，需要保证相关配置项是打开状态。

  • 路由：

    • 事务中有复制表的写操作，之后查询复制表，如果随机路由到 follower，会遇到副本不可读的问题，observer 内部二次转发到复制表的 Leader，影响查询性能。

      • ODP V4.3.3 已调整路由策略，如果有复制表的写操作，后续查询路由到复制表的 Leader。

    • 复制表 JOIN 普通表的查询操作，会按照复制表去随机路由（对 JOIN 查询，ODP 是按照第一张表路由），此时可能会路由到普通表的非 Leader 节点，导致出现远程计划。

    • 普通表属性变更为复制表，ODP 无法感知，不能按照复制表路由分摊压力。

  • 事务内，有复制表做过变更，后续的查询操作：查询复制表时，生成的执行计划会选择本地副本，但是因为做过变更，会报副本不可读的错误，SQL 重试选择 Leader 副本，此时 plan cache 无法命中，导致查询性能差。

• 广播日志流：

  • 每个用户租户最多只能有一个广播日志流。
  • 不支持广播日志流和普通日志流之间的属性转换。
  • 不支持手动删除广播日志流，目前随着租户删除而删除。

创建复制表语法

创建复制表的语法是在 CREATE TABLE 语句后增加 DUPLICATE_SCOPE 选项，仅用户租户可以创建复制表，sys 租户无法创建复制表。创建复制表的 SQL 语句如下：

CREATE TABLE table_name column_definition DUPLICATE_SCOPE='none | cluster';

其中，DUPLICATE_SCOPE 参数用来指定复制表的属性，取值如下：

• none：表示该表是一个普通表。
• cluster：表示该表是一个复制表，Leader 需要将事务复制到当前租户的所有 F 副本及 R 副本。

创建表时，如果不指定 DUPLICATE_SCOPE，则默认值为 none。

CREATE TABLE dup_t1 (c1 NUMBER,c2 NUMBER) DUPLICATE_SCOPE= 'cluster';

当某个租户的第一个复制表被创建时，系统会同时创建一个特殊的日志流——广播日志流。之后新建的复制表都会创建到广播日志流上。广播日志流与普通日志流的不同之处在于，广播日志流会自动地在租户内的每个 OBServer 节点上都部署一个副本，保证在理想情况下，复制表可以在任意一个 OBServer 节点上提供强一致性读。您可以通过以下 SQL 查看租户的复制表所在的广播日志流：

SELECT * FROM SYS.DBA_OB_LS WHERE flag LIKE "%DUPLICATE%";

查询结果的示例如下。

+-------+--------+--------------+---------------+-------------+---------------------+----------+---------------------+---------------------+-----------+
| LS_ID | STATUS | PRIMARY_ZONE | UNIT_GROUP_ID | LS_GROUP_ID | CREATE_SCN          | DROP_SCN | SYNC_SCN            | READABLE_SCN        | FLAG      |
+-------+--------+--------------+---------------+-------------+---------------------+----------+---------------------+---------------------+-----------+
|  1003 | NORMAL | z1;z2        |             0 |           0 | 1684982852976428261 |     NULL | 1684983282912048623 | 1684983282912048623 | DUPLICATE |
+-------+--------+--------------+---------------+-------------+---------------------+----------+---------------------+---------------------+-----------+
1 rows in set

示例中，LS_ID 为 1003 的日志流即为广播日志流，当前租户的所有复制表都创建在该日志流上。有关广播日志流的更多介绍，请参见 副本介绍。

复制表创建成功后，可以与普通表一样进行插入和读写操作。不同的是，如果使用 Proxy 连接数据库，则读请求会路由到任意一个 OBServer 节点执行，而普通表只能将读请求路由到 Leader 节点执行。如果是通过直连方式连接数据库，则只要本地副本可读，系统就会在直连的 OBServer 节点上执行读请求。更多关于 Proxy 路由规则的介绍，请参见 连强读分区表路由。

复制已有表的数据创建新表

通过 CREATE TABLE AS SELECT 语句复制表的基本数据类型和数据，但不包含约束、索引和非空等属性。

示例语句如下：

CREATE TABLE t2_copy AS SELECT * FROM t2;

不支持使用 CREATE TABLE LIKE 语句复制表结构。