data-lake
Installation
SKILL.md
Data Lake / External Table Troubleshooting
Investigation guide for Hive Metastore connectivity, Kerberos authentication, HDFS/S3 access errors, and external catalog query failures.
Five root causes account for the vast majority of cases:
- Cause A — HMS connectivity failure or metadata listing too slow
- Cause B — Kerberos authentication failure (expired keytab or clock skew)
- Cause C — S3 / object storage access or rate-limit error
- Cause D — Network saturation from HMS traffic on CN/BE nodes
- Cause E — Metadata cache staleness (Hive partitions, Iceberg snapshots)
Metric Taxonomy — Read This First
Before using any diagnostic commands, understand the observable signals for external table issues.