MatrixOne 系统数据库和表

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

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

mo_catalog 数据库

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

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

mo_database table

列属性类型描述
dat_idbigint unsigned主键
datnamevarchar(100)数据库名称
dat_catalog_namevarchar(100)数据库 catalog 名称,默认def
dat_createsqlvarchar(100)创建数据库 SQL 语句
ownerint unsigned角色 ID ID
creatorint unsigned用户 ID ID
created_timetimestamp创建时间
account_idint unsigned租户 ID ID

mo_tables table

列属性类型描述
rel_idbigint unsigned主键
relnamevarchar(100)表、索引、视图等的名称
reldatabasevarchar(100)包含此关系的数据库,参考 mo_database.datname
reldatabase_idbigint unsigned包含此关系的数据库 ID,参考 mo_database.datid
relpersistencevarchar(100)p = 永久表
t = 临时表
relkindvarchar(100)r = 普通表
e = 外部表
i = 索引
S = 序列
v = 视图
m = 物化视图
rel_commentvarchar(100)
rel_createsqlvarchar(100)创建表 SQL 语句
created_timetimestamp创建时间
creatorint unsigned创建者 ID
ownerint unsigned创建者的默认角色 ID
account_idint unsigned租户 id
partitionedblob按语句分区
viewdefblob视图定义语句

mo_columns table

列属性类型描述
att_uniq_namevarchar(256)主键。隐藏的复合主键,格式类似于 “${att_relname_id}-${attname}”
account_idint unsigned租户 ID
att_database_idbigint unsigned数据库 ID
att_databasevarchar(256)数据 Name
att_relname_idbigint unsigned表 ID
att_relnamevarchar(256)此列所属的表。(参考 mo_tables.relname)
attnamevarchar(256)列名
atttypvarchar(256)此列的数据类型 (删除的列为 0 )。
attnumint列数。普通列从 1 开始编号。
att_lengthint类型的字节数
attnotnulltinyint(1)表示一个非空约束。
atthasdeftinyint(1)此列有默认表达式或生成表达式。
att_defaultvarchar(1024)默认表达式
attisdroppedtinyint(1)此列已删除,不再有效。删除的列仍然物理上存在于表中,但解析器会忽略它,因此不能通过 SQL 访问它。
att_constraint_typechar(1)p = 主键约束
n=无约束
att_is_unsignedtinyint(1)是否未署名
att_is_auto_incrementtinyint(1)是否自增
att_commentvarchar(1024)注释
att_is_hiddentinyint(1)是否隐藏
attr_has_updatetinyint(1)此列含有更新表达式
attr_updatevarchar(1024)更新表达式

mo_account table (仅 sys 租户可见)

列属性类型描述
account_idint unsigned租户 ID
account_namevarchar(100)租户名
statusvarchar(100)开启/暂停
created_timetimestamp创建时间
commentvarchar(256)注释
suspended_timeTIMESTAMP修改租户状态的时间

mo_role table

列属性类型描述
role_idint unsigned角色 ID
role_namevarchar(100)角色名称
creatorint unsigned用户 ID
ownerint unsignedMatrixOne 管理员/租户管理员拥有者 ID
created_timetimestamp创建时间
commenttext注释

mo_user table

列属性类型描述
user_idint用户 ID
user_hostvarchar(100)用户主机地址
user_namevarchar(100)用户名
authentication_stringvarchar(100)密码加密的认证字符串
statusvarchar(8)开启、锁定、失效
created_timetimestamp用户创建时间
expired_timetimestamp用户过期时间
login_typevarchar(16)ssl/密码/其他
creatorint创建此用户的创建者 ID
ownerint此用户的管理员 ID
default_roleint此用户的默认角色 ID

mo_user_grant table

列属性类型描述
role_idint unsigned角色 ID
user_idint unsigned用户 ID
granted_timetimestamp授权时间
with_grant_optionbool是否允许授权

mo_role_grant table

列属性类型描述
granted_idint被授予的角色 ID
grantee_idint要授予其他角色的角色 ID
operation_role_idint操作角色 ID
operation_user_idint操作用户 ID
granted_timetimestamp授权时间
with_grant_optionbool是否允许授权

mo_role_privs table

列属性类型描述
role_idint unsigned角色 ID
role_namevarchar(100)角色名:accountadmin/public
obj_typevarchar(16)对象类型:account/database/table
obj_idbigint unsigned对象 ID
privilege_idint权限 ID
privilege_namevarchar(100)权限名:权限列表
privilege_levelvarchar(100)权限级别
operation_user_idint unsigned操作用户 ID
granted_timetimestamp授权时间
with_grant_optionbool是否允许授权

system_metrics 数据库

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

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

  • collecttime:收集时间。

  • value:采集 metrics 的值。

  • node:表示 MatrixOne 节点的 uuid。

  • role:MatrixOne 节点角色,包括 CN、DN 和 Log。

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

  • type:SQL 类型,可以是 selectinsertupdatedeleteother 类型。

metric

列属性类型描述
metric_nameVARCHAR(128)指标名称,例如:sql_statement_total,server_connections,process_cpu_percent,sys_memory_used 等
collecttimeDATETIME指标数据收集时间
valueDOUBLE指标值
nodeVARCHAR(36)MatrixOne 节点 uuid
roleVARCHAR(32)MatrixOne 节点角色
accountVARCHAR(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_idVARCHAR(36)声明语句唯一 ID
transaction_idVARCHAR(36)事务唯一 ID
session_idVARCHAR(36)账户唯一 ID
accountVARCHAR(1024)租户名称
userVARCHAR(1024)用户名称
hostVARCHAR(1024)用户客户端 IP
databaseVARCHAR(1024)数据库当前会话停留处
statementTEXTSQL 语句
statement_tagTEXT语句中的注释标签 (保留)
statement_fingerprintTEXT语句中的注释标签 (保留)
node_uuidVARCHAR(36)节点 uuid,即生成数据的某个节点
node_typeVARCHAR(64)在 MatrixOne 内,var 所属的 DN/CN/Log 的节点类型
request_atDATETIME请求接受的 datetime
response_atDATETIME响应发送的 datetime
durationBIGINT执行时间,单位:ns
statusVARCHAR(32)SQL 语句执行状态:Running, Success, Failed
err_codeVARCHAR(1024)错误码
errorTEXT错误信息
exec_planJSON语句执行计划
rows_readBIGINT读取总行数
bytes_scanBIGINT扫描总字节数
statsJSONglobal stats info in exec_plan
statement_typeVARCHAR(1024)statement type, val in [Insert, Delete, Update, Drop Table, Drop User, …]
query_typeVARCHAR(1024)query type, val in [DQL, DDL, DML, DCL, TCL]
role_idBIGINTrole id
sql_source_typeTEXTsql statement source type

rawlog

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

列属性类型描述
raw_itemVARCHAR(1024)原日志项
node_uuidVARCHAR(36)节点 uuid,即生成数据的某个节点
node_typeVARCHAR(64)在 MatrixOne 内,var 所属的 DN/CN/Log 的节点类型
span_idVARCHAR(16)span 的唯一 ID
statement_idVARCHAR(36)声明语句唯一 ID
logger_nameVARCHAR(1024)日志记录器的名称
timestampDATETIME时间戳的动作
levelVARCHAR(1024)日志级别,例如:debug, info, warn, error, panic, fatal
callerVARCHAR(1024)产生 Log 的地方:package/file.go:123
messageTEXT日志消息
extraJSON日志动态字段
err_codeVARCHAR(1024)错误日志
errorTEXT错误信息
stackVARCHAR(4096)
span_nameVARCHAR(1024)span 名称,例如:step name of execution plan, function name in code, …
parent_span_idVARCHAR(16)父级 span 唯一的 ID
start_timeDATETIME
end_timeDATETIME
durationBIGINT执行时间,单位:ns
resourceJSON静态资源信息

其他 3 个表(log_infospan_infoerror_info)是 statement_inforawlog 表的视图。

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:当前连接的默认数据库的名称。
  • COMMANDPROCESS 正在执行的命令类型。
  • TIMEPROCESS 的当前执行时长,以秒为单位。
  • 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:存储过程和存储函数的权限。