修复分区列

greptime cli meta repair partition-column 命令可用于修复 GreptimeDB 集群的分区列。

何时使用此工具

在 PR-6494 之前，表元数据中的分区列可能会引用到无效的列。例如，当在分区列之前向表中添加新列时，可能会导致分区列偏移。

如果你发现由于分区列错误导致读取或写入失败，可以使用此工具。该工具将扫描所有表的元数据，并将分区列设置为正确的列。

命令语法

greptime cli meta repair partition-column [OPTIONS]

选项

选项	描述	默认值	值
--store-addrs <STORE_ADDRS>	元数据的存储后端地址。可以是 etcd、postgres 或 mysql 之一。 对于 postgres 存储，格式为："password=password dbname=postgres user=postgres host=localhost port=5432"。 对于 etcd 存储，格式为："127.0.0.1:2379"。 对于 mysql 存储，格式为："mysql://user:password@ip:port/dbname"		字符串
--backend <BACKEND>	元数据存储后端类型	etcd-store	以下其一： etcd-store memory-store postgres-store mysql-store
--max-txn-ops <MAX_TXN_OPS>	事务中的最大操作数。仅在使用 etcd-store 时使用。	128	数字
--store-key-prefix <STORE_KEY_PREFIX>	元数据存储的键前缀	""	字符串
--meta-table-name <META_TABLE_NAME>	RDS 中存储元数据的表名。仅在使用 postgres-store 或 mysql-store 时使用。	greptime_metakv	字符串
--meta-schema-name <META_SCHEMA_NAME>	元数据表所在的 PostgreSQL schema，必须与 Metasrv 的 meta_schema_name 配置一致。未设置时使用连接的 search_path。仅在后端为 postgres-store 时使用。		字符串
--backend-tls-mode <BACKEND_TLS_MODE>	连接元数据存储（etcd、PostgreSQL 或 MySQL）的 TLS 模式，需与元数据存储的 TLS 要求一致。	disable	以下其一： disable prefer require verify-ca verify-full
--backend-tls-cert-path <BACKEND_TLS_CERT_PATH>	连接元数据存储时使用的客户端证书文件路径。	""	字符串
--backend-tls-key-path <BACKEND_TLS_KEY_PATH>	连接元数据存储时使用的客户端私钥文件路径。	""	字符串
--backend-tls-ca-cert-path <BACKEND_TLS_CA_CERT_PATH>	连接元数据存储时使用的 CA 证书文件路径。	""	字符串
--dry-run	只报告无效的分区列，不修改表元数据。执行修复前可先使用此选项检查拟进行的更改。	false	flag
--update-limit <N>	该工具对表元数据执行更改的最大次数。此选项可用于逐步更新表元数据。	无限制	数字

示例

greptime cli meta repair partition-column \
    --store-addrs=$ENDPOINT \
    --backend=postgres-store \
    --dry-run \
    --update-limit 1