PTK 元数据

PTK 在安装时会在安装用户的家目录下自动创建一个元数据目录 $HOME/.ptk，用于存放 PTK 运行所需的数据，请谨慎操作该目录下的文件。

查看元数据目录

PTK 自 v0.6 开始可通过 ptk meta home 获取 PTK 的元数据目录位置，便于集成到三方脚本或系统中调用。

PTK 的元数据目录默认是在执行用户的家目录下的 .ptk 文件夹，但用户可以通过环境变量 PTK_HOME 进行自定义路径。PTK本身是无状态的，指定不同的 PTK_HOME 所能看到的集群是不同的。

清理失效的集群元数据

正常情况下，整个数据库的生命周期都是通过PTK进行管理的话，集群的元数据无需用户关心的。

但在某些场景下，比如用户通过PTK创建了一个集群，但这个集群的实例或数据被其他用户或程序删除掉了，此时在PTK来看，该集群还存在，但实际已经无法通过PTK管理了，属于脏数据。

对于这种情况，PTK 提供了 meta prune 指令来进行对于元数据的清理:

ptk meta prune -n <CLUSTER_NAME> [--force]

另外，可以看到指令提供了 --force 选项，正常情况下集群存在的时候，PTK 是不允许清理元数据的。但如果用户确实想要清理掉元数据，以后不再使用 PTK 对指定的集群进行管理，可通过 --force 参数强行清理掉元数据。

元数据导出和合并

PTK 在不同的用户下安装是分别独立的两个实例，互相是无法看到对方管理的集群的，如果想要将两个用户下的PTK实例合并的话，可通过导出元数据，然后再通过合并元数据来将两个PTK实例合并到一个用户下管理。

操作步骤

1. 导出元数据

   在要导出元数据的PTK所在用户下执行如下命令，执行后会生成一个 gzip 格式的的压缩包 ptk_meta_*.tar.gz

   ptk meta dump --all

2. 合并元数据

   登录想要合入的PTK实例所在用户，将上一步生成的元数据压缩包上传到该用户下，然后执行以下命令合并

   ptk meta merge -p <ptk_meta_*.tar.gz>