duckdb-analytics

Analyze JSONL and Parquet logs directly with DuckDB.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/Alex1980Alex/1C-Framework --skill duckdb-analytics-alex1980alex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: duckdb-analytics
Source: https://github.com/Alex1980Alex/1C-Framework/tree/main/.claude/skills/duckdb-analytics
Command: npx skills add https://github.com/Alex1980Alex/1C-Framework --skill duckdb-analytics-alex1980alex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the need to migrate logs into a database just to answer analytical questions, letting you query JSONL and Parquet data directly with DuckDB.

Core Features & Use Cases

  • Direct log analytics: Read newline-delimited JSON and Parquet files in place for fast ad hoc analysis.
  • Latency and metric reporting: Compute p50, p95, p99, counts, and daily aggregates for operational logs.
  • Schema drift handling: Safely combine mixed log files with union-by-name reading and pre-cleaning patterns.
  • Export and archiving: Convert hot JSONL logs into Parquet for efficient cold storage and future reporting.

Quick Start

Ask the assistant to load a JSONL log with DuckDB, compute latency percentiles and daily aggregates, and export the results to Parquet.

Frequently Asked Questions about duckdb-analytics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze JSONL logs without loading them into a database?

You can analyze JSONL logs directly in place using DuckDB's read_json_auto function, which queries newline-delimited JSON files instantly without requiring any data migration or database setup.

What is the best way to compute p50, p95, and p99 latency percentiles from operational logs?

Computing latency percentiles from operational logs is done using DuckDB's approximate quantiles on JSONL or Parquet files, allowing you to calculate p50, p95, p99, and daily aggregates efficiently.

How do I query JSONL files that have inconsistent schemas or schema drift?

To query JSONL files with schema drift, DuckDB uses union_by_name reading alongside pre-cleaning patterns to safely combine mixed log files with varying structures into a single query result.

Can I query both hot JSONL and cold Parquet log tiers together in a single SQL statement?

Yes, you can query hot JSONL and cold Parquet log tiers together using DuckDB's in-process analytics engine, which applies parameterized SQL to read both file formats simultaneously without moving data.

How do I convert JSONL logs to Parquet for cold storage and reporting?

Converting JSONL logs to Parquet for cold storage is accomplished through DuckDB's Parquet export functionality, transforming hot newline-delimited JSON into archived Parquet files for efficient future reporting.

Do I need to install external dependencies to run SQL analytics on local Parquet and JSONL files?

No external dependencies are required to run SQL analytics on local Parquet and JSONL files, as DuckDB operates as a self-contained in-process database engine that reads these formats directly without external integrations.