doris-debug-data-lake

doris-debug-data-lake is a skill for Claude Code, Codex from apache/doris-skills. It costs 41 tokens per session (850 once invoked), scanned A, original, Apache-2.0.

A troubleshooting guide for Apache Doris queries that use external data catalogs such as Hive, Iceberg, Paimon, or Hudi. These catalogs describe data stored in systems such as S3 or HDFS.

In plain words
What is it for?
Checking catalog health, refreshing metadata, diagnosing S3 or HDFS access, comparing external schemas, analyzing table statistics, and investigating missing external materialized-view rewrites.
Why use it?
It helps find whether failures or missing data come from stale metadata, storage access, expired credentials, schema differences, file limits, or a materialized-view rewrite that was not used.

Skill for Claude CodeCodex ✓ vendor

Written for no agent in particular: nothing here depends on one.

Needs its repository: it runs a file that does not travel with it, so clone the repository first. The line is ./scripts/doris-debug log-grep be/log --query-id "$QID".

Good fit Checking catalog health, refreshing metadata, diagnosing S3 or HDFS access, comparing external schemas, analyzing table statistics, and investigating missing external materialized-view rewrites.

Compare 6 skills from other repositories ↓
About the project

Apache Doris Skills is a collection of agent instructions containing Apache Doris database knowledge for designing, sizing, operating, diagnosing, and contributing to Doris clusters. It serves developers and operators using Claude Code, Cursor, Codex, Cline, Amp, and other agent tools, with the skills providing decision logic and evidence-based workflows.

apache/doris-skills · 47 stars · on GitHub · doris.apache.org

Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/apache/doris-skills
agentmods
npx agentmods add skills/apache/doris-skills/data-lake

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for doris-debug-data-lake

README.md
[![agentmods](https://agentmods.dev/badge/skills/apache/doris-skills/data-lake/github.svg)](https://agentmods.dev/skills/apache/doris-skills/data-lake)
Your own site
<a href="https://agentmods.dev/skills/apache/doris-skills/data-lake"><img src="https://agentmods.dev/badge/skills/apache/doris-skills/data-lake/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for doris-debug-data-lake

Your own site · 80×15
<a href="https://agentmods.dev/skills/apache/doris-skills/data-lake"><img src="https://agentmods.dev/badge/skills/apache/doris-skills/data-lake.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 41 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 850 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00041 $0.00850
Opus 5.5 $0.00016 $0.00340
Sonnet 5.5 $0.00008 $0.00170
Haiku 4.5 $0.00004 $0.00085

Measured 1mo ago against content hash 6fac97f2bb14, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

doris-debug-data-lake scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -I "https://<bucket>.s3.<region>.amazonaws.com"
skills/doris-debug/data-lake/SKILL.md · 101 lines

How it starts

The opening of the file, as written. The whole thing — 101 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Data Lake (Multi-Catalog)

Causes

ID Cause Evidence Source anchor
A Metadata stale Query returns old data / missing partitions after upstream write HMSClient.java, CachedHMSClient.java
B S3/HDFS connectivity Access Denied, Timeout, NoSuchBucket S3FileSystem.java, HdfsResource.java
C External MV rewrite miss EXPLAIN shows no MATERIALIZED_REWRITE MTMVService.java rewrite rules
D Schema mismatch Parquet/ORC schema ≠ Hive Metastore schema ParquetReader.cpp, schema merge
E Credential / IAM expiry STS / IAM token rotated; 403 on S3 S3FileSystem.java credential refresh
F Too many open files FD exhaustion listing large table directories BE ulimit -n, FileSystem.listFiles()

10 min triage

-- Verify catalog is alive
SHOW CATALOGS;

-- Refresh metadata (hive / iceberg / paimon)
REFRESH CATALOG hive_catalog;
REFRESH DATABASE hive_catalog.db_name;
REFRESH TABLE hive_catalog.db_name.tbl_name;

-- Check if external MV rewrite is enabled
SET materialized_view_rewrite_enable_contain_external_table = true;

-- Analyze external table for CBO stats
ANALYZE TABLE hive_catalog.db_name.tbl_name;
# BE logs for S3/HDFS errors
./scripts/doris-debug log-grep be/log --query-id "$QID"
grep -r "403\|Access Denied\|Timeout\|NoSuchBucket\|Token.*expired" be/log/

# Check BE file descriptor limit
cat /proc/$BE_PID/limits | grep "open files"

Cause A — Metadata staleness

Hive Metastore metadata is cached; REFRESH CATALOG invalidates the cache. For large catalogs, prefer:

-- Refresh only the changed partition
REFRESH TABLE catalog.db.tbl PARTITION (dt='2026-07-15');

If refresh is slow, check HMSClient cache settings (fe.conf):

hive_metastore_client_timeout_second = 10

Cause B — S3/HDFS connectivity

# be.conf — S3 credential chain
aws_access_key_id = ...
aws_secret_access_key = ...
aws_region = us-east-1

Read the full file on GitHub · 101 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 101 lines · 41 tokens per session scan A 6fac97f2bb14

Subscribe to this mod's changes

doris-debug-data-lake is a skill published in the GitHub repository apache/doris-skills (47 stars, last pushed 17d ago), licensed Apache-2.0. It adds 41 tokens to every session and 850 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

cf-fix

Quick bug-fix workflow — reproduce, find the root cause, fix via cf-implementer, verify, auto-review. TRIGGER — the user reports a bug or broken behavior: "fix this", "it's broken", "not working", "there's a bug", "this crashes", "debug this", "it throws", "failing test", "regression", "unexpected behavior"; a pasted…

dinhanhthi/coding-friend · 133 tokens

cf-optimize

Structured performance work — baseline, analyze, optimize, measure, compare. TRIGGER — "this is slow", "make it faster", "optimize", "performance", "bottleneck", "too many queries", "high latency", "memory leak", "speed up", "timeout", "N+1", or any request to reduce time, memory, or query count with numbers to prove…

dinhanhthi/coding-friend · 112 tokens

cf-sys-debug

Systematic 4-phase debugging — root cause, hypothesis testing, regression-guarded fix, mandatory bug doc. TRIGGER — non-trivial or recurring bugs: "still broken", "same error again", "came back", flaky/intermittent/race, "used to work, now broken", hard-to-reproduce, works locally but fails in CI, "find the root…

dinhanhthi/coding-friend · 136 tokens

ladybugdb

Expert guide for LadybugDB — an embedded, in-process property graph database using openCypher. Use this skill whenever the user is working with LadybugDB, writing Cypher queries for LadybugDB, using the lbug CLI, importing realladybug in Python, using @ladybugdb/core in Node.js, or building any application with…

delexw/claude-code-misc · 173 tokens

reproduce-bug

Reproduce a reported bug in googleapis/mcp-toolbox and decide whether it is real, delivering an evidence-backed verdict: confirmed, already fixed, misconfiguration, client-side, works as intended, not reproducible, or blocked. Use whenever a maintainer asks you to reproduce, verify, confirm, or investigate a bug…

googleapis/mcp-toolbox · 130 tokens

triage-issues

Triage GitHub issues in the googleapis/mcp-toolbox repo: propose the correct labels (type / priority / product / status), check for duplicates, verify a bug has enough info to act on, and draft a triage comment. Use whenever a maintainer asks you to triage, label, categorize, prioritize, or "look at" an issue (or a…

googleapis/mcp-toolbox · 164 tokens