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
| 列属性 | 类型 | 描述 |
|---|---|---|
| dat_id | bigint unsigned | 主键 |
| datname | varchar(100) | 数据库名称 |
| dat_catalog_name | varchar(100) | 数据库 catalog 名称，默认def |
| dat_createsql | varchar(100) | 创建数据库 SQL 语句 |
| owner | int unsigned | 角色 ID ID |
| creator | int unsigned | 用户 ID ID |
| created_time | timestamp | 创建时间 |
| account_id | int unsigned | 租户 ID ID |
mo_tables table
| 列属性 | 类型 | 描述 |
|---|---|---|
| rel_id | bigint unsigned | 主键 |
| 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 | 按语句分区 |
| viewdef | blob | 视图定义语句 |
mo_columns table
| 列属性 | 类型 | 描述 |
|---|---|---|
| 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) | 更新表达式 |
mo_account table (仅 sys 租户可见)
| 列属性 | 类型 | 描述 |
|---|---|---|
| account_id | int unsigned | 租户 ID |
| account_name | varchar(100) | 租户名 |
| status | varchar(100) | 开启/暂停 |
| created_time | timestamp | 创建时间 |
| comment | varchar(256) | 注释 |
| suspended_time | TIMESTAMP | 修改租户状态的时间 |
mo_role table
| 列属性 | 类型 | 描述 |
|---|---|---|
| role_id | int unsigned | 角色 ID |
| role_name | varchar(100) | 角色名称 |
| creator | int unsigned | 用户 ID |
| owner | int unsigned | MatrixOne 管理员/租户管理员拥有者 ID |
| created_time | timestamp | 创建时间 |
| comment | text | 注释 |
mo_user table
| 列属性 | 类型 | 描述 |
|---|---|---|
| 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 table
| 列属性 | 类型 | 描述 |
|---|---|---|
| role_id | int unsigned | 角色 ID |
| user_id | int unsigned | 用户 ID |
| granted_time | timestamp | 授权时间 |
| with_grant_option | bool | 是否允许授权 |
mo_role_grant table
| 列属性 | 类型 | 描述 |
|---|---|---|
| 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 table
| 列属性 | 类型 | 描述 |
|---|---|---|
| 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 | 是否允许授权 |
system_metrics 数据库
system_metrics 收集 SQL 语句、CPU 和内存资源使用的状态和统计信息。
system_metrics 表一些相同的列类型，这些表中的字段描述如下：
-
collecttime：收集时间。
-
value：采集
metrics的值。 -
node：表示 MatrixOne 节点的 uuid。
-
role：MatrixOne 节点角色，包括 CN、DN 和 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 |
| 类型 | VARCHAR(32) | SQL 类型，例如：INSERT，SELECT，UPDATE |
以下表为 metric 表的视图：
process_cpu_percent表：CPU 进程繁忙百分比。process_open_fs表：打开的文件描述符的数量。process_resident_memory_bytes表：驻留内存量，单位为字节。server_connection表：服务器连接数。sql_statement_errors表：执行错误的 SQL 语句的计数器。sql_statement_total表：执行 SQL 语句的计数器。sql_transaction_errors表：错误执行的事务性语句的计数器。sql_transaction_total表：事务性 SQL 语句的计数器。sys_cpu_combined_percent表：系统 CPU 繁忙百分比，所有逻辑核的平均值。sys_cpu_seconds_total表：系统 CPU 时间，以秒为单位，由核数标准化sys_disk_read_bytes表：以字节为单位读取系统盘。sys_disk_write_bytes表：以字节为单位写入系统盘。sys_memory_available表：以字节为单位的可用系统内存。sys_memory_used表：以字节为单位已使用的系统内存。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 所属的 DN/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 | global stats info in exec_plan |
| statement_type | VARCHAR(1024) | statement type, val in [Insert, Delete, Update, Drop Table, Drop User, ...] |
| query_type | VARCHAR(1024) | query type, val in [DQL, DDL, DML, DCL, TCL] |
| role_id | BIGINT | role id |
| sql_source_type | TEXT | sql statement source type |
rawlog 表
rawlog 表记录了非常详细的系统日志。
| 列属性 | 类型 | 描述 |
|---|---|---|
| raw_item | VARCHAR(1024) | 原日志项 |
| node_uuid | VARCHAR(36) | 节点 uuid，即生成数据的某个节点 |
| node_type | VARCHAR(64) | 在 MatrixOne 内，var 所属的 DN/CN/Log 的节点类型 |
| span_id | VARCHAR(16) | span 的唯一 ID |
| statement_id | VARCHAR(36) | 声明语句唯一 ID |
| 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) | |
| span_name | VARCHAR(1024) | span 名称，例如：step name of execution plan, function name in code, ... |
| parent_span_id | VARCHAR(16) | 父级 span 唯一的 ID |
| start_time | DATETIME | |
| end_time | DATETIME | |
| duration | BIGINT | 执行时间，单位：ns |
| resource | JSON | 静态资源信息 |
其他 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 | 提供了服务器支持的字符集列表。 |
| COLUMNS | 提供了所有表的列列表。 |
| ENGINES | 提供了支持的存储引擎列表。 |
| KEY_COLUMN_USAGE | 描述了列的键约束，例如主键约束。 |
| PROCESSLIST | 提供了与执行命令 SHOW PROCESSLIST 类似的信息。 |
| SCHEMATA | 提供了与执行 SHOW DATABASES 类似的信息。 |
| TABLES | 提供了当前用户可以查看的表列表。类似于执行SHOW TABLES。 |
| TRIGGERS | 提供了与执行 SHOW TRIGGERS 类似的信息。Provides similar information to SHOW TRIGGERS. |
| USER_PRIVILEGES | 列举了与当前用户关联的权限。 |
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。
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：表的类型。ENGINE：存储引擎的类型。VERSION：版本。默认值为10。ROW_FORMAT：行格式。该值当前为Compact。TABLE_ROWS：统计表中的行数。AVG_ROW_LENGTH：表的平均行长。AVG_ROW_LENGTH=DATA_LENGTH/TABLE_ROWS。DATA_LENGTH：数据长度。DATA_LENGTH=TABLE_ROWS* 元组中列的存储长度之和。不考虑 TiKV 的副本。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。
mysql 数据库
授权系统表
授权系统表包含了关于用户帐户及其权限信息：
-
user用户帐户、全局权限和其他非权限列。 -
db：数据库级权限。 -
tables_priv：表级权限。 -
columns_priv：列级权限。 -
procs_priv：存储过程和存储函数的权限。