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_database table

mo_tables table

mo_columns table

mo_table_partitions table

mo_account table (仅 sys 租户可见)

mo_role table

mo_user table

mo_user_grant table

mo_role_grant table

mo_role_privs table

mo_stages table

mo_user_defined_function table

mo_mysql_compatbility_mode table

mo_pubs table

mo_indexes table

system_metrics 数据库

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

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

• collecttime：收集时间。

• value：采集 metrics 的值。

• node：表示 MatrixOne 节点的 uuid。

• role：MatrixOne 节点角色，包括 CN、TN 和 Log。

• account：默认为“sys”租户，即触发 SQL 请求的账户。

• type：SQL 类型，可以是 select，insert，update，delete，other 类型。

metric 表

以下表为 metric 表的视图：

• sql_statement_total 表：执行 SQL 语句的计数器。
• sql_statement_hotspot 表：记录了每分钟内各个租户执行的消耗时间最长的 SQL 查询。需要注意的是，只有那些执行时间未超过某个特定聚合阈值的 SQL 查询才会被纳入统计。
• sql_statement_errors 表：执行错误的 SQL 语句的计数器。
• sql_transaction_total 表：事务性 SQL 语句的计数器。
• sql_transaction_errors 表：错误执行的事务性语句的计数器。
• server_connection 表：服务器连接数。
• 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 语句和详细信息。

rawlog 表

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

其他 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 兼容性表

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 表中的列描述如下：

• ENGINES：存储引擎的名称。
• 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：此分区或子分区中存储的所有行的总长度，以字节为单位；即存储在分区或子分区中的字节总数。
• INDEX_LENGTH：此分区或子分区的索引文件长度，以字节为单位。
• DATA_FREE：分配给分区或子分区但未使用的字节数。
• CREATE_TIME：分区或子分区创建的时间。
• UPDATE_TIME：分区或子分区上次修改的时间。
• CHECK_TIME：属于此分区或子分区的表最后一次检查的时间。
• CHECKSUM：校验和值，如果有的话；否则为空。
• PARTITION_COMMENT：如果分区有注释，则为注释的文本。如果没有，则该值为空。分区注释的最大长度定义为 1024 个字符，PARTITION_COMMENT 列的显示宽度也为 1024 个字符，以与此限制相符。
• NODEGROUP：该分区所属的节点组。
• TABLESPACE_NAME：该分区所属的表空间的名称。该值始终为 DEFAULT。

PROCESSLIST 表

PROCESSLIST 表中的字段描述如下：

• ID：用户连接的 ID。
• USER：正在执行 PROCESS 的用户名。
• HOST：用户连接的地址。
• DB：当前连接的默认数据库的名称。
• COMMAND：PROCESS 正在执行的命令类型。
• TIME：PROCESS 的当前执行时长，以秒为单位。
• STATE：当前连接状态。
• INFO：正在处理的请求语句。

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。

VIEW 表

• 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 系统变量的会话值。

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：索引的注释信息。

mysql 数据库

授权系统表

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

• user 用户帐户、全局权限和其他非权限列。

• db：数据库级权限。

• tables_priv：表级权限。

• columns_priv：列级权限。

• procs_priv：存储过程和存储函数的权限。