YMatrix 文档
关于 YMatrix
标准集群部署
数据写入
数据迁移
数据查询
运维监控
参考指南
- MPP 架构
- 镜像分布策略
- 持续聚集
- 滑动窗口
- Grafana 监控指标解读
- Prometheus 监控指标解读
- 术语表
-
工具指南
- mxaddmirrors
- mxbackup
- mxbench
- mxdeletesystem
- mxgate
- mxinitstandby
- mxmoveseg
- mxpacklogs
- mxrecover
- mxrestore
- mxshift
- mxstart
- mxstate
- mxstop
- gpconfig
-
数据类型
-
存储引擎
-
执行引擎
-
系统配置参数
SQL 参考
- ABORT
- ALTER_DATABASE
- ALTER_EXTENSION
- ALTER_EXTERNAL_TABLE
- ALTER_FOREIGN_DATA_WRAPPER
- ALTER_FOREIGN_TABLE
- ALTER_FUNCTION
- ALTER_INDEX
- ALTER_RESOURCE_GROUP
- ALTER_RESOURCE_QUEUE
- ALTER_ROLE
- ALTER_RULE
- ALTER_SCHEMA
- ALTER_SEQUENCE
- ALTER_SERVER
- ALTER_TABLE
- ALTER_TABLESPACE
- ALTER_TYPE
- ALTER_USER_MAPPING
- ALTER_VIEW
- ANALYZE
- BEGIN
- CHECKPOINT
- COMMIT
- COPY
- CREATE_DATABASE
- CREATE_EXTENSION
- CREATE_EXTERNAL_TABLE
- CREATE_FOREIGN_DATA_WRAPPER
- CREATE_FOREIGN_TABLE
- CREATE_FUNCTION
- CREATE_INDEX
- CREATE_RESOURCE_GROUP
- CREATE_RESOURCE_QUEUE
- CREATE_ROLE
- CREATE_RULE
- CREATE_SCHEMA
- CREATE_SEGMENT_SET
- CREATE_SEQUENCE
- CREATE_SERVER
- CREATE_TABLE
- CREATE_TABLE_AS
- CREATE_TABLESPACE
- CREATE_TYPE
- CREATE_USER_MAPPING
- CREATE_VIEW
- DELETE
- DROP_DATABASE
- DROP_EXTENSION
- DROP_EXTERNAL_TABLE
- DROP_FOREIGN_DATA_WRAPPER
- DROP_FOREIGN_TABLE
- DROP_FUNCTION
- DROP_INDEX
- DROP_RESOURCE_GROUP
- DROP_RESOURCE_QUEUE
- DROP_ROLE
- DROP_RULE
- DROP_SCHEMA
- DROP_SEGMENT_SET
- DROP_SEQUENCE
- DROP_SERVER
- DROP_TABLE
- DROP_TABLESPACE
- DROP_TYPE
- DROP_USER_MAPPING
- DROP_VIEW
- END
- EXPLAIN
- GRANT
- INSERT
- LOAD
- LOCK
- REINDEX
- RELEASE_SAVEPOINT
- RESET
- REVOKE
- ROLLBACK_TO_SAVEPOINT
- ROLLBACK
- SAVEPOINT
- SELECT INTO
- SET ROLE
- SET TRANSACTION
- SET
- SHOW
- START TRANSACTION
- TRUNCATE
- UPDATE
- VACUUM
常见问题(FAQ)
-
新架构 FAQ
- 听说 5.x 下不能随便重启 Supervisor 了,为什么,如果重启了会发生什么?
- 为什么每个服务器上都有 Shard / Cluster 服务进程,但只有一个是活跃(active)状态?
- etcd 是部署在每台主机上吗?
- 日常我们需要针对 etcd 做哪些运维操作?
- etcd 的数据量有多大?是否需要特别的运维工作?
- 引入 etcd 后,图形化界面部署数据库集群操作有哪些变化?
- 5.0 现版本如何在线扩容?
- 5.0 beta 号称实现了 Master Auto-failover,为什么 Master 关机并切换后,再开机 Master 不会自动恢复?
- 当故障自动转移(Auto-failover)发生在不同组件,会分别产生什么影响?我要如何进一步操作?
- YMatrix 5 单个组件启动
- 我不想安装 etcd,可以选择在 YMatrix 5.X 上安装无 etcd(非高可用)的集群吗?
- Master 发生自动切换的延迟是多久?
- Segment 是否可以被 supervisor 自动恢复?
- 当半数以上的 etcd 进程异常(被杀死或无法启动)后,集群出现宕机,是正常现象吗?
-
集群部署 FAQ
- error: could not access directory /data/mxdata_20221104084534/master/mxseg-1: Permission denied
- yum 安装 matrixdb 包后报错 cpio read error
- could not connect to server: No route to host
- setuptools 报告不支持参数:unknown distribution option:long_description_content_type
- ssh 默认端口不是 22
- 图形化界面初始化报错:ping <主机名1> error:lookup multiple ip:<IP 地址1>,<IP 地址1> ping <主机名2> error:lookup multiple ip:<IP 地址2>,<IP 地址2>
- 使用图形化界面部署 YMatrix 报错 failed to connect to host=mdw user=mxadmin database=postgres: dial error (dial tcp 192.168.247.132:5432: connect: connection refused)
- 添加主机失败 collect: do collect: unmarshal remote: json: cannot unmarshal string into Go struct field Disk.hardware.disk.ineligibleDesc of type mxi18n.Message
- 集群启动报错
- 图形化部署 YMatrix 报错:优化操作系统配置 ... 已撤销...
- 安装 YMatrix 安装包报错,缺少依赖
- 由于服务器内核参数配置异常导致 Supervisor 启动异常 panic: timeout to start gRPC service
- 安装 YMatrix 收集信息失败
- 初始化失败,报 failed: initialize_database: error execute /opt/ymatrix/matrixdb-5.0.0+enterprise/bin/initdb
- 可以使用 Nginx 为图形化界面配置域名吗?
- Interconnect error writing an outgoing packet: operation not permitted
- 由于环境限制,我没办法使用图形化部署 YMatrix,可以使用命令行部署的方式吗?
- /etc/hosts 文件缺少 localhost 配置选项导致 Supervisor 服务启动异常
- YMatrix 至少需要多少服务器才能实现新架构中 etcd 集群的高可用?
- 安装数据库时报错 LOG: gp_role forced to 'utility' in single-user mode Y.sh: line 1: 11865 Illegal instruction
-
SQL 查询 FAQ
- ERROR: EvalPlanQual can not handle subPlan with Motion node
- ERROR: Too many unresolved insertion xids, please do a vacuum
- ERROR: modification of distribution columns in OnConflictUpdate is not supported
- 图形化客户端收到 log:server closed the connection unexpectedly
- PARTITION 表简单 Filter 操作的 UNION ALL 查询比 IN 查询慢
- 插入 int 类型数据,单独查询跑很快,但放到 Plpgsql Function 里很慢
- PARTITION 分区裁剪更新操作,两个会话(Session)独立更新会导致互锁
- 自定义 type 使用及单表字段扩展
- ERROR,XX000,Right sibling's left-link doesn't match : block 817 links to 45366 instead of expected 70930 in index tab_idx
- 更新删除时报错 cannot delete from table &tablename because it does not have a replica identity and publishes deletes
- ERROR: could not read block 0 in file base/1588803/269422
- 行转列示例
- 列转行示例
- pg_hba.conf 文件内容配置的顺序导致的远程访问权限异常
- idle in transaction timeout 报错
- insufficient memory reserved for statement 报错
- evalplanqual can not hanlde subplan with motion node 报错
- 在客户端创建表在 Linux 上查询不到,但是客户端上可以查询到
- UUID 分布键插入数据出现数据丢失、数据重复问题
- 数据库对应的操作系统版本从 CentOS7 升级到 CentOS8,查询语句性能下降
- 执行 SQL 语句时显示 insufficient memory reserved for statement 错误
- 创建 matrixts 扩展时报错 ERROR: type mxkv_text already exist
-
MatrixGate FAQ
- 数据加载性能低
- failed to acquire resources on on or more segments ,fatal out of memory
- mxgate 发生锁等待卡住
- mxgate 排除某一列
- mxgate 流式加载增加列不停服的办法
- mxgate socket 文件缺失?
- data format error: invalid input syntax for type integer: 1970-01-01 00:00:01
- mxgate 入库时间字段默认值相差 8 小时
- Aborting operation regardless of REJECT LIMIT value, last error was: invalid input syntax for type timestamp: 22:31:01, column batch_num
- ERROR c.s.o.matrixdb.MatrixdbSource 77 -MatrixdbSource sendingPostRequest errorCode: 400, errorMsg: target table name is empty
- responseCode:500 errorMsg: ERROR: invalid byte sequence for encoding UTF8: 0x81
- body size exceeds the given limit
- you license is expired 2022-11-02
- 使用 MatrixGate 迁移数据报错:Cannot start source: --local-ip localhost is not a valid IP address
- 使用 MatrixGate 数据加载表数据存在双引号
- MatrixGate 升级
- MatrixGate 需要加载包含 unix 时间数据的数据文件,但数据文件中 unix 数据所在的字段不是第一个字段
- MatrixGate 加载数据文件中有 \N 字符
- MatrixGate 通过迁移模式写入时出现 Handshaking was terminated on port XXX
- MatrixGate 可以实现任意列时间戳转换吗?
- MatrixGate JAVA SDK JAR 包可以下载到本地导入吗?
- Kafka 消费 key 字段包含 @ 符号,数据解析找不到 value
- mxgate 迁移模式非 mxadmin 用户提示没有权限
-
运维 FAQ
- 忘记密码
- ssh_exchange_identification: Connection closed by remote host
- psql: WARNING: database testdb must be vacuumed within 529926866 transactions (seg35 192.168.247.129:6005 pid=448116)
- could not read block 3684552 of temporary file
- YMatrix 可以修改服务器主机名(Hostname)吗?
- 数据库启动报错 FATAL: database postgres does not exist
- rpc error: code = Unknown desc = primary not found in shard state
- mxaddmirrors 执行部署添加 Mirror 报错
- ERROR: replication slot internal_wal_replication_slot already exists
- ERROR: interconnect Error: Could not set up tcp listener socket
- 使用 mxshift 工具进行迁移之前,如何增加白名单?
- 如果我在内网环境使用 mxshift 工具,需要开通哪些端口?
- index ron requires 19160 bvtes, maximum size is 8191
-
监控告警 FAQ
- 可以离线安装 Grafana 监控吗?
- Grafana 报错 Annotation Query Failed No message available
- Grafana 发送邮件报错 smtp; 554 Reject by behaviour spam at Rcpt State(Connection IP address:***) ANTISPAM_BAT[01201311R106a,ay29a033002195086]: spfcheck failedCONTINUE
-
PXF FAQ
- remote component error,Failed connect to localhost:5888; Connection refused (libchurl.c:950)
- 文件入库时,某一个字段包含换行符,将一行数据切分成两行,再以分隔符切分,就会导致数据与字段数不一致,也就是说一行数据里有两个 \n 一个在中间一个在尾部 但是中间那个不能被当做换行符处理
- PXF 访问 S3 可以递归当前目录,或者所有子目录下的所有文件吗?
- PXF 可以读取 S3 存储上的文件吗?如何读取?
-
PLPython FAQ
- PLPython 和 Python 连接数据库操作的区别与优劣是什么?
- 如何在数据库中使用 PLPython
- PLPython 中如果需要第三方的库怎么安装?
- Python 访问 YMatrix 数据库示例
- Python 批量插入数据示例
- PLPython 中使用 Python 代码
- PLPython 标准异常处理
- 使用 traceback 处理 PLPython 异常
-
性能 FAQ
时序建模思路
本文档为“时序数据建模”章节的第二篇。YMatrix 认为,数据模型的设计会直接影响到数据消费与使用的价值。因此,除技术介绍外,我们尝试通过整个章节使你对时序数据模型(Time-series Data Model)的概念、应用及发展都有清晰的理解。
- 首篇为“时序数据模型是什么?”,通过回答几个层层深入的问题,最终使你对时序数据模型概念本身有清晰的理解。
- 第二篇“时序建模思路”(即此文档)将尝试从理论指导的角度给出 YMatrix 关系模型设计思路参考。
- 第三、四篇为车联网场景及智能家居场景下的数据建模示例,以“时序建模思路”为指导,给出 YMatrix 中不同时序场景的建模最佳实践。
1 首先:了解时序数据模型
在构建属于你的时序数据模型前,请先从此章节首篇文档:时序数据模型是什么?了解 YMatrix 眼中的时序数据模型。
2 其次:了解时序场景需求
YMatrix 认为,了解现有的时序查询特点,即是了解了现有的时序场景需求的核心。一个实际时序场景,通常拥有着综合的查询需求,它可能是下表中几种不同查询需求的集合。下表的应用场景主要以车联网场景为示例。
查询特点 | 描述 | 应用场景 |
---|---|---|
单设备 | ||
单设备点查询 | 查询单个设备某个指标或多个指标在某个时间点的值,最常见的查询是某个设备某些指标的最新值或非空最新值 | 某辆车行驶中的实时车速等 |
单设备明细查询 | 查询某个设备在某个时间区间的明细数据,可能涉及单个指标也可能是多个指标 | 通常为进一步的详细分析,如售后服务中的故障原因分析 |
单设备聚集值 | 查询某个设备的某些指标在某个时间区间的聚集值,譬如最大值、最小值、第一个值、最后一个值、平均值等 | 车辆在某段时间内的平均速度等 |
多设备 | ||
多设备点查询 | 查询多个设备在某个时间点的指标值,可能涉及单个指标也可能是多个指标 | 组合信号查询,状态监测(如车辆油/电量低时启动报警机制);查询指标 a 和 10s 前的指标 b ,看是否匹配,以判断车辆是否处于某种状态(如车辆老化) |
多设备明细查询 | 查询多个设备在某个时间区间的明细数据,可能涉及单个指标也可能是多个指标 | 数据现象发现。如根因分析、新品追踪等。一般面向研发人员 |
多设备聚集值 | 查询多个设备的某些指标在某个时间区间的聚集值,譬如最大值、最小值、第一个值、最后一个值、平均值等,并按照设备分组 | 各区域网络状况检查,求平均网速以确认多个车到达某一地点是否都网络不好 |
其他查询 | ||
多维查询 | 根据标签或属性信息查询符合条件的设备的最新值、明细或聚集值,如果涉及到多个设备,则会按照设备分组 | 监测车辆的当前状态 |
多表关联 | 多表关联查询可以清晰地知晓时序数据的特定含义,多表关联得到的内容可以成为限定某个时序数据含义的定语集合,YMatrix 中通过 JOIN 语句实现这一功能 |
如不同车辆业务表关联分析等 |
高级分析 | 子查询、窗口函数、Cube、CTE、累计和、增量计算、增速计算、变化点、信号跳变差值查询、分位数函数、行列转换、累计分布函数、CASE...WHEN... 表达式、滑动窗口、线性插值、峰值检测、递归查询等 |
特定模式识别、趋势预测、根因分析、阈值修正、异常数据检测、售后故障分析、监控大屏展示、即席分析、电池告警、尖峰值过大告警、异常数据清洗、空值填充、指定设备在指定时间范围内指定指标的 TOP N 峰值等 |
联邦查询 | 访问 MySQL 等数据库、访问 Hive | 部分数据存放在 MySQL 等数据库中,支持和数据库进行关联查询、离线数据存放在 Hive 等系统中,支持和其中数据进行关联查询 |
机器学习 | 线性回归预测 | 根据 1 月 1 日至 10 日的数据,计算线型回归模型,来预测 11 日的指标 |
时空特定查询 | first 函数、last 函数、窗口查询等,有时还会涉及到与空间数据相结合的查询 | 开始油量、结束油量等 |
3 最后:设计时序数据模型
现在,你已经根据你想得到的数据可视化结果,推断出了你所应掌握的时序场景查询需求及数据源(数据采集的源头),可以进入正式的模型设计阶段,恭喜。
综上信息,你大概能估计出该场景的设备数量、数据规模、指标数量、指标数据类型。没错,正是这些因素决定了你的模型设计之路。
3.1 核心判断因素
核心判断因素 | 描述 |
---|---|
设备数量 | 不同场景下的“设备”可能有不同语义,如车联网场景下“一个设备”可能指一辆车,也可能指一个传感器 |
指标类型 | 指标的数据类型。如 int、float、text 等 |
指标数量 | 指标数量或规模 |
YMatrix 认为时序数据建模的三个核心判断因素为:设备数量,指标类型,及指标数量。
设备数量、指标类型、指标数量对于前期模型设计阶段有着不同方面的影响:
- 首先,设备数量、指标类型、指标数量三者都关乎于模型的数据点容纳能力。除此之外,数据采集频率及保存时长对模型容纳能力的评估也有一定的影响。考虑到随着业务的不断发展,其涉及到的设备数量、指标类型和数量都会不断增长,同时不同业务对数据保存时长、采集频率的需求都不同,在前期设计阶段,我们需要对一段时间内时序数据模型的动态容纳能力有充分的预测。
- 其次,指标类型与指标数量前期设计阶段的确定性有多高会直接影响到我们对于宽表 / 宽表变式 / 窄表 / 窄表变式模型的选取。在指标数据类型、指标数量的确定性都较高的情况下,首选宽表及宽表变式模型,因为这样最有利于保持优越的查询性能;在指标数量无法预知,但指标类型确定性较高的情况下,可以使用窄表变式模型;在两者确定性均较低的情况下,可以使用窄表模型,将写入的简便最大化。
3.2 选取时序模型类型
在“数据建模”章节的首篇 什么是时序数据模型? 中我们已详细介绍过非关系模型与关系模型的关系,同时简单介绍了宽表、宽表变式、窄表、窄表变式有何不同。在此篇文档,将着重介绍如何选取具体的模型类型。
3.2.1 数据指标及其类型确定的场景 —— 宽表
使用宽表模型意味着你最终将得到一个包含很多指标名列及指标值列的时序表。根据你拥有的指标数量,宽表可以变得非常宽,正如其名称所示。经过前期的良好设计,宽表查询速度会非常快。在单个表中看到 200 或更多列是很常见的。以下是宽表的一个简单示例:
时间戳 | 设备ID | 温度 | 风力 | 湿度 |
---|---|---|---|---|
2021-11-16 13:57:13 | 1 | 29.2 | 3.2 | 55 |
2021-11-16 13:57:13 | 1 | 21.5 | 8.5 | 35 |
2021-11-16 13:57:13 | 1 | 22.3 | 7.2 | 40 |
2021-11-16 13:57:13 | 2 | 24.1 | 6.8 | 21 |
2021-11-16 13:57:13 | 2 | 19.8 | 2.9 | 38 |
2021-11-16 13:57:13 | 2 | 20.7 | 4.5 | 56 |
...... |
宽表是 YMatrix 的优势模型。其一行承载的数据信息更多,而时间戳、设备 ID 列均只有一个(因为只有一张指标表),这样就减少了冗余。对于创建索引来说,窄表的索引开销很明显,而宽表由于行数少,索引的代价也相对低,利于查询性能。就上述示例而言,假如你想要知道每个设备的相关温度数据,可以通过创建一张可以映射设备和指标关系的 Lookup 表来拆分这些表,实现单设备/部分多设备查询。
那么只有一张表的宽表,对存储的利用已经达到极致了吗?我们认为,这要根据具体业务场景写入空值的情况来判断。值列为空或不为空,主要取决于实际指标数据采集的方式和频率。实际上,在有大量空值数据写入的场景(我们也称之为超宽稀疏表)下,空值数据也占用了相当大的存储空间。
在设计好的宽表模型上增加新的“指标名列 + 指标值列”,或增加新的指标值类型都不算简便,因此宽表前期设计成本相对窄表更高,需要周全地考虑。但一旦有了良好的设计,很大程度上也就收获了后期良好的查询性能。
其主要适用于前期设计阶段数据指标及其类型就已经相对确定的场景,如某些车联网相关场景等。
3.2.2 数据查询频率分级明显 —— 宽表变式
在一些场景中,对于不同指标数据的查询频率有很大差异。此情况下,YMatrix 通过实现结构化 + 半结构化的宽表变式工作流,将被高频查询的数据和被低频查询的数据以不同方式写入表,保护高频数据的查询性能的同时,平衡了低频数据的写入便捷性。所谓“结构化”即关系型数据库中传统宽表的存储方式,“半结构化”则意味着在现有宽表(即将超出最大列数限制)的最后一列使用半结构化的存储方式(JSON / MXKV)存储扩展指标名与指标值数据,以此实现超宽表灵活的扩展性。简单示例如下:
时间戳 | 温度 | 风力 | 湿度 | ...... | 标签 |
---|---|---|---|---|---|
2021-11-16 13:57:13 | 29.2 | 3.2 | 55 | 气象传感器,型号 A,北京市,怀柔区 | |
2021-11-16 13:57:13 | 21.5 | 8.5 | 35 | 气象传感器,型号 A,上海市,崇明区 | |
2021-11-16 13:57:13 | 22.3 | 7.2 | 40 | 气象传感器,型号 A,北京市,海淀区 | |
2021-11-16 13:57:13 | 24.1 | 6.8 | 21 | 气象传感器,型号 B,北京市,怀柔区 | |
2021-11-16 13:57:13 | 19.8 | 2.9 | 38 | 气象传感器,型号 B,上海市,崇明区 | |
2021-11-16 13:57:13 | 20.7 | 4.5 | 56 | 气象传感器,型号 B,北京市,海淀区 | |
...... |
3.2.3 数据指标及其类型不确定的场景 —— 窄表
窄表布局与宽表正好相反,窄表的一个普遍特征是指标值列很少,通常只有一个。以下是一个简单的窄表模型示例:
时间戳 | 设备ID | 指标名 | 指标值 |
---|---|---|---|
2021-11-16 13:57:13 | 1 | 温度 | 29.2 |
2021-11-16 13:57:13 | 1 | 风力 | 3.2 |
2021-11-16 13:57:13 | 2 | 温度 | 21.5 |
2021-11-16 13:57:13 | 2 | 风力 | 8.5 |
...... |
如你所见,窄表模型中除固定的“时间戳 + 标签(设备 ID)”组合外,只有一个指标名列和一个指标值列,指标名列存储了所有的指标名,指标值列存储了所有数据类型相同的指标值。也就是说,如果业务升级需增加指标或设备,只需增加一行数据即可。如果需存储的指标值类型增多,则需要增加相应指标值类型的列或者创建相应的表来存储其他类型。因此就需要改表结构或者创建额外的表。当然,如果你经常使用 JSONB
为值列的数据类型,你也可以选择在此列中存储有效的 JSON
值,不过请注意,这样会同时增加额外的 JSON
解析。
窄表模型在例如泛物联网(IoT)场景智能家居等:前期设计阶段设备数量、类别或指标非常不确定的场景下占有优势。数据存储、写入、模型扩展都很简易,但这需要在指标值类型也相对单一的前提下。因为每增加一个指标值类型,都意味着要新增一张除了指标值外所有列都冗余的表。
3.2.4 指标不确定但其类型确定的场景 —— 窄表变式
在某些实际场景中,指标值的数据类型会随着业务需求不断增加。对于这种情况,传统的窄表模型只能通过增加表数量的方式实现扩展。显然,此种方法是很大有局限的。因此,我们可以设计一个窄表的变式:其尺寸介于窄表和宽表之间,基本设计原则是为每种必要的数据类型都创建一列。也就是说,如果我们有两种不同的数据类型:整数和浮点数(假设为 float8)。那么我们最终会得到两个不同的值列,如下所示:
时间戳 | 设备ID | 指标名 | 指标值_int | 指标值_float |
---|---|---|---|---|
2021-11-16 13:57:13 | 1 | 温度 | 29.2 | |
2021-11-16 13:57:13 | 1 | 风力 | 3.2 | |
2021-11-16 13:57:13 | 1 | 湿度 | 55 | |
2021-11-16 13:57:13 | 2 | 温度 | 21.5 | |
2021-11-16 13:57:13 | 2 | 风力 | 8.5 | |
2021-11-16 13:57:13 | 2 | 湿度 | 35 | |
...... |
使用这种设计,常常需要另外再建一张查找表(Lookup)。
指标名 | 数据类型列名 |
---|---|
温度 | 指标值_float |
风力 | 指标值_float |
湿度 | 指标值_int |
写入或查询具体指标值时,便可通过 JOIN
语句连接两张表来定位数据位置。
如果你需要更多指标值类型,添加更多列即可。与提前了解所有可能的指标相比,提前了解所有可能的指标值类型相对容易一些,同时也需要知道指标值类型和指标的映射关系。
注意!
具体场景下的模型构建示例请见车联网场景下的数据建模示例及 智能家居场景下的数据建模示例。