ADMIN COPY TABLET
更新时间：2025-10-15
描述
该语句用于为指定的 tablet 制作快照，主要用于本地加载 tablet 来复现问题。
语法
SQL
1ADMIN COPY TABLET <tablet_id> PROPERTIES ("<key>"="<value>" [,...]).必选参数
1. <tablet_id>
要复制的 tablet 的 ID。
可选参数
SQL
1[ PROPERTIES ("<key>"="<value>" [, ... ]) ]PROPERTIES 子句允许指定附加参数：
1. <backend_id>
指定副本所在的 BE 节点 ID。如果未指定，则随机选择一个副本。
2. <version>
指定快照的版本。版本必须小于或等于副本的最大版本。如果未指定，则使用最大版本。
3. <expiration_minutes>
快照的保留时间。默认为 1 小时，超时后会自动清理。单位为分钟。
返回值
| 列名 | 类型 | 说明 |
|---|---|---|
| TabletId | string | 为该 tablet 创建的快照的 ID。 |
| BackendId | string | 存储该快照的 BE 节点的 ID。 |
| Ip | string | 存储该快照的 BE 节点的 IP 地址。 |
| Path | string | 快照在 BE 节点上的存储路径。 |
| ExpirationMinutes | string | 快照将自动删除的时间（单位：分钟）。 |
| CreateTableStmt | string | 对应 tablet 的表创建语句。此语句不是原始的建表语句，而是用于后续加载该 tablet 到本地的简化建表语句。 |
权限控制
执行此 SQL 命令的用户必须至少拥有以下权限：
| 权限 | 对象 | 说明 |
|---|---|---|
| Admin_priv | Database | 执行数据库管理操作所需的权限，包括管理表、分区以及系统级命令等操作。 |
示例
-
为指定 BE 节点上的副本创建快照
SQL1ADMIN COPY TABLET 10020 PROPERTIES("backend_id" = "10003");Text1 TabletId: 10020 2 BackendId: 10003 3 Ip: 192.168.10.1 4 Path: /path/to/be/storage/snapshot/20220830101353.2.3600 5ExpirationMinutes: 60 6 CreateTableStmt: CREATE TABLE `tbl1` ( 7 `k1` int(11) NULL, 8 `k2` int(11) NULL 9) ENGINE=OLAP 10DUPLICATE KEY(`k1`, `k2`) 11DISTRIBUTED BY HASH(k1) BUCKETS 1 12PROPERTIES ( 13"replication_num" = "1", 14"version_info" = "2" 15); -
为指定 BE 节点上指定版本的副本创建快照
SQL1ADMIN COPY TABLET 10010 PROPERTIES("backend_id" = "10003", "version" = "10");Text1 TabletId: 10010 2 BackendId: 10003 3 Ip: 192.168.10.1 4 Path: /path/to/be/storage/snapshot/20220830101353.2.3600 5ExpirationMinutes: 60 6 CreateTableStmt: CREATE TABLE `tbl1` ( 7 `k1` int(11) NULL, 8 `k2` int(11) NULL 9) ENGINE=OLAP 10DUPLICATE KEY(`k1`, `k2`) 11DISTRIBUTED BY HASH(k1) BUCKETS 1 12PROPERTIES ( 13"replication_num" = "1", 14"version_info" = "2" 15);