Apache Doris 常见问题解答：第29期精华内容
SQL 查询相关
Q1：创建倒排索引后，如何确认查询是否命中索引？
A1：可通过分析 Query Profile 中的以下关键指标来评估：
RowsInvertedIndexFiltered：表示通过倒排索引过滤掉的数据行数。InvertedIndexFilterTime：执行倒排索引所花费的时间。InvertedIndexSearcherOpenTime：打开倒排索引所需时间。InvertedIndexSearcherSearchTime：内部搜索操作耗时。
更多信息请参考官方文档：倒排索引介绍
Q2：修改动态分区时需要注意哪些事项？
A2：在调整动态分区配置时，应避免产生时间重叠的分区，并注意历史数据保留策略。若设置不当可能导致旧分区被误删。
ALTER TABLE example_db.my_table SET (
"dynamic_partition.enable" = "true",
"dynamic_partition.time_unit" = "DAY",
"dynamic_partition.start" = "-3",
"dynamic_partition.end" = "3",
"dynamic_partition.prefix" = "p",
"dynamic_partition.buckets" = "32"
);
详细说明请参阅：动态分区管理指南
Q3：遇到 runtime filter 相关错误该如何解决？
A3：建议适当增加 session 参数 runtime_filter_wait_time_ms 的值；未来版本将引入更智能的等待机制。
数据接入与连接问题
Q4：使用 Power BI 连接 Doris 2.1.x 出现字符集不支持错误
A4：升级 JDBC 驱动至 8.0.32 版本即可解决问题。
Q5：Tableau 连接 Doris 提示 SSL 协议版本不匹配
A5：这是因为 Doris 启用了 SSL 认证但客户端未启用。可在 fe.conf 文件中禁用 enable_ssl 配置项。
Q6：连接 Hive Catalog 报 NullPointerException 错误
A6：在创建 Catalog 时加入如下参数可修复此问题：
"metastore.filter.hook" = "org.apache.hadoop.hive.metastore.DefaultMetaStoreFilterHookImpl"
Hive 外部目录集成详见：Hive Catalog 使用手册
Q7：Stream Load 请求被重定向至内网 IP 导致失败
A7：Stream Load 请求到达 FE 后会被转发到某个 BE 节点处理，返回的是 BE 的实际地址（通常是内网）。解决方案包括：
- 确保网络能访问 BE 内网地址；
- 部署负载均衡器统一接收并转发请求。
运维管理类问题
Q8：删除表之后如何快速清理残留的 Tablet？
A8：可通过以下命令立即清除回收站中的元数据：
ADMIN SET FRONTEND CONFIG ("catalog_trash_expire_second" = "0");
ADMIN CLEAN TRASH;
ADMIN SET FRONTEND CONFIG ("catalog_trash_expire_second" = "86400");
SHOW CATALOG RECYCLE BIN;
Q9：BE 下线过程中为何仍有部分 Tablet 残留？
A9：可能的原因包括：
- 待下线节点上的 Tablet 所属对象仍处于回收站中；
- 存在迁移异常导致任务停滞。
检查方法如下：
SHOW PROC "/cluster_health/tablet_health";
SHOW PROC "/cluster_balance";
如果无 unhealthy 分片，则可手动移除 BE 实例。
入门实践
Q10：新手如何快速体验 Doris 构建实时数仓的能力？
A10：推荐使用 Docker 快速搭建演示环境，在几分钟内完成"采集 - 存储 - 应用"完整流程体验。详情参考教程：基于 Docker 的 Doris 快速入门指南
