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.

Installs
6
GitHub Stars
78
First Seen
Jun 3, 2026