CREATE CLUSTER TABLE

CREATE CLUSTER TABLE

语法说明

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

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

语法结构

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

使用说明

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

示例

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

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

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

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

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

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

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

43. --在 test1 租户中查看 t1 的数据，可以看到非`account_id`字段的数据
44. mysql> select * from t1;
45. +------+
46. | a    |
47. +------+
48. |    1 |
49. |    2 |
50. |    3 |
51. +------+
52. 3 rows in set (0.01 sec)

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

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

62. mysql> select * from t1_view;
63. +------+
64. | a    |
65. +------+
66. |    1 |
67. |    2 |
68. |    3 |
69. +------+
70. 3 rows in set (0.00 sec)

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

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