sqlmesh

Plan and deploy SQLMesh models across raw_zone, trusted_zone, and refined_zone.

36|12|Updated Nov 7, 2018
One-click install
npx skills add https://github.com/covoiturage-gouv-fr/mono --skill sqlmesh-covoiturage-gouv-fr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sqlmesh
Source: https://github.com/covoiturage-gouv-fr/mono/tree/main/.claude/skills/sqlmesh
Command: npx skills add https://github.com/covoiturage-gouv-fr/mono --skill sqlmesh-covoiturage-gouv-fr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

SQLMesh enables data teams to manage complex SQL-based data models with reproducible production workflows, ensuring consistent plan/run cycles across raw_zone, trusted_zone, and refined_zone.

Core Features & Use Cases

  • Model patterns and zone architecture across raw_zone, trusted_zone, and refined_zone to simplify governance and testing.
  • Safe indexing and performance guarantees via the @create_indexes() macro, avoiding common deadlocks.
  • Cron-driven execution and backfill control for incremental models, including lookback handling.
  • Debugging and observability conventions for diagnosing failed plans, time-bound processing, and timezone handling.

Quick Start

Plan and deploy the first SQLMesh model in a development environment to validate the plan, dependencies, and backfill behavior.

Frequently Asked Questions about sqlmesh

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

FAQPage Schema
How do I orchestrate SQL data models for reproducible production pipelines?▼

SQLMesh orchestrates SQL data models across raw_zone, trusted_zone, and refined_zone to ensure reproducible, time-bounded production pipelines with consistent plan and run cycles.

How do I configure incremental by time range backfills and cron schedules?▼

Configure cron-driven execution for incremental models and use exact time boundaries with @start_ts and @end_ts to control backfills, including lookback handling and safe timezone operations.

What is the best way to manage indexes and avoid deadlocks during SQL pipeline runs?▼

Manage indexes safely using the @create_indexes() macro, which provides performance guarantees while avoiding common deadlocks encountered during complex SQLMesh model plan and run cycles.

How do I debug failed plans and time-bound processing in SQL data pipelines?▼

Debug failed plans using established observability conventions to diagnose time-bound processing, enforce non-interval time filtering on start_datetime, and validate exact time boundaries.

Why does my time-bounded pipeline fail when using interval time filtering?▼

Pipelines fail because the system requires non-interval time filtering on start_datetime and enforces exact time boundaries using @start_ts and @end_ts to maintain reproducible backfill operations.