MatrixOne 系统数据库和表

MatrixOne 系统数据库和表是 MatrixOne 存储系统信息的地方，你可以通过它们访问系统信息。MatrixOne 在初始化时创建了 6 个系统数据库：mo_catalog、information_schema、system_metrcis、system、mysql 和 mo_task。mo_task 当前正在开发中，暂时对你所进行的操作不会产生直接影响。本文档中描述了其他系统数据库和表函数。

系统只能修改系统数据库和表，你仅能从中进行读取操作。

`mo_catalog` 数据库

mo_catalog 用于存储 MatrixOne 对象的元数据，如：数据库、表、列、系统变量、租户、用户和角色。

从 MatrixOne 0.6 版本即引入了多租户的概念，默认的 sys 租户和其他租户的行为略有不同。服务于多租户管理的系统表 mo_account 仅对 sys 租户可见；其他租户看不到此表。

`mo_account` 表 (仅 `sys` 租户可见)

列属性	类型	描述
account_id	int unsigned	租户 ID，主键
account_name	varchar(100)	租户名
status	varchar(100)	开启/暂停/限制
created_time	timestamp	创建时间
comments	varchar(256)	注释
suspended_time	TIMESTAMP	修改租户状态的时间
version	bigint unsigned	当前租户版本状态

`mo_cdc_task` 表

列属性	类型	描述
account_id	BIGINT UNSIGNED(64)	租户 id
task_id	UUID(0)	任务 id
task_name	VARCHAR(1000)	任务名称
source_uri	TEXT(0)	上游 uri
source_password	VARCHAR(1000)	上游密码，加密显示
sink_uri	TEXT(0)	下游 uri
sink_type	VARCHAR(20)	下游类型
sink_password	VARCHAR(1000)	下游密码，加密显示
sink_ssl_ca_path	VARCHAR(65535)	下游 ca 证书路径
sink_ssl_cert_path	VARCHAR(65535)	下游 cert 证书路径
sink_ssl_key_path	VARCHAR(65535)	下游 ssl key 路径
tables	TEXT(0)	同步的表
filters	TEXT(0)	过滤的表
opfilters	TEXT(0)	过滤的操作
source_state	VARCHAR(20)	上游状态
sink_state	VARCHAR(20)	下游状态
start_ts	VARCHAR(1000)	拉取该时间点的数据开始同步
end_ts	VARCHAR(1000)	截止该时间点的数据结束同步
config_file	VARCHAR(65535)	配置文件路径
task_create_time	DATETIME(0)	任务创建时间
state	VARCHAR(20)	任务状态
checkpoint	BIGINT UNSIGNED(64)	检查点
checkpoint_str	VARCHAR(1000)	任务进度
no_full	BOOL(0)	是否全量同步
incr_config	VARCHAR(1000)	增量配置
additional_config	TEXT(0)	额外的配置
err_msg	VARCHAR(256)	错误信息

`mo_cdc_watermark` 表

列属性	类型	描述
account_id	BIGINT UNSIGNED(64)	租户 id
task_id	UUID(0)	任务 id
table_id	VARCHAR(64)	同步的表的 id
db_name	VARCHAR(256)	同步的表的库名
table_name	VARCHAR(256)	同步的表的表名
watermark	VARCHAR(128)	数据流中已经接收完整的数据范围
err_msg	VARCHAR(256)	错误信息

`mo_data_key` 表

列属性	类型	描述
account_id	BIGINT UNSIGNED(64)	租户 id
key_id	UUID(0)	密钥 id
encrypted_key	VARCHAR(128)	随机密钥加密之后的密钥
create_time	TIMESTAMP(0)	创建时间
update_time	TIMESTAMP(0)	更新时间

`mo_columns` 表

列属性	类型	描述
att_uniq_name	varchar(256)	主键。隐藏的复合主键，格式类似于 "${att_relname_id}-${attname}"
account_id	int unsigned	租户 ID
att_database_id	bigint unsigned	数据库 ID
att_database	varchar(256)	数据 Name
att_relname_id	bigint unsigned	表 ID
att_relname	varchar(256)	此列所属的表。（参考 mo_tables.relname）
attname	varchar(256)	列名
atttyp	varchar(256)	此列的数据类型 (删除的列为 0 )。
attnum	int	列数。普通列从 1 开始编号。
att_length	int	类型的字节数
attnotnull	tinyint(1)	表示一个非空约束。
atthasdef	tinyint(1)	此列有默认表达式或生成表达式。
att_default	varchar(1024)	默认表达式
attisdropped	tinyint(1)	此列已删除，不再有效。删除的列仍然物理上存在于表中，但解析器会忽略它，因此不能通过 SQL 访问它。
att_constraint_type	char(1)	p = 主键约束 n=无约束
att_is_unsigned	tinyint(1)	是否未署名
att_is_auto_increment	tinyint(1)	是否自增
att_comment	varchar(1024)	注释
att_is_hidden	tinyint(1)	是否隐藏
attr_has_update	tinyint(1)	此列含有更新表达式
attr_update	varchar(1024)	更新表达式
attr_is_clusterby	tinyint(1)	此列是否作为 cluster by 关键字来建表
attr_seqnum	SMALLINT UNSIGNED(0)	每个列的序列号
attr_enum	varchar(65535)	若这个列的类型为 ENUM，则表示该列代表的 ENUM 类型的值，否则为空

`mo_configurations` 视图

列名	数据类型	描述
node_type	VARCHAR(65535)	节点的类型：cn（计算节点）、tn（事务节点）、log（日志节点）、proxy（代理）。
node_id	VARCHAR(65535)	节点的唯一标识符。
name	VARCHAR(65535)	配置项的名称，可能会附带嵌套结构前缀。
current_value	VARCHAR(65535)	配置项的当前数值。
default_value	VARCHAR(65535)	配置项的默认数值。
internal	VARCHAR(65535)	表示配置参数是否为内部参数。

`mo_database` 表

列属性	类型	描述
dat_id	bigint unsigned	主键 ID
datname	varchar(100)	数据库名称
dat_catalog_name	varchar(100)	数据库 catalog 名称，默认`def`
dat_createsql	varchar(100)	创建数据库 SQL 语句
owner	int unsigned	角色 ID
creator	int unsigned	用户 ID
created_time	timestamp	创建时间
account_id	int unsigned	租户 ID
dat_type	varchar(23)	数据库类型，普通库或订阅库

`mo_foreign_keys` 表

列属性	类型	描述
constraint_name	VARCHAR(5000)	约束名称
constraint_id	BIGINT UNSIGNED(64)	约束 id
db_name	VARCHAR(5000)	数据库名称
db_id	BIGINT UNSIGNED(64)	数据库 id
table_name	VARCHAR(5000)	表名
table_id	BIGINT UNSIGNED(64)	表 id
column_name	VARCHAR(256)	列名
column_id	BIGINT UNSIGNED(64)	列 id
refer_db_name	VARCHAR(5000)	关联的数据库名
refer_db_id	BIGINT UNSIGNED(64)	关联的表 id
refer_table_name	VARCHAR(5000)	关联的表名
refer_table_id	BIGINT UNSIGNED(64)	关联的表 id
refer_column_name	VARCHAR(256)	关联的列名
refer_column_id	BIGINT UNSIGNED(64)	关联的列 id
on_delete	VARCHAR(128)	级联删除
on_update	VARCHAR(128)	级联更新

`mo_indexes` 表

列属性	类型	描述
id	BIGINT UNSIGNED(64)	索引 ID
table_id	BIGINT UNSIGNED(64)	索引所在表的 ID
database_id	BIGINT UNSIGNED(64)	索引所在数据库的 ID
name	VARCHAR(64)	索引的名字
type	VARCHAR(11)	索引的类型，包括主键索引（PRIMARY），唯一索引（UNIQUE），次级索引（MULTIPLE
algo	VARCHAR(11)	创建索引的算法
algo_table_type	VARCHAR(11)	多表索引的隐藏表类型
algo_params	VARCHAR(2048)	索引算法参数
is_visible	TINYINT(8)	索引是否可见，1 为可见，0 不可见（目前 MatrixOne 的索引全部为可见索引）
hidden	TINYINT(8)	索引是否为隐藏索引，1 为隐藏索引，0 为非隐藏索引
comment	VARCHAR(2048)	索引的注释信息
column_name	VARCHAR(256)	索引的组成列的列名
ordinal_position	INT UNSIGNED(32)	索引中的列序号，从 1 开始
options	TEXT(0)	索引的 options 选项信息
index_table_name	VARCHAR(5000)	该索引对应的索引表的表名，目前只有唯一索引含有索引表

`mo_locks` 视图

列名	数据类型	描述
cn_id	VARCHAR(65535)	cn 的 uuid
txn_id	VARCHAR(65535)	持有锁的事务。
table_id	VARCHAR(65535)	加锁的表。
lock_key	VARCHAR(65535)	锁类型。可以是 `point` 或 `range`。
lock_content	VARCHAR(65535)	锁定的内容，以 16 进制表示。对于 `range` 锁，表示一个区间；对于 `point` 锁，表示单个值。
lock_mode	VARCHAR(65535)	锁模式。可以是 `shared` 或 `exclusive`。
lock_status	VARCHAR(65535)	锁状态，可能为 `wait`、`acquired` 或 `none`。 wait。没有事务持有锁，但有事务等在锁上。 acquired。有事务持有锁。 none。没有事务持有锁，也没有事务等在锁上。
lock_wait	VARCHAR(65535)	在此锁上等待的事务。

`mo_mysql_compatibility_mode` 表

列属性	类型	描述
configuration_id	INT(32)	配置项 id，自增列，作为主键区分不同的配置
account_id	INT(32)	配置所在的租户 id
account_name	VARCHAR(300)	配置所在的租户名称
dat_name	VARCHAR(5000)	配置所在的数据库名称
variable_name	VARCHAR(300)	变量的名字
variable_value	VARCHAR(5000)	变量的值
system_variables	BOOL(0)	是否为系统变量 (除了系统变量，还添加的有兼容性变量）

`mo_pitr` 表

列属性	类型	描述
pitr_id	UUID(0)	pitr 的 id
pitr_name	VARCHAR(5000)	pitr 的名称
create_account	BIGINT UNSIGNED(64)	创建的租户
create_time	TIMESTAMP(0)	创建的时间
modified_time	TIMESTAMP(0)	更改的时间
level	VARCHAR(10)	范围
account_id	BIGINT UNSIGNED(64)	租户 id
account_name	VARCHAR(300)	租户名称
database_name	VARCHAR(5000)	数据库名称
table_name	VARCHAR(5000)	表名
obj_id	BIGINT UNSIGNED(64)	对象 id
pitr_length	TINYINT UNSIGNED(8)	pitr 时间值
pitr_unit	VARCHAR(10)	时间单位

`mo_pubs` 表

列属性	类型	描述
account_id	INT(32)	租户 id
pub_name	VARCHAR(64)	发布名称
database_name	VARCHAR(5000)	发布数据的名称
database_id	BIGINT UNSIGNED(64)	发布数据库的 ID，与 mo_database 表中的 dat_id 对应
all_table	BOOL(0)	发布库是否包含 database_id 对应数据库内的所有表
table_list	TEXT(0)	在非 all table 时，发布库内包含的表清单，表名与 database_id 对应数据库下的表一一对应
account_list	TEXT(0)	在非 all account 时，允许订阅该发布库的 account 清单
created_time	TIMESTAMP(0)	创建发布库的时间
updated_time	TIMESTAMP(0)	更新发布库的时间
owner	INT UNSIGNED(32)	创建发布库对应的角色 ID
creator	INT UNSIGNED(32)	创建发布库对应的用户 ID
comment	TEXT(0)	创建发布库的备注信息

`mo_role` 表

列属性	类型	描述
role_id	int unsigned	角色 ID，主键
role_name	varchar(100)	角色名称
creator	int unsigned	用户 ID
owner	int unsigned	MatrixOne 管理员/租户管理员拥有者 ID
created_time	timestamp	创建时间
comments	text	注释

`mo_role_grant` 表

列属性	类型	描述
granted_id	int	被授予的角色 ID，联合主键
grantee_id	int	要授予其他角色的角色 ID，联合主键
operation_role_id	int	操作角色 ID
operation_user_id	int	操作用户 ID
granted_time	timestamp	授权时间
with_grant_option	bool	是否允许获得授权角色再授权给其他用户或角色

`mo_role_privs` 表

列属性	类型	描述
role_id	int unsigned	角色 ID，联合主键
role_name	varchar(100)	角色名：accountadmin/public
obj_type	varchar(16)	对象类型：account/database/table，联合主键
obj_id	bigint unsigned	对象 ID，联合主键
privilege_id	int	权限 ID，联合主键
privilege_name	varchar(100)	权限名：权限列表
privilege_level	varchar(100)	权限级别，联合主键
operation_user_id	int unsigned	操作用户 ID
granted_time	timestamp	授权时间
with_grant_option	bool	是否允许授权

`mo_snapshot` 表

列属性	类型	描述
snapshot_id	UUID(0)	快照 id
sname	VARCHAR(64)	快照名称
ts	BIGINT(64)	创建快照的时间戳
level	ENUM('cluster','account','database','table')	快照范围
account_name	VARCHAR(300)	租户名
database_name	VARCHAR(5000)	数据库名
table_name	VARCHAR(5000)	表名
obj_id	BIGINT UNSIGNED(64)	快照对象名

`mo_subs` 表

列属性	类型	描述
sub_account_id	INT(32)	订阅租户 id
sub_name	VARCHAR(5000)	订阅名
sub_time	TIMESTAMP(0)	订阅时间
pub_account_name	VARCHAR(300)	发布租户的名称
pub_name	VARCHAR(64)	发布名称
pub_database	VARCHAR(5000)	发布的数据库
pub_tables	TEXT(0)	发布的表
pub_time	TIMESTAMP(0)	发布的时间
pub_comment	TEXT(0)	来自发布库的备注信息
status	TINYINT(8)	订阅状态，0 是正常订阅，1 是发布存在，但无订阅权限，2 是本来订阅了发布，但是又删除了发布

`mo_stages` 表

列属性	类型	描述
stage_id	INT UNSIGNED(32)	数据阶段 ID
stage_name	VARCHAR(64)	数据阶段名称
url	TEXT(0)	对象存储的路径（不含认证）、文件系统的路径
stage_credentials	TEXT(0)	认证信息，加密后保存
stage_status	VARCHAR(64)	ENABLED/DISABLED 默认：DISABLED
created_time	TIMESTAMP(0)	创建时间
comment	TEXT(0)	注释

`mo_sessions` 视图

列名	数据类型	描述
node_id	VARCHAR(65535)	MatrixOne 节点的唯一标识符。一经启动，不可更改。
conn_id	INT UNSIGNED	在 MatrixOne 中与客户端 TCP 连接相关的唯一编号，由 Hakeeper 自动生成。
session_id	VARCHAR(65535)	用于标识会话的唯一 UUID。每个新会话都会生成一个新的 UUID。
account	VARCHAR(65535)	租户的名称。
user	VARCHAR(65535)	用户的名称。
host	VARCHAR(65535)	CN 节点接收客户端请求的 IP 地址和端口。
db	VARCHAR(65535)	执行 SQL 时使用的数据库名称。
session_start	VARCHAR(65535)	会话创建的时间戳。
command	VARCHAR(65535)	MySQL 命令的类型，如 COM_QUERY、COM_STMT_PREPARE、COM_STMT_EXECUTE 等。
info	VARCHAR(65535)	执行的 SQL 语句。一个 SQL 中可能包含多个语句。
txn_id	VARCHAR(65535)	相关事务的唯一标识符。
statement_id	VARCHAR(65535)	SQL 语句的唯一标识符（UUID）。
statement_type	VARCHAR(65535)	SQL 语句的类型，如 SELECT、INSERT、UPDATE 等。
query_type	VARCHAR(65535)	SQL 语句的种类，如 DQL（数据查询语言）、TCL（事务控制语言）等。
sql_source_type	VARCHAR(65535)	SQL 语句的来源，如外部或内部。
query_start	VARCHAR(65535)	SQL 语句开始执行的时间戳。
client_host	VARCHAR(65535)	客户端的 IP 地址和端口号。
role	VARCHAR(65535)	用户的角色名称。

`mo_tables` 表

列属性	类型	描述
rel_id	bigint unsigned	主键，表 ID
relname	varchar(100)	表、索引、视图等的名称
reldatabase	varchar(100)	包含此关系的数据库，参考 mo_database.datname
reldatabase_id	bigint unsigned	包含此关系的数据库 ID，参考 mo_database.datid
relpersistence	varchar(100)	p = 永久表 t = 临时表
relkind	varchar(100)	r = 普通表 e = 外部表 i = 索引 S = 序列 v = 视图 m = 物化视图
rel_comment	varchar(100)	表注释
rel_createsql	varchar(100)	创建表 SQL 语句
created_time	timestamp	创建时间
creator	int unsigned	创建者 ID
owner	int unsigned	创建者的默认角色 ID
account_id	int unsigned	租户 id
partitioned	blob	按语句分区
partition_info	blob	分区信息
viewdef	blob	视图定义语句
constraint	varchar(5000)	与表相关的约束
rel_version	INT UNSIGNED(0)	主键，表的版本号
catalog_version	INT UNSIGNED(0)	系统表的版本号

`mo_table_partitions` 表

列属性	类型	描述
table_id	BIGINT UNSIGNED(64)	当前分区表的 ID
database_id	BIGINT UNSIGNED(64)	当前分区表所属的数据库的 ID
number	SMALLINT UNSIGNED(16)	当前分区编号。所有分区都按照定义的顺序进行索引，其中 1 是分配给第一个分区的数字
name	VARCHAR(64)	分区的名称
partition_type	VARCHAR(50)	存放表的分区类型信息，如果是分区表，其值枚举为"KEY"， "LINEAR_KEY"，"HASH"，"LINEAR_KEY_51"，"RANGE"，"RANGE_COLUMNS"，"LIST"，"LIST_COLUMNS"；如果不是分区表，partition_type 的值为空字符串。Note: MatrixOne 暂不支持 `RANGE` 和 `LIST` 分区。
partition_expression	VARCHAR(2048)	创建分区表的的 `CREATE TABLE` 或 `ALTER TABLE` 语句中使用的分区函数的表达式。
description_utf8	TEXT(0)	此列用于 `RANGE` 和 `LIST` 分区。对于 `RANGE` 分区，它包含分区的 `VALUES LESS THAN` 子句中设置的值，该值可以是整数或 `MAXVALUE`。对于 `LIST` 分区，此列包含分区的 `values in` 子句中定义的值，该子句是逗号分隔的整数值列表。对于不是 `RANGE` 或 `LIST` 的分区，此列始终为 NULL。Note: MatrixOne 暂不支持 `RANGE` 和 `LIST` 分区，此列为 NULL
comment	VARCHAR(2048)	注释的文本。否则，此值为空。
options	TEXT(0)	分区的选项信息，暂为 `NULL`
partition_table_name	VARCHAR(1024)	当前分区对应的分区子表名字

`mo_transactions` 视图

列名	数据类型	描述
cn_id	VARCHAR(65535)	唯一标识 CN（Compute Node）的 ID。
txn_id	VARCHAR(65535)	唯一标识事务的 ID。
create_ts	VARCHAR(65535)	记录事务创建时间戳，遵循 RFC3339Nano 格式 ("2006-01-02T15:04:05.999999999Z07:00")。
snapshot_ts	VARCHAR(65535)	表示事务的快照时间戳，以物理时间和逻辑时间的形式表示。
prepared_ts	VARCHAR(65535)	表示事务的 prepared 时间戳，以物理时间和逻辑时间的形式表示。
commit_ts	VARCHAR(65535)	表示事务的 commit 时间戳，以物理时间和逻辑时间的形式表示。
txn_mode	VARCHAR(65535)	标识事务模式，可以是悲观事务或乐观事务。
isolation	VARCHAR(65535)	表示事务的隔离级别，可以是 SI（Snapshot Isolation）或 RC（Read Committed）。
user_txn	VARCHAR(65535)	指示用户事务，即用户通过客户端连接到 MatrixOne 并执行的 SQL 操作所创建的事务。
txn_status	VARCHAR(65535)	表示事务的当前状态，可能的取值包括 active（活跃）、committed（已提交）、aborting（中止中）、aborted（已中止）。在分布式事务 2PC 模式下，还会包括 prepared（已准备）和 committing（提交中）。
table_id	VARCHAR(65535)	表示事务所涉及的表的 ID。
lock_key	VARCHAR(65535)	表示锁的类型，可以是 range（范围锁）或 point（点锁）。
lock_content	VARCHAR(65535)	point 锁时表示单个值，range 锁时表示范围，通常以 "low - high" 形式表示。请注意，事务可能涉及多个锁，但此处仅展示第一个锁。
lock_mode	VARCHAR(65535)	表示锁的模式，可以是互斥锁（exclusive）或共享锁（shared）。

`mo_user` 表

列属性	类型	描述
user_id	int	用户 ID，主键
user_host	varchar(100)	用户主机地址
user_name	varchar(100)	用户名
authentication_string	varchar(100)	密码加密的认证字符串
status	varchar(8)	开启、锁定、失效
created_time	timestamp	用户创建时间
expired_time	timestamp	用户过期时间
login_type	varchar(16)	ssl/密码/其他
creator	int	创建此用户的创建者 ID
owner	int	此用户的管理员 ID
default_role	int	此用户的默认角色 ID

`mo_user_grant` 表

列属性	类型	描述
role_id	int unsigned	被授权角色 ID，联合主键
user_id	int unsigned	获得授权角色的用户 ID，联合主键
granted_time	timestamp	授权时间
with_grant_option	bool	是否允许获得授权用户再授权给其他用户或角色

`mo_user_defined_function` 表

列属性	类型	描述
function_id	INT(32)	函数的 ID，主键
name	VARCHAR(100)	函数的名称
owner	INT UNSIGNED(32)	创建函数的角色 ID
args	TEXT(0)	函数的参数列表
rettype	VARCHAR(20)	函数的返回类型
body	TEXT(0)	函数的函数体
language	VARCHAR(20)	函数所使用的语言
db	VARCHAR(100)	函数所在的数据库
definer	VARCHAR(50)	定义函数的用户名称
modified_time	TIMESTAMP(0)	函数最后一次修改的时间
created_time	TIMESTAMP(0)	函数的创建时间
type	VARCHAR(10)	函数的类型，默认 FUNCTION
security_type	VARCHAR(10)	安全处理方式，统一值 DEFINER
comment	VARCHAR(5000)	创建函数的注释
character_set_client	VARCHAR(64)	客户端字符集：utf8mb4
collation_connection	VARCHAR(64)	连接排序：utf8mb4_0900_ai_ci
database_collation	VARCHAR(64)	数据库连接排序：utf8mb4_0900_ai_ci

`mo_variables` 视图

列名	数据类型	描述
configuration_id	INT(32)	自增列，用于唯一标识每个配置项。
account_id	INT(32)	标识租户的唯一标识符。
account_name	VARCHAR(300)	租户的名称。
dat_name	VARCHAR(5000)	数据库的名称。
variable_name	VARCHAR(300)	配置变量的名称。
variable_value	VARCHAR(5000)	配置变量的数值。
system_variables	BOOL(0)	指示配置变量是否为系统级别的变量。

`mo_version` 表

列名	数据类型	描述
version	VARCHAR(50)	版本
version_offset	INT UNSIGNED(32)	同一个版本做增量升级时的偏移位置
state	INT(32)	状态
create_at	TIMESTAMP(0)	版本创建时间
update_at	TIMESTAMP(0)	版本更新时间

`system_metrics` 数据库

system_metrics 收集 SQL 语句、CPU 和内存资源使用的状态和统计信息。

metrics 表一些相同的列类型，这些表中的字段描述如下：

collecttime：收集时间。
value：采集 metrics 的值。
node：表示 MatrixOne 节点的 uuid。
role：MatrixOne 节点角色，包括 CN、TN 和 Log。
account：默认为“sys”租户，即触发 SQL 请求的账户。
type：SQL 类型，可以是 select，insert，update，delete，other 类型。

`metric` 表

列属性	类型	描述
metric_name	VARCHAR(128)	指标名称，例如：sql_statement_total，server_connections，process_cpu_percent，sys_memory_used 等
collecttime	DATETIME	指标数据收集时间
value	DOUBLE	指标值
node	VARCHAR(36)	MatrixOne 节点 uuid
role	VARCHAR(32)	MatrixOne 节点角色
account	VARCHAR(128)	租户名称，默认 `sys`
type	VARCHAR(32)	SQL 类型，例如：INSERT，SELECT，UPDATE

以下表为 metric 表的视图：

sql_statement_total 表：执行 SQL 语句的计数器。
sql_statement_errors 表：执行错误的 SQL 语句的计数器。
sql_transaction_total 表：事务性 SQL 语句的计数器。
sql_transaction_errors 表：错误执行的事务性语句的计数器。
server_connections 表：服务器连接数。
server_storage_usage：服务器存储使用情况。
process_cpu_percent 表：CPU 进程繁忙百分比。
process_resident_memory_bytes 表：驻留内存量，单位为字节。
process_open_fds 表：打开的文件描述符的数量。
sys_cpu_seconds_total 表：系统 CPU 时间，以秒为单位，由核数标准化。
sys_cpu_combined_percent 表：系统 CPU 繁忙百分比，所有逻辑核的平均值。
sys_memory_used 表：以字节为单位已使用的系统内存。
sys_memory_available 表：以字节为单位的可用系统内存。
sys_disk_read_bytes 表：以字节为单位读取系统盘。
sys_disk_write_bytes 表：以字节为单位写入系统盘。
sys_net_recv_bytes 表：以字节为单位接收的系统网络。
sys_net_sent_bytes 表：以字节为单位发送的系统网络。

`system` 数据库

System 数据库存储 MatrixOne 历史 SQL 语句、系统日志、错误信息。

`statement_info` 表

statement_info 表记录用户和系统的 SQL 语句和详细信息。

列属性	类型	描述
statement_id	VARCHAR(36)	声明语句唯一 ID
transaction_id	VARCHAR(36)	事务唯一 ID
session_id	VARCHAR(36)	账户唯一 ID
account	VARCHAR(1024)	租户名称
user	VARCHAR(1024)	用户名称
host	VARCHAR(1024)	用户客户端 IP
database	VARCHAR(1024)	数据库当前会话停留处
statement	TEXT	SQL 语句
statement_tag	TEXT	语句中的注释标签 (保留)
statement_fingerprint	TEXT	语句中的注释标签 (保留)
node_uuid	VARCHAR(36)	节点 uuid，即生成数据的某个节点
node_type	VARCHAR(64)	在 MatrixOne 内，var 所属的 TN/CN/Log 的节点类型
request_at	DATETIME	请求接受的 datetime
response_at	DATETIME	响应发送的 datetime
duration	BIGINT	执行时间，单位：ns
status	VARCHAR(32)	SQL 语句执行状态：Running, Success, Failed
err_code	VARCHAR(1024)	错误码
error	TEXT	错误信息
exec_plan	JSON	语句执行计划
rows_read	BIGINT	读取总行数
bytes_scan	BIGINT	扫描总字节数
stats	JSON	exec_plan 中的全局统计信息
statement_type	VARCHAR(1024)	语句类型，[Insert, Delete, Update, Drop Table, Drop User, ...]
query_type	VARCHAR(1024)	查询类型，[DQL, DDL, DML, DCL, TCL]
role_id	BIGINT	角色 ID
sql_source_type	TEXT	SQL 语句源类型:internal_sql,external_sql,cloud_nonuser_sql
result_count	BIGINT(64)	统计 sql 执行结果的行数
aggr_count	BIGINT(64)	聚合条数

`rawlog` 表

rawlog 表记录了非常详细的系统日志。

列属性	类型	描述
raw_item	VARCHAR(1024)	原日志项
node_uuid	VARCHAR(36)	节点 uuid，即生成数据的某个节点
node_type	VARCHAR(64)	在 MatrixOne 内，var 所属的 TN/CN/Log 的节点类型
span_id	VARCHAR(16)	span 的唯一 ID
trace_id	VARCHAR(36)	trace 唯一 uuid
logger_name	VARCHAR(1024)	日志记录器的名称
timestamp	DATETIME	时间戳的动作
level	VARCHAR(1024)	日志级别，例如：debug, info, warn, error, panic, fatal
caller	VARCHAR(1024)	产生 Log 的地方：package/file.go:123
message	TEXT	日志消息
extra	JSON	日志动态字段
err_code	VARCHAR(1024)	错误日志
error	TEXT	错误信息
stack	VARCHAR(4096)	log_info 和 error_info 的堆栈信息
span_name	VARCHAR(1024)	span 名称，例如：step name of execution plan, function name in code, ...
parent_span_id	VARCHAR(16)	父级 span 唯一的 ID
start_time	DATETIME	span 开始的时间
end_time	DATETIME	span 结束的时间
duration	BIGINT	执行时间，单位：ns
resource	JSON	静态资源信息
span_kind	VARCHAR(1024)	span 类型。internal: MO 内部的生成的 trace (默认值); statement: trace_id==statement_id; remote: 通过 morpc 通信
statement_id	VARCHAR(36)	声明语句的 ID
session_id	VARCHAR(36)	会话的 ID

其他 3 个表（log_info、span_info 和 error_info）是 statement_info 和 rawlog 表的视图。

`information_schema` 数据库

Information Schema 提供了一种 ANSI 标准方式，用于查看系统的元数据。MatrixOne 除了为 MySQL 兼容性而包含的表之外，还提供了许多自定义的 information_schema 表。

许多 INFORMATION_SCHEMA 表都有相应的 SHOW 命令。查询 INFORMATION_SCHEMA 可以在表之间进行连接。

MySQL 兼容性表

表名称	描述
KEY_COLUMN_USAGE	描述了列的键约束，例如主键约束。
COLUMNS	提供了所有表的列列表。
PROFILING	提供 SQL 语句执行时一些分析信息。
PROCESSLIST	提供了与执行命令 `SHOW PROCESSLIST` 类似的信息。
USER_PRIVILEGES	列举了与当前用户关联的权限。
SCHEMATA	提供了与执行 `SHOW DATABASES` 类似的信息。
CHARACTER_SETS	提供了服务器支持的字符集列表。
TRIGGERS	提供了与执行 `SHOW TRIGGERS` 类似的信息。
TABLES	提供了当前用户可以查看的表列表。类似于执行`SHOW TABLES`。
PARTITIONS	提供了表的分区信息。
VIEWS	提供有关数据库中视图的信息。
ENGINES	提供了支持的存储引擎列表。
ROUTINES	提供有关存储存储过程的一些信息。
PARAMETERS	表提供了存储过程的参数和返回值的信息。
KEYWORDS	提供有关数据库中关键字信息，详情参见关键字。

`CHARACTER_SETS` 表

CHARACTER_SETS 表中的列描述如下：

CHARACTER_SET_NAME：字符集的名称。
DEFAULT_COLLATE_NAME：字符集的默认排序规则名称。
DESCRIPTION：字符集的描述。
MAXLEN：在此字符集中存储字符所需的最大长度。

`COLUMNS` 视图

COLUMNS 视图中的列描述如下：

TABLE_CATALOG：含有该列的表所属的目录的名称。该值始终为 def。
TABLE_SCHEMA：含有列的表所在的模式的名称。
TABLE_NAME：包含列的表的名称。
COLUMN_NAME：列的名称。
ORDINAL_POSITION：表中列的位置。
COLUMN_DEFAULT：列的默认值。如果显式默认值为 NULL，或者如果列定义不包含 default 子句，则此值为 NULL。
IS_NULLABLE：列是否可以为空。如果该列可以存储空值，则该值为 YES；否则为 NO。
DATA_TYPE：列中的数据类型。
CHARACTER_MAXIMUM_LENGTH：对于字符串列，字符的最大长度。
CHARACTER_OCTET_LENGTH：对于字符串列，最大长度（以字节为单位）。
NUMERIC_PRECISION：数字类型列的数字精度。
NUMERIC_SCALE：数字类型列的数字比例。
DATETIME_PRECISION：对于时间类型列，小数秒精度。
CHARACTER_SET_NAME：字符串列的字符集名称。
COLLATION_NAME：字符串列的排序规则的名称。
COLUMN_TYPE：列类型。
COLUMN_KEY：该列是否被索引。该字段可能具有以下值：
- Empty：此列未编入索引，或者此列已编入索引并且是多列非唯一索引中的第二列。
- PRI：此列是主键或多个主键之一。
- UNI：此列是唯一索引的第一列。
- MUL：该列是非唯一索引的第一列，其中允许给定值多次出现。
EXTRA：给定列的任何附加信息。
PRIVILEGES：当前用户所拥有的对该列的权限。
COLUMN_COMMENT：列定义中包含的描述。
GENERATION_EXPRESSION：对于生成的列，此值显示用于计算列值的表达式。对于非生成列，该值为空。
SRS_ID：此值适用于空间列。它包含列 SRID 值，该值表示为存储在该列中的值提供一个空间参考系统。

`ENGINES` 表

ENGINES 表中的列描述如下：

ENGINE：存储引擎的名称。
SUPPORT：服务器对存储引擎的支持级别。
COMMENT：对存储引擎的简短评论。
TRANSACTIONS：存储引擎是否支持事务。
XA：存储引擎是否支持 XA 事务。
SAVEPOINTS：存储引擎是否支持 savepoints。

`PARTITIONS` 视图

PARTITIONS 视图中的列描述如下：

TABLE_CATALOG：含有该列的表所属的目录的名称。该值始终为 def。
TABLE_SCHEMA：含有列的表所在的模式的名称。
TABLE_NAME：包含列的表的名称。
PARTITION_NAME：分区名称。
SUBPARTITION_NAME：如果 PARTITIONS 表中的行表示一个子分区，则为该子分区的名称；否则为空。
PARTITION_ORDINAL_POSITION：所有分区按照它们被定义的顺序进行索引，其中 1 表示分配给第一个分区的编号。随着分区的增加、删除和重新组织，索引可能会发生变化；该列中显示的编号反映了当前的顺序，考虑了任何索引变化。
SUBPARTITION_ORDINAL_POSITION：在给定分区内，子分区的索引和重新索引方式与表内分区的方式相同。
PARTITION_METHOD：取值之一为 RANGE、LIST、HASH、LINEAR HASH、KEY 或 LINEAR KEY。Note: MatrixOne 暂不支持 RANGE 和 LIST 分区。
SUBPARTITION_METHOD：取值之一为 HASH、LINEAR HASH、KEY 或 LINEAR KEY。
PARTITION_EXPRESSION：在创建表的 CREATE TABLE 或 ALTER TABLE 语句中使用的分区函数表达式，用于创建表的当前分区方案。
SUBPARTITION_EXPRESSION：这与 PARTITION_EXPRESSION 类似，用于定义表的子分区方式，如果表没有子分区，则该列为空。
PARTITION_DESCRIPTION：此列适用于 RANGE 和 LIST 分区。对于 RANGE 分区，它包含在分区的 VALUES LESS THAN 子句中设置的值，可以是整数或 MAXVALUE。对于 LIST 分区，此列包含在分区的 VALUES IN 子句中定义的值，这是一组逗号分隔的整数值。对于 PARTITION_METHOD 不是 RANGE 或 LIST 的分区，此列始终为空。Note: MatrixOne 暂不支持 RANGE 和 LIST 分区。
TABLE_ROWS：分区中的表行数。
AVG_ROW_LENGTH：存储在此分区或子分区中的行的平均长度，以字节为单位。这与 DATA_LENGTH 除以 TABLE_ROWS 得到的结果相同。
DATA_LENGTH：此分区或子分区中存储的所有行的总长度，以字节为单位；即存储在分区或子分区中的字节总数。
MAX_DATA_LENGTH: 分区中数据的最大长度
INDEX_LENGTH：此分区或子分区的索引文件长度，以字节为单位。
DATA_FREE：分配给分区或子分区但未使用的字节数。
CREATE_TIME：分区或子分区创建的时间。
UPDATE_TIME：分区或子分区上次修改的时间。
CHECK_TIME：属于此分区或子分区的表最后一次检查的时间。
CHECKSUM：校验和值，如果有的话；否则为空。
PARTITION_COMMENT：如果分区有注释，则为注释的文本。如果没有，则该值为空。分区注释的最大长度定义为 1024 个字符，PARTITION_COMMENT 列的显示宽度也为 1024 个字符，以与此限制相符。
NODEGROUP：该分区所属的节点组。
TABLESPACE_NAME：该分区所属的表空间的名称。该值始终为 DEFAULT。

`PROCESSLIST` 视图

PROCESSLIST 视图中的字段描述如下：

NODE_ID：CN 节点 UUID
CONN_ID：用户连接的 ID
SESSION_ID：会话的 ID
ACCOUNT：租户名
USER：用户名
HOST：CN 节点的监听地址
DB：当前连接的数据库
SESSION_START：session 创建时间
COMMAND：语句的 MySQL 协议 Command
INFO：正在处理的 SQL 语句
TXN_ID：事务 ID
STATEMENT_ID：语句 ID
STATEMENT_TYPE：语句类型，Select/Update/Delete 等
QUERY_TYPR：查询类型，DQL/DDL/DML 等
SQL_SOURCE_TYPE：SQL 语句源类型，外部或者内部 SQL：external_sql/internal_sql
QUERY_START：查询开始时间
CLIENT_HOST：客户端地址

`SCHEMATA` 视图

SCHEMATA 视图提供有关数据库的信息，数据等同于 SHOW DATABASES 语句的结果。SCHEMATA 视图中的字段描述如下：

CATALOG_NAME：数据库所属的目录。
SCHEMA_NAME：数据库名称。
DEFAULT_CHARACTER_SET_NAME：数据库的默认字符集。
DEFAULT_COLLATION_NAME：数据库的默认排序规则。
SQL_PATH：此项的值始终为 NULL。
DEFAULT_TABLE_ENCRYPTION：定义数据库和通用表空间的 default encryption 设置。

`TABLES` 视图

TABLES 视图中列的描述如下：

TABLE_CATALOG：表所属目录的名称。该值始终为 def。
TABLE_SCHEMA：表所属的模式的名称。
TABLE_NAME：表的名称。
TABLE_TYPE：表的类型。基本表类型为 BASE TABLE，视图表类型为 VIEW，INFORMATION_SCHEMA 表类型为 SYSTEM VIEW。
ENGINE：存储引擎的类型。
VERSION：版本。默认值为 10。
ROW_FORMAT：行存储格式。值为 Fixed，Dynamic，Compressed，Redundant，Compact。
TABLE_ROWS：统计表中的行数。对于 INFORMATION_SCHEMA 表，TABLE_ROWS 为 NULL。
AVG_ROW_LENGTH：表的平均行长度。AVG_ROW_LENGTH = DATA_LENGTH / TABLE_ROWS。
DATA_LENGTH：数据长度。DATA_LENGTH = TABLE_ROWS * 元组中列的存储长度之和。
MAX_DATA_LENGTH：最大数据长度。该值当前为 0，表示数据长度没有上限。
INDEX_LENGTH：索引长度。INDEX_LENGTH = TABLE_ROWS * 索引元组中列的长度总和。
DATA_FREE：数据片段。该值当前为 0。
AUTO_INCREMENT：自增主键的当前步长。
CREATE_TIME：创建表的时间。
UPDATE_TIME：表更新的时间。
CHECK_TIME：检查表的时间。
TABLE_COLLATION：表中字符串的排序规则。
CHECKSUM：校验和。
CREATE_OPTIONS：创建选项。
TABLE_COMMENT：表格的注释和注释。

`USER_PRIVILEGES` 表

USER_PRIVILEGES 表提供了关于全局权限的信息。

USER_PRIVILEGES 表中的字段描述如下：

GRANTEE：授权用户名，格式为 'user_name'@'host_name'。
TABLE_CATALOG：表所属的目录的名称。值为 def。
PRIVILEGE_TYPE：要授予的权限类型。每行只显示一种权限类型。
IS_GRANTABLE：如果你有 GRANT OPTION 权限，该值为 YES，没有 GRANT OPTION 权限，该值为 NO。

`VIEWS` 视图

TABLE_CATALOG：视图所属目录的名称。值为 def。
TABLE_SCHEMA：视图所属的数据库的名称。
TABLE_NAME：视图的名称。
VIEW_DEFINITION：提供视图定义的 SELECT 语句。包含了在 SHOW Create VIEW 生成的创建表列中看到的大部分内容。
CHECK_OPTION：CHECK_OPTION 属性的值。值为 NONE、CASCADE 或 LOCAL。
IS_UPDATABLE：在 CREATE VIEW 时设置一个名为视图可更新性标志的标志，如果 UPDATE 和 DELETE（以及类似的操作）对视图合法，则标志设置为 YES（true）。否则，标志设置为 NO（false）。
DEFINER：创建视图的用户的帐户，格式为 username@hostname。
SECURITY_TYPE：视图 SQL SECURITY 特性。值为 DEFINER 或 INVOKER。
CHARACTER_SET_CLIENT：创建视图时 character_set_client 系统变量的会话值。
COLLATION_CONNECTION：创建视图时，collation_connection 系统变量的会话值。
INDEX_COMMENT：创建索引时为具有 comment 属性的索引提供的任何注释。
IS_VISIBLE：索引对优化器是否可见。目前该字段在 mo 中没有意义
EXPRESSION：表示索引中的表达式或函数。目前该字段在 mo 中没有意义

`STATISTICS` 视图

获取有关数据库表索引和统计信息的详细信息。例如，可以检查索引是否唯一，了解索引中的列顺序，以及估计索引中的唯一值数量。

TABLE_CATALOG：表的目录名称（始终为 'def'）。
TABLE_SCHEMA：表所属的数据库名称。
TABLE_NAME：表的名称。
NON_UNIQUE：指示索引是否允许重复值。如果为 0，则索引是唯一索引。
INDEX_SCHEMA：索引所属的数据库名称。
INDEX_NAME：索引的名称。
SEQ_IN_INDEX：列在索引中的位置。
COLUMN_NAME：列的名称。
COLLATION：列的排序规则。
CARDINALITY：索引中唯一值的数量估计。
SUB_PART：索引部分长度。对于整个列，该值为 NULL。
PACKED：指示是否使用压缩存储的值。
NULLABLE：指示列是否允许 NULL 值。
INDEX_TYPE：索引的类型（如 BTREE、HASH 等）。
COMMENT：索引的注释信息。
INDEX_COMMENT：创建索引时为具有 comment 属性的索引提供的任何注释。
IS_VISIBLE：索引对优化器是否可见。目前该字段在 mo 中没有意义
EXPRESSION：表示索引中的表达式或函数。目前该字段在 mo 中没有意义

`mysql` 数据库

授权系统表

授权系统表包含了关于用户帐户及其权限信息：

user 用户帐户、全局权限和其他非权限列。
db：数据库级权限。
tables_priv：表级权限。
columns_priv：列级权限。
procs_priv：存储过程和存储函数的权限。

MatrixOne 系统数据库和表

mo_catalog 数据库

mo_account 表 (仅 sys 租户可见)

mo_cdc_task 表

mo_cdc_watermark 表

mo_data_key 表

mo_columns 表

mo_configurations 视图

mo_database 表

mo_foreign_keys 表

mo_indexes 表

mo_locks 视图

mo_mysql_compatibility_mode 表

mo_pitr 表

mo_pubs 表

mo_role 表

mo_role_grant 表

mo_role_privs 表

mo_snapshot 表

mo_subs 表

mo_stages 表

mo_sessions 视图

mo_tables 表

mo_table_partitions 表

mo_transactions 视图

mo_user 表

mo_user_grant 表

mo_user_defined_function 表

mo_variables 视图

mo_version 表

system_metrics 数据库

metric 表

system 数据库

statement_info 表

rawlog 表

information_schema 数据库