tencent cloud

TDSQL Boundless

查看数据加载状态

下载
聚焦模式
字号
最后更新时间: 2026-06-18 15:55:12

操作场景

将数据加载到分析引擎后,需要确认数据是否可查询。TDSQL Boundless 提供 SHOW REPLICATION TABLES 命令和 information_schema.LIBRA_TABLE_STATUS 系统视图,帮助您查看数据对象的加载状态。只有当表的 AVAILABLE 字段为1时,才表示该表数据已就绪,可通过分析引擎进行查询。

前提条件

查看数据加载状态

方法1:通过控制台查看

1. 登录 TDSQL Boundless 控制台,在实例列表中,单击目标实例 ID,进入实例详情页面。
2. 实例架构图区域,单击只读分析引擎实例 ID,进入只读分析引擎详情页面。

3. 在只读分析实例详情页面,在数据对象页签,查看对象信息,通过对象信息可了解各数据表的加载状态。

控制台显示的对象信息字段说明如下:
参数
说明
数据库名
数据对象所属的数据库名称。
对象名
加载到分析引擎的表名。视图同样可以加载到只读分析引擎,但是在此处不会显示视图信息。如需查看视图,请使用 MySQL 命令进行查看。
当加载的对象较多时,可在控制台中通过对象名称的关键字进行搜索。
状态
数据加载的当前阶段,包括数据加载中、数据加载完成、实时增量中、同步异常等。
数据加载情况
当对象处于数据加载阶段时,显示当前表的加载进度。
增量阶段延迟
当对象处于实时增量阶段时,显示该对象的同步延迟信息(单位:秒)。
其他信息
若数据加载出现异常,显示该对象加载异常的相关错误信息。

方法2:通过 SQL 命令查看

连接到 TDSQL Boundless 实例,执行以下 SQL 命令查看数据加载状态:
SHOW REPLICATION TABLES;
或者查询系统视图:
SELECT * FROM information_schema.LIBRA_TABLE_STATUS;
两种方式返回相同的字段信息,字段说明如下:
字段名
类型
说明
DATABASE_NAME
VARCHAR
数据库名称
TABLE_NAME
VARCHAR
表名称
REPLICA_ID
VARCHAR
副本标识,格式为 r<编号>,例如 r1
AVAILABLE
TINYINT
数据是否可查询。1表示可查询,0表示不可查询
REPLICATION_STEP
VARCHAR
当前数据加载阶段
LAG
BIGINT
同步延迟(秒)。仅在 Change Propagation 和 Load Data Finish 阶段显示实际延迟值,其他阶段显示 -1
MESSAGE
VARCHAR
附加信息。当出现异常时,显示错误原因
REPLICATION_STEP 字段的取值及含义如下:
状态值
说明
AVAILABLE
UnStart
数据加载尚未开始
0
Loading Data
正在进行全量数据加载
0
Load Data Finish
全量数据加载已完成,等待进入增量同步
1
Change Propagation
实时增量同步中(变更传播)
1(正常时)
Skip
该表被跳过,不进行加载
0
Error
数据加载出现错误
0
说明:
REPLICATION_STEP 为 Change Propagation 且 AVAILABLE 为0时,表示分析引擎中该表的数据已过期。

使用条件过滤

通过 information_schema.LIBRA_TABLE_STATUS 系统视图支持标准 SQL WHERE 条件过滤。例如:
-- 查看指定数据库的加载状态
SELECT * FROM information_schema.LIBRA_TABLE_STATUS
WHERE DATABASE_NAME = 'your_database';

-- 查看所有加载异常的表
SELECT * FROM information_schema.LIBRA_TABLE_STATUS
WHERE REPLICATION_STEP = 'Error';

-- 查看所有已可查询的表
SELECT * FROM information_schema.LIBRA_TABLE_STATUS
WHERE AVAILABLE = 1;

注意事项

当分析引擎中的表数据不可用时,未通过 HINT 强制指定引擎的查询将自动路由到事务引擎(TDSQL Boundless 主实例)。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈