Diagnose Clickhouse Errors
Mapper en ClickHouse-feilkode til en per-kode diagnose-spillebok og et 3-seksjons årsak/fiks-svar
Krever oppsett
Hva den gjør
Gjør en ClickHouse kjøretidsfeil om til et fast årsak / fiks / eksempel-svar ved å trekke ut den numeriske feilkoden og laste en per-kode spillebok (42, 47, 60, 115, 342 er medfølgende). Utløses når en bruker limer inn en DB::Exception eller navngir en ClickHouse-feilkode og ønsker database-nivå årsaks- og fikseveiledning, og utsetter eksplisitt til kildekodeinspeksjon når målet er å finne hvor den feilende SQL ble bygget. De fleste spillebøker forventer en levende ClickHouse for å kjøre et system.columns / system.tables / system.settings oppslag, med en dokumentert tekst-kun fallback når den spørringen ikke kan kjøres.
Testrapport
GitHub API var rate-limited, så jeg klonet repoet og fant SKILL.md på resources/skills/diagnose-clickhouse-errors/; rå-hentet SKILL.md, references/60.md og references/342.md (alle HTTP 200; en oppdiktet references/999.md returnerte 404, som bekrefter at kun 5 koder sendes), grep fant ingen curl|sh, base64, legitimasjon eller injeksjonstekst, og jeg kjørte installasjonsblokken i en midlertidig HOME=$(mktemp -d) hvor den plasserte SKILL.md pluss alle 5 referansefilene korrekt. Utløserfraser jeg vurderte: SKAL utløses — "My query failed with Code: 60. DB::Exception: Table analytics.evnts doesn't exist. (UNKNOWN_TABLE), what's wrong?", "ClickHouse throws error code 115 on my SETTINGS clause, how do I fix it?", "Getting NUMBER_OF_ARGUMENTS_DOESNT_MATCH from toStartOfInterval in ClickHouse"; SKAL IKKE — "This ClickHouse query takes 40 seconds, help me speed it up" (optimalisering, ikke en feil) og "Our Java service logs a ClickHouse UNKNOWN_TABLE error, find where in our repo the table name is built" (beskrivelsen og en When-Not-To-Use-seksjon overlater eksplisitt dette til kildekodeinspeksjon); 5/5 korrekt. Utdata-testen brukte feil 342 fordi references/342.md er den eneste spilleboken som ikke krever det manglende execute_sql-verktøyet: baseline navnga den manglende `payload`-kolonnen, ga skrivebeskyttede sjekker (system.replicas, clusterAllReplicas over system.columns) og tre utbedringsalternativer inkludert `SYSTEM DROP REPLICA ... FROM TABLE events.page_views_local`, mens den ferdighetsfulgte kjøringen kollapset til ~180 ord med overskrifter ## Cause / ## Fix, den pålagte lagrede/parsede/lokale fragmentutvinningen, null muterende kommandoer og "escalate to the cluster maintainer / SRE" — tryggere for en prod-hendelse, men strengt tatt mindre handlingsrettet for en Claude Code-bruker som er vedlikeholderen, så jeg scoret den ikke bedre enn baseline. Dom oppsett: for 4 av de 5 kodene er bevissteget en levende `execute_sql` jeg ikke kunne utføre, og tre verktøynavn i teksten (skill_resource, execute_sql, ask_user_question) er DataStoria produktinterne som ingen README eller ferdighetsnotat flagger som utilgjengelige utenfor den appen.
Testet på: 2026-07-21 · Claude Code 2.x (agent harness)
Installer
git clone --depth 1 https://github.com/FrankChen021/datastoria.git /tmp/diagnose-clickhouse-errors-src
mkdir -p ~/.claude/skills
cp -R /tmp/diagnose-clickhouse-errors-src/resources/skills/diagnose-clickhouse-errors ~/.claude/skills/diagnose-clickhouse-errors
# Verified: places SKILL.md + references/{42,47,60,115,342}.md under ~/.claude/skills/diagnose-clickhouse-errors/
# The repo is the DataStoria web console (~large clone); only this one directory is needed.
# Sibling skills in the same folder that this one references: source-code-inspection, optimize-clickhouse-sql,
# clickhouse-system-queries, diagnose-clickhouse-clusters, sql-expert, visualization.
# MANUAL STEP: the skill body calls DataStoria-internal tools that do not exist in Claude Code:
# skill_resource -> read references/<code>.md yourself
# ask_user_question -> AskUserQuestion
# execute_sql -> needs a ClickHouse MCP server or a clickhouse-client you run by hand;
# without it, codes 42/47/60/115 fall back to text-only diagnosis (documented in each file). Kommandoer og eksempelprompter
/diagnose-clickhouse-errorsMapper en ClickHouse-feilkode til en per-kode diagnose-spillebok og et 3-seksjons årsak/fiks-svar
Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):
Diagnose this ClickHouse error code 241Why did my ClickHouse query fail at runtimeExplain this ClickHouse memory limit exceeded error