CREATE CLUSTER TABLE

语法说明

集群表是指在系统租户下的系统库 mo_catalog 创建的表，该表会在其它租户下同时生效。系统租户下可对该表进行 DDL 与 DML 操作，其它租户只能进行查询或基于该表创建视图。

本篇文档将讲述如何在 MatrixOne 数据库建立集群表。

语法结构

> CREATE CLUSTER TABLE [IF NOT EXISTS] tbl_name
    (create_definition,...)
    [table_options]
    [partition_options]

使用说明

创建集群表仅限于 sys 租户管理员角色才能创建。
sys 租户的集群表包含所有数据，其它租户下可能只会看到部分数据。
在集群表中，account_id 字段是自动生成的，表示在插入或 LOAD DATA 时指定数据的可见租户的 id，每条数据只能选择一个可见租户，若您想多个租户都能查看该数据，需要多次插入指定不同租户 id，该字段数据在其它租户中查询不会返回。
集群表不能为外表或临时表，在所有租户下的表结构完全相同。

示例

--创建两个租户 test1 和 test2
mysql> create account test1 admin_name = 'root' identified by '111' open comment 'tenant_test';
Query OK, 0 rows affected (0.44 sec)

mysql> create account test2 admin_name = 'root' identified by '111' open comment 'tenant_test';
Query OK, 0 rows affected (0.51 sec)

--在 sys 租户下创建集群表
mysql> use mo_catalog;
Database changed
mysql> drop table if exists t1;
Query OK, 0 rows affected (0.00 sec)

mysql> create cluster table t1(a int);
Query OK, 0 rows affected (0.01 sec)

--查看租户 id
mysql> select * from mo_account;
+------------+--------------+--------+---------------------+----------------+---------+----------------+
| account_id | account_name | status | created_time        | comments       | version | suspended_time |
+------------+--------------+--------+---------------------+----------------+---------+----------------+
|          0 | sys          | open   | 2024-01-11 08:56:57 | system account |       1 | NULL           |
|          6 | test1        | open   | 2024-01-15 03:15:40 | tenant_test    |       7 | NULL           |
|          7 | test2        | open   | 2024-01-15 03:15:48 | tenant_test    |       8 | NULL           |
+------------+--------------+--------+---------------------+----------------+---------+----------------+
3 rows in set (0.01 sec)

--在集群表 t1 中插入数据只对 test1 租户可见
mysql> insert into t1 values(1,6),(2,6),(3,6);
Query OK, 3 rows affected (0.01 sec)

--在 sys 租户中查看 t1 的数据，可看到包含 `account_id` 字段在内的所有数据
mysql> select * from t1;
+------+------------+
| a    | account_id |
+------+------------+
|    1 |          6 |
|    2 |          6 |
|    3 |          6 |
+------+------------+
3 rows in set (0.00 sec)

--在 test1 租户中查看 t1 的数据，可以看到非 `account_id` 字段的数据
mysql> select * from t1;
+------+
| a    |
+------+
|    1 |
|    2 |
|    3 |
+------+
3 rows in set (0.01 sec)

--在 test2 租户中查看 t1 的数据，不会看到有数据
mysql> select * from t1;
Empty set (0.01 sec)

--在 test1 租户中创建基于 t1 的视图
mysql> create view t1_view as select * from mo_catalog.t1;
Query OK, 0 rows affected (0.01 sec)

mysql> select * from t1_view;
+------+
| a    |
+------+
|    1 |
|    2 |
|    3 |
+------+
3 rows in set (0.00 sec)

--在 test2 租户中创建基于 t1 的视图
mysql> create view t1_view as select * from mo_catalog.t1;
Query OK, 0 rows affected (0.01 sec)

mysql> select * from t1_view;
Empty set (0.01 sec)