编辑“︁Apache Drill元数据问题”︁（章节）

== 常见元数据问题类型 ==
以下是Drill中典型的元数据问题分类：

<mermaid>
pie
    title 元数据问题类型分布
    "Schema变更未同步" : 35
    "权限不足" : 25
    "缓存过期" : 20
    "配置错误" : 15
    "其他" : 5
</mermaid>

=== 1. Schema漂移问题 ===
当底层数据源（如Parquet文件）的schema发生变化但Drill未及时感知时：

<syntaxhighlight lang="sql">
-- 示例：新增列未被识别
SELECT * FROM dfs.`/data/users` LIMIT 5;
-- 报错：VALIDATION ERROR: Column 'new_column' not found
</syntaxhighlight>

'''解决方案：'''
* 刷新元数据：<code>REFRESH TABLE METADATA dfs.`/data/users`</code>
* 设置自动刷新：在<code>dfs</code>插件配置中启用<code>"autoRefresh": true</code>

=== 2. 视图依赖失效 ===
当基础表结构变更导致视图不可用时：

<syntaxhighlight lang="sql">
CREATE VIEW user_view AS SELECT id, name FROM users;
-- 若users表删除name列后：
SELECT * FROM user_view;
-- 报错：VALIDATION ERROR: View 'user_view' is invalid due to underlying schema changes
</syntaxhighlight>

'''修复步骤：'''
1. 检查视图定义：<code>SHOW CREATE VIEW user_view</code>
2. 重新创建视图或修改基础表结构