操作场景
将数据加载到分析引擎后,需要确认数据是否可查询。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_STATUSWHERE DATABASE_NAME = 'your_database';-- 查看所有加载异常的表SELECT * FROM information_schema.LIBRA_TABLE_STATUSWHERE REPLICATION_STEP = 'Error';-- 查看所有已可查询的表SELECT * FROM information_schema.LIBRA_TABLE_STATUSWHERE AVAILABLE = 1;
注意事项
当分析引擎中的表数据不可用时,未通过 HINT 强制指定引擎的查询将自动路由到事务引擎(TDSQL Boundless 主实例)。