跳到主要内容
版本：1.1

资源标识（ID）管理

资源标识（ID）管理主要用于在从元数据备份恢复集群时，手动设置资源标识（如表 ID）。这是因为备份文件可能未包含最新的待分配表 ID值，如果不及时重置，可能会导致资源冲突或数据不一致。

理解表 ID 及 待分配表 ID 的关系​

在 GreptimeDB 中：

  • 表 ID：每个表都有一个唯一的数字标识符，用于数据库内部识别和管理表
  • 待分配表 ID（Next Table ID）：系统预留的下一个可用的表 ID 值。当创建新表时，系统会自动分配这个 ID 给新表，然后将待分配表 ID递增

举例说明：

  • 假设当前集群中已有表 ID 为 1001、1002、1003 的表
  • 此时待分配表 ID应该是 1004
  • 当创建新表时，系统分配 ID 1004 给新表，并将待分配表 ID更新为 1005
  • 如果从备份恢复时，待分配表 ID仍然是 1002，就会与现有表 ID 1002、1003 产生冲突（通常你会在 Datanode 启动时遇到 Region 1024 is corrupted, reason: 的错误）

通常情况下，资源标识（ID）由数据库自动维护，无需人工干预。但在某些特殊场景下（如从元数据备份恢复集群，且备份后集群又创建了新表），备份中的待分配表 ID可能已经落后于实际集群状态，此时需要手动调整。

如何判断是否需要手动设置待分配表 ID：

  1. 查询当前集群中所有表的 ID：SELECT TABLE_ID FROM INFORMATION_SCHEMA.TABLES ORDER BY TABLE_ID DESC LIMIT 1;
  2. 通过 API 获取当前的待分配表 ID（见下方接口说明）
  3. 如果现有表 ID 的最大值大于等于当前的待分配表 ID，则需要手动设置待分配表 ID为一个更大的值。通常为现有表 ID 的最大值加 1。

你可以通过 Metasrv 的 HTTP 接口获取或设置待分配的表 ID：http://{METASRV}:{HTTP_PORT}/admin/sequence/table/next-id（获取）和 http://{METASRV}:{HTTP_PORT}/admin/sequence/table/set-next-id（设置）。请注意，此接口监听 Metasrv 的 HTTP_PORT，默认为 4000。

设置待分配的表 ID​

要安全地更新待分配的表 ID，请按照以下步骤操作：

  1. 阻止新的 procedure 提交 - 暂停 Procedure Manager，新提交的 procedure 会被拒绝，建表也在其中。已经受理的 procedure 不会被挂起或取消，它们及其子 procedure 会继续执行完毕。详见阻止元数据变更。

  2. 等待在途 procedure 结束 - 轮询直到没有仍在进行的 procedure：

    SELECT procedure_id, procedure_type, status
    FROM INFORMATION_SCHEMA.PROCEDURE_INFO
    WHERE status IN ('Running', 'Retrying', 'PrepareRollback', 'RollingBack');

    查询返回空结果后方可继续。Done、Failed、Poisoned 等终态不在筛选范围内：这些 procedure 已经执行结束并释放了锁，只是记录会保留到后台清理为止。若等待超出预期仍有 procedure 在运行，请停止操作排查原因，不要继续修改 sequence。参见 PROCEDURE_INFO。

  3. 启用集群恢复模式 - 设置待分配的表 ID只允许在恢复模式下进行。详情请参阅集群恢复模式。

  4. 设置待分配的表 ID - 通过 HTTP 接口设置待分配的表 ID。

  5. 重启 metasrv 节点 - 这确保新的待分配的表 ID被正确设置。重启后先确认恢复模式与 Procedure Manager 的暂停状态均未改变，再验证新的待分配的表 ID。

  6. 禁用集群恢复模式 - 随后恢复 Procedure Manager，集群回归正常运行。

注意

恢复模式本身并不阻止 DDL，它只是 set-next-id 接口的前置条件，同时放宽 Datanode 的启动检查。真正阻止新元数据变更的是暂停 Procedure Manager。

通过发送 POST 请求到 /admin/sequence/table/set-next-id 端点设置待分配的表 ID：

curl -X POST 'http://localhost:4000/admin/sequence/table/set-next-id' \
  -H 'Content-Type: application/json' \
  -d '{"next_table_id": 2048}'

预期输出（next_table_id 可能不同）：

{"next_table_id":2048}

获取待分配的表 ID​

curl -X GET 'http://localhost:4000/admin/sequence/table/next-id'

预期输出（next_table_id 可能不同）：

{"next_table_id":1254}