Repository navigation
Issue on docs #2285
Description
Path:/zh-CN/docs/3.0/sql-manual/sql-statements/table-and-view/table/SHOW-TABLE-STATUS
环境情况：
doris 3.0、mysql 8.0、
创建与 mysql 关联的 category,category 名称为 dit；
mysql 下有一个 schema 名为 base，还有一张表 t_yardage
查询驱动使用 jdbc:arrow-flight-sql 版本 0.12.0
2）在mysql下执行的SQL
SELECT table_name, table_comment FROM information_schema.TABLES WHERE table_schema = 'base' and table_name='t_yardage'
结果：
table_name,table_comment
t_yardage,全码谱明细值
3)在 doris 下采用下面3种方式查询结果
- 方式1:
use dit.base; show table status like 't_yardage';
结果：
comment 列为空白
- 方式2:
show table status from dit.base.t_yardage;
结果：
执行错误
- 方式3:
SELECT table_name, table_comment FROM dit.information_schema.TABLES WHERE table_schema = 'base' where table_name = 't_yardage'
结果：
comment 列为空白
通过 category 获取表 comment 都是空白。
Activity
yuanyuan8983 commentedon Apr 23, 2025
这个问题是通过arrow flight sql 去连接Doris，通过 mysql catalog 查询mysql 下的表，comment 没数据？是这样吗
footmanai commentedon Apr 24, 2025
不止mysql，试过其他数据库也是comment没有数据（hana，oracle）
morningman commentedon Nov 12, 2026
已按 Doris 源码核对，并使用实际环境区分验证了这几种情况。
1. MySQL 表注释：3.0 确实缺少实现，4.0 已补充。
3.0 的
JdbcExternalTable没有实现表注释读取，继承的ExternalTable.getComment()固定返回空字符串。因此这部分不是 Arrow Flight SQL 驱动把注释丢掉。MySQL 的表注释读取由 apache/doris#54088（
908f020952445f61a94e504532c571180cb9ce94）补充，4.0.0 起的代码包含这项实现。本次使用 Doris 4.1.5（
917b20be838）、MySQL 8.0.33 和 MySQL Connector/J 8.0.33，通过 MySQL 协议连接 Doris 做了实际验证。MySQL 源表注释为全码谱明细值，以下两条语句均返回了同样的中文注释，SHOW CREATE TABLE也正确包含该注释：原报告中的第二种写法应为
SHOW TABLE STATUS FROM dit.base LIKE 't_yardage';，FROM后填写库名，不能再追加表名。第三种写法中的第二个WHERE应改为AND。这些语法问题与 3.0 缺少注释读取实现是两件事。2. Oracle / SAP HANA：目前仍缺少表注释读取实现，需要内核增强。
已检查当前 4.1 分支和 master。Oracle/HANA 客户端仍继承
getTableComment()返回空字符串的默认实现，不能将 MySQL 的修复结论扩展到这两种数据库。这里的catalog.information_schema.tables也是 Doris 构造的元数据，不是直接查询远端数据库的系统视图。已将这部分登记到内核仓库：apache/doris#70530，附上实际代码路径、MySQL 验证结果以及后续应覆盖的测试范围。本次没有运行 Oracle/HANA 环境，也没有将源码核对冒充为这两种数据库的集成测试。
MySQL 部分已有修复；Oracle/HANA 的增强尚未完成，因此保留本 issue 开放并关联内核跟踪，避免误标为全部解决。