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 时序场景是如何产生的?
信息时代的世界正在以惊人的速度发生变化,这离不开人类对于数据的捕获、分析和利用。地图导航软件、街头的监控摄像头以及供暖公司,每天都通过精准的数据统计为我们的生活服务。但随着科技发展及生活节奏的不断加快,我们不只想知道要前往的地点在哪、怎么走,还想随时了解哪条路通畅,以避开堵塞的路径;政府为保护人民安全监控公共区域,而我们也想买到一款实时健康监测设备,为保障自己的健康而对身体进行实时监测。它必须轻便易携,最好还具有时尚的外观;供暖公司也已不满足于了解一个月内的建筑平均日温度(MDT)变化,而是想要加入智慧城市的发展行列,通过每小时的气温、风速、降水量变化等更精准地提高自身物业建模和优化能源效率的能力......
显然,只进行较长时间周期内的数据统计显然已无法满足人类越发“贪婪”的需求,详细的、功能丰富的数据已成为我们这个信息匮乏的世界中最有价值的商品之一。而在分析需求的过程中,我们认识到这些场景的核心都离不开一种类型的数据:它与时间强相关,来源于各种设备;它随着时间推移不断积累,具有丰富的利用价值;它的体积极大,轻松可达到 TB 甚至 PB 级别,对数据库底层存储性能要求极高。
据其本质特征,早期的学者将它称作:时序数据。
2 时序数据是什么?
毋庸置疑,时序数据(Time-series Data)是充满变化的,它是业务系统中正在发生的、无限时长的动态电影。它具有丰富而强大的利用价值,不仅可以为企业降本增效提质,还可以为奋斗中的理想者找到合适的开拓方向。在当下,拥有并充分利用它的人才可以说是占领了时代的先机。
具体而言,YMatrix 认为时序数据主要由以下部分构成:
- 标签(Tag):某些静态属性,即不会受时间流逝影响的固定属性。譬如冰箱品牌、设备编号、产地、购买地、出厂时间等。
- 指标(Metric):某些动态属性,即会随时间流逝不断变化的属性。譬如冰箱的温度、湿度、耗电量等。有时候指标也称测点,即可测量的点。
- 时间戳(Timestamp):某个时间点的值,譬如
2023-02-10 20:00:00
。 - 数据点(Point):某个时间时刻某个指标的值,譬如海尔冰箱在 20:00 的温度数据是
6.2
。
综上,我们可以总结出 YMatrix 中时序数据的定义:即时间序列数据,表示与时间强相关的有顺序的一系列数据。应用中通常表现为指标数据在不同时间点采集到的一系列数据点。
时序数据可以跟踪不同时间间隔单位的变化,如毫秒、天甚至年,具有强大的洞察力。我们认为,无论场景或用例如何,所有时间序列数据集都有几个共同点:
-
采集到的数据总是记录为一个新行。
-
数据通常按时间顺序到达数据库。
-
时间是主轴(时间间隔可以是规则的或不规则的)。
-
实效性。越新的时序数据价值越大,价值密度随时间推移而逐渐降低。
-
可降采样。降采样即使用 GROUP BY 语句将原始数据按更宽广的时间间隔分组,并统计出每组数据的关键特征信息。降采样不仅可以降低存储开销,还能保留关键数据特征,便于分析数据的历史趋势,预测未来趋势等。
-
需与关系数据结合才具价值。没有结构化的关系数据提供上下文信息,时序数据就只是一个数字。我们需要充分的结构化信息来对一个数字进行表述。譬如对于一个值为 36.5 的数据点,我们需要理解,它是温度、湿度还是压强?其单位是摄氏度还是帕斯卡?其来源是锅炉、传送带还是轴承?设备位于厂房一区还是二区?等等。关联信息越丰富的数据,其价值常常也更高。
那么时序场景与传统 OLTP(Online Transactional Processing)、OLAP(Online Analytical Processing)场景又有何不同呢? 我们以一个表格来说明:
业务场景 | 数据操纵语句(DML) | 写入方式 | 查询需求 | 并发度 |
---|---|---|---|---|
时序 | INSERT / Appendly-only | 高频流式写入 | 基于时间的点查、明细、聚集;关联分析、复杂分析 | 高并发 |
OLTP | INSERT / UPDATE / DELETE | 高频写入 | 点查 | 高并发 |
OLAP | INSERT / 少量 UPDATE / 少量 DELETE | 低频批量写入(ETL) | 关联、聚集 | 低并发 |
3 时序数据模型是什么?
就时序数据库的开发而言,数据模型是其组织数据的模式,是暴露给用户的接口。用户必须要了解将要使用的数据库基于什么数据模型构建,才能知晓如何使用该库。也就是说,数据库选择建模和存储数据的方式决定了你可以使用它做什么。
就用户使用而言,数据模型则更偏向于定义表元信息的最佳实践,是一个需要根据业务需求事先设计的建模动作。
据统计,时序数据库已成为全球增长最快的数据库类型。
专门为时序场景与时序数据服务的时序数据库在刚刚诞生时,为追求数据规模的快速扩大,大部分以非关系型(Non-relational)数据模型为基础设计构建。但到了今天,随着用户对于时序数据的消费需求逐步深入,非关系数据库的查询性能在很多场景已不足以满足业务层面的使用,无统一的标准接口导致开发人员的学习成本也不断升高,需通过业务层面不断修改程序来满足需求。与此同时,分布式数据库发展蓬勃,使得本来写入性能相对薄弱的关系型数据库有了质的提升。因此,浪潮又逐渐回归了关系型(Relational)数据模型,YMatrix 也在此浪潮之中。
我们同意,长期看来,将所有数据保存在一个系统中必定会大大减少应用程序开发时间、成本,并加快你做出关键决策的速度。
3.1 非关系模型还是关系模型?
在时序数据模型的开发设计方面,存在着两种截然不同的观点:
- 无需设计表模式的(Schemaless)非关系型数据模型,代表有非关系型时序数据库 InfluxDB、OpenTSDB 等。
- 需前期设计表模式的关系型数据模型,代表有关系型时序数据库 TimescaleDB、YMatrix 等。
实际上,以上两种模型在时序数据库的发展历程中都发挥了非常重要的作用。起初,由于时序数据极快的积累速度,早期开发人员认为传统的关系模型很难承载此类规模的大数据集,而数据入口简易的非关系型数据模型则在规模承载上表现更佳。因此,时序数据库以非关系型模型发展起来。
非关系型数据库产品如 InfluxDB 决心自我挑战,从零开始写数据库,凭借着其在运行速度、规模扩大等方面的优势取得了很好的初步成果。但是随着业务需求的不断变化、发展,广大数据消费者逐渐发现一开始非关系库吸引自己的低门槛儿(通常其不需要过多进行前期的数据模型设计,可以快速上手开始业务),在系统越发壮大、复杂后也越发难以掌控。由于没有通用的查询语言,无论是数据库的开发还是运维人员,都必须要补上这份“技术债务”,甚至还要自学更加高阶的编程语言来实现更多、更复杂的查询和运维需求。
越来越昂贵的成本与越来越窄的用户接口,使得非关系时序库的用户难以负担,开始试图回归关系库(关系库中数据库本身的“负担”逐渐加重,而人逐渐从运维重担中解脱出来),并且发展成为了一个浪潮。
我们这里说的“回归”,并非是一种数据库技术的回退,而是在传统关系库基础上设计新的、符合时序场景特征的变式。例如下文将“结构化”与“半结构化”相结合的的宽表变式。
3.2 窄表还是宽表?
由于时序应用旨在存储大量与时间相关的信息,对底层数据存储进行数据建模是必不可少的。 关系数据模型以关系数据表的外化形式描述信息。
由于 YMatrix 以关系数据模型为基础构建,所以你可以通过多种方式设计分区表的 DDL(或泛称表的 Schema)。一般来说,有两个主要的存储模式:窄表(Narrow)和宽表(Wide)。
- 窄表:窄表的一个普遍特征是指标值列很少,通常一行只有一个数据点。一个时间戳、一个标签、一个指标就共同定位了一个唯一的数据点。其最大的优势是易于上手,易于扩大。劣势则是冗余成本高,造成空间开销大,并牺牲了一定的查询性能。
- 宽表:宽表恰好与窄表相对,设计一张宽表,意味着表中拥有大量指标列及指标值列,即一行有多个数据点,这些数据点共享同一组“时间戳 + 设备标签”。这些指标值有可能为空或不为空,主要根据数据采集的方式和频率决定。虽需要一定的准备工作进行前期设计,但其查询性能极其优越,可最大程度地发挥出数据的潜能。
- 窄表变式:在某些实际场景中,指标值的数据类型会随着业务需求不断增加。对于这种情况,传统的窄表模型只能通过增加表数量的方式实现扩展。显然,此种方法是很大有局限的。因此,我们可以设计一个窄表的变式:其尺寸介于窄表和宽表之间,基本设计原则是为每种必要的数据类型都创建一列。即一行有多个不同数据类型的数据点。其优势是上手方便,非常适合预期指标类型,及预期指标类型与指标的映射关系较为确定的场景。
- 宽表变式:在 YMatrix 中,我们还会采用一种方式来尽量兼顾宽、窄表模型的优势。即在传统宽表的基础上,只将最后一列设定为“JSON / MXKV 列”,将超出传统宽表承载力(来自上游 PostgreSQL 数据库建表的 1600 列限制)的指标、类型或低频查询的指标及其数据都存储在这一扩展列,实现关系库中宽表模型的灵活变式。
窄表 | 宽表 | 窄表变式 | 宽表变式 | |
---|---|---|---|---|
前期设计成本 | 低 | 较高 | 较低 | 较高 |
扩展难度 | 容易 | 较复杂 | 较容易 | 较容易 |
空间开销 | 大 | 小 | 较大 | 小 |
查询性能 | 低 | 高 | 较低 | 高 |
注意!
宽表、窄表、窄表变式、宽表变式详细介绍请见 时序建模思路;具体场景下的模型构建示例请见车联网场景下的数据建模示例及 智能家居场景下的数据建模示例。