1. 引擎扩容
引擎扩容可以分为纵向和横向扩容两种方式。纵向扩容是指增加单台机器的segment数量。横向扩容是指增加机器数量,每台机器的segment数量保持不变。下面详细介绍在HENGSHI SENSE上如何使用上述两种方式进行引擎扩容。
1.1. 扩容前现有系统准备工作
扩容前请完成如下准备工作
- 停止HENGSHI以及其他会使用引擎的服务。
${HENGSHI_HOME}/bin/hengshi-sense-bin stop hengshi
清理数据膨胀 分为下面两种场景
- 日常还没有通过crontab运行
${HENGSHI_HOME}/bin/clean_engine.sh -t -r
的情况。- 需要在非工作时间,先跑一次
${HENGSHI_HOME}/bin/clean_engine.sh -t -r -f
这个过程根据实际情况不同,等待的时间不同,通常以小时为单位计算时间。 - 然后配置上每日凌晨执行
${HENGSHI_HOME}/bin/clean_engine.sh -t -r
。
- 需要在非工作时间,先跑一次
- 日常配置了通过crontab运行
${HENGSHI_HOME}/bin/clean_engine.sh -t -r
的情况。- 需要在非工作时间,跑一次
${HENGSHI_HOME}/bin/clean_engine.sh -t -r -f
。
- 需要在非工作时间,跑一次
- 日常还没有通过crontab运行
登录引擎,修改localhost类的地址为能区分不同机器的域名 通过把
gp_segment_configuration
表中hostname
和address
两个字段本机的域名和地址修改成局域网内可区分不同机器的域名和地址
例如查询当前环境:
$ psql
psql (9.4.24)
Type "help" for help.
hengshi=# select * from gp_segment_configuration ;
dbid | content | role | preferred_role | mode | status | port | hostname | address | datadir
------+---------+------+----------------+------+--------+------+-----------------+-----------------+--------------------------------------------------------------
1 | -1 | p | p | n | u | 5232 | localhost | localhost | /home/data/engine-cluster/data/SegDataDir-1
2 | 0 | p | p | n | u | 5233 | localhost | localhost | /home/data/engine-cluster/data/SegDataDir0
(2 rows)
- greenplum6
psql (9.4.24)
Type "help" for help.
set allow_system_table_mods='true';
update gp_segment_configuration set address = '<real_ip>' where address = localhost';
update gp_segment_configuration set hostname = '<real_hostname>' where hostname = 'localhost';
- greenplum5
$ psql
psql (8.3)
Type "help" for help.
set allow_system_table_mods='DML';
update gp_segment_configuration set address = '<real_ip>' where address = localhost';
update gp_segment_configuration set hostname = '<real_hostname>' where hostname = 'localhost';
1.2. 增加机器扩容
1.2.1. 扩容前新机器准备工作
横向扩容前需要在新机器上进行如下准备工作。
请参考引擎新节点环境准备完成新节点准备工作。
1.3. GP 扩容
1.3.1. 清理历史扩容 schema
对于曾经执行过扩容操作的集群,可能会由于操作遗漏留存有上次扩容的 schema,这种情况需要先清理干净,否则会造成扩容失败
source /opt/hengshi/engine-cluster/export-cluster.sh
psql postgres -c '\dn'
若存在 gpexpand
名字的 schema,则需要清理
source /opt/hengshi/engine-cluster/export-cluster.sh
gpexpand -c
清理后查看是否清理干净(重复上述 psql postgres -c '\dn' 的方法),若未清理干净可选择手工清理
source /opt/hengshi/engine-cluster/export-cluster.sh
psql postgres
drop view gpexpand.expansion_progress;
drop table gpexpand.status;
drop table gpexpand.status_detail;
drop schema gpexpand;
1.3.2. 扩容操作
扩容分为无镜像扩容和有镜像扩容。
无镜像扩容
生成扩容配置文件
- 先准备一个new-host文件,里面写上新增的 hostname,请不要重复。 如果无新增host就用空文件,参考下面示例为集群中新增一台 hostname 为
engien2
的机器
engine2
- 执行下面命令生成扩容配置文件。示例中包含了greenplum-6和greenplum-5两种扩容命令,执行时请根据环境选择对应的命令。
cd /opt/hengshi
source engine-cluster/export-cluster.sh
# for greenplum-6
gpexpand -f new-host
# for greenplum-5
psql -c 'create database gpexpand_schame_db' # greenplum 临时存储schema的数据库, 可以临时建立一个
gpexpand -f new-host -D gpexpand_schame_db
- 根据提示填写信息,生成扩容配置文件。
Would you like to initiate a new System Expansion Yy|Nn (default=N): #回答 'y'
Are you sure you want to continue with this gpexpand session? Yy|Nn (default=N): #回答 'y'
How many new primary segments per host do you want to add? (default=0): #增加新机器回答 '0'; 现有机器上增加segment数量则回答增量数,比如每台增加2个segment就回答 '2'
Enter new primary data directory 1: #填写数据目录的根目录,比如现有目录 /opt/hengshi/engine-cluster/data/SegDataDir-1, 则回答 '/opt/hengshi/engine-cluster/data'
Enter new primary data directory 2: #填写数据目录的根目录,比如现有目录 /opt/hengshi/engine-cluster/data/SegDataDir-1, 则回答 '/opt/hengshi/engine-cluster/data'
等待执行结果,示例中 gpexpand_inputfile_20210806_121646就是生成的扩容配置文件。
Generating configuration file...
20210806:12:16:46:744854 gpexpand:m86:lvliang-[INFO]:-Generating input file...
Input configuration file was written to 'gpexpand_inputfile_20210806_121646'.
Please review the file and make sure that it is correct then re-run
with: gpexpand -i gpexpand_inputfile_20210806_121646
20210806:12:16:46:744854 gpexpand:m86:lvliang-[INFO]:-Exiting...
- 配置文件格式说明。
<hostname>|<address>|<port>|<datadir>|<dbid>|<content>|<preferred_role>
其中preferred_role值是p或m,决定这个segment是主节点还是镜像,p表示主节点,m表示镜像。
假设现有两台机器,分别是engine1、engine2,每台机器有1个segment,现在每台机器上新增一个segment,文件命名为 gpexpand_inputfile,则配置文件内容如下。
engine1|engine1|25433|/opt/hengshi/engine-cluster/data/SegDataDir1|4|2|p
engine2|engine2|25433|/opt/hengshi/engine-cluster/data/SegDataDir2|5|3|p
执行扩容
执行如下命令进行扩容,扩容过程中需要使用上一步生成的gpexpand_inputfile_xxxxxxxx_xxxxxx文件。
source /opt/hengshi/engine-cluster/export-cluster.sh
# for greenplum-6
gpexpand -i gpexpand_inputfile_xxxxxxxx_xxxxxx
# for greenplum-5
gpexpand -i gpexpand_inputfile_xxxxxxxx_xxxxxx -D gpexpand_schame_db #上面生成扩容配置文件时新建的db
说明:
greenplum-6扩容期间,会在postgres下面新建一个 gpexpand schema。
greenplum-5扩容期间, 使用我们手工建立并指定的 gpexpand_schame_db数据库来存储扩容期间的schema信息。
修改旧节点配置以便脚本正常使用
- conf/engine-master-hosts和conf/engine-segment-hosts都改成最新的非localhost的地址
验证扩容后集群是否正常工作
首先挑选集群内存在的一张数据表
source /opt/hengshi/engine-cluster/export-cluster.sh;
psql hengshi;
DROP TABLE IF EXISTS test_redistribution;
CREATE TABLE test_redistribution WITH (APPENDONLY = true, ORIENTATION = COLUMN, COMPRESSTYPE = zlib, COMPRESSLEVEL = 5) as select * from <DATA_TABLE> DISTRIBUTED RANDOMLY;
select <col1>, count(<col2>) from test_redistribution group by <col1>; -- 这一步正常返回统计结果则集群正常
DROP TABLE IF EXISTS test_redistribution;
以上 sql 中,若查询语句 select <col1>, count(<col2>) from test_redistribution group by <col1>;
正常返回了结果,没有卡主或报错,则说明集群正常
Redistributing Tables。
注意:
扩容后,新的表会分布到所有的segment上,但扩容前的表不会自动redistributing。
执行 Redistributing Tables,数据量越大,时间也就越长,建议在空闲时期执行,如果时间太长可以使用-d/-e,具体参考 gpexpand。
参考 Redistributing Tables 获取更详细的信息。
- 自动重分布 自动重分布会对所有表做操作,耗时可能会非常久。所以如果大部分的表有定期的全量更新,也可以针对重点表手工先重分布,然后等业务流程自动全量更新刷新其余的表。
source /opt/hengshi/engine-cluster/export-cluster.sh
gpexpand
- 手工操作,挑大表重分布
create table schema.<NAME>_tmp WITH (APPENDONLY = true, ORIENTATION = COLUMN, COMPRESSTYPE = zlib, COMPRESSLEVEL = 5) as select * from schema.<NAME> DISTRIBUTED RANDOMLY;
drop table schema.<NAME>;
alter table schema.<NAME>_tmp rename to <NAME>;
移除扩容生成的schema
source /opt/hengshi/engine-cluster/export-cluster.sh
gpexpand -c
有镜像扩容
有镜像的扩容与无镜像的扩容,差别在配置扩容输入文件中需要添加镜像的配置文件,其他步骤相同。
配置文件示例,假设现在有两台机器,分别是engine1和engein2,每台有1个segment,每个segment有1个mirror,新增一个segment,每个segment有1个镜像,则配置如下。
engine1|engine1|25434|/opt/hengshi/engine-cluster/data/SegDataDir1|6|2|p
engine2|engine2|25434|/opt/hengshi/engine-cluster/mirror/SegDataDir1|7|2|m
engine2|engine2|25435|/opt/hengshi/engine-cluster/data/SegDataDir2|8|3|p
engine1|engine1|25435|/opt/hengshi/engine-cluster/mirror/SegDataDir2|9|3|m
1.4. 回滚
如果在引擎扩容的过程中出现了错误,则需要进行回退。参考下面示例中的代码进行还原操作。
cd /opt/hengshi
source engine-cluster/export-cluster.sh
gpexpand -r
results matching ""
No results matching ""
衡石文档
- 产品功能一览
- 发布说明
- 新手上路
- 安装与启动
- 系统管理员手册
- 数据管理员手册
- 分析人员手册
- 数据查看员手册
- API
- 最佳实践
- 衡石分析平台 API 手册
- 附录