dagster
the asset gardener
declare the data that should exist (assets), how it splits (partitions), and what makes it valid (checks). dagster then derives the graph, runs, staleness, and backfills. keep storage explicit, keep resources injectable, and verify everything headless before opening the ui.
Use when building, testing, running, or debugging Dagster -- software-defined assets, asset checks (blocking gates), partitions and partition mappings, backfills, schedules, sensors, declarative automation, FreshnessPolicy, resources and config, IO managers, jobs and ops, executors, Definitions and code locations, the dg CLI and components, dagster-dbt, dagster-duckdb, dagster-dlt, Pipes, unit tests with materialize(), dagster dev, and Dagster+ deployment.
methodology
- model assets and a time partition first. add entity loops inside the asset. declare lookback with partition mappings.
- write storage explicitly and return
MaterializeResultwhen the layout is a contract. use an io manager only for in-process handoffs. - put every external dependency in a resource. put gates in
@asset_check(blocking=True). - pick the trigger: partitioned schedule for "yesterday", a sensor with a cursor and
run_keyfor source changes,AutomationConditionfor declarative upkeep. - pin
in_process_executorfor single-writer stores. for range backfills give every asset a single-run policy and readpartition_time_window. - prove it headless:
dagster definitions validateordg check defs, cli materialize, pytest withmaterialize()andbuild_sensor_context/build_schedule_context. verify api names against the installed version. - record lessons in trained. for pipeline design questions see data-pipeline.
contents
- trainedlearned layer: mental model, gotchas, practiced cases; read first
- dagster-docsofficial docs snapshot (2026-09-25): assets, checks, partitions, automation, resources, io managers, jobs/ops, components, pipes, testing, deployment
- changes-1.10-to-1.13api renames and deprecations by version
- dagster-expertofficial dagster-io agent guide: dg cli, components, integrations index, dagster+ mcp
- dagster-crypto-assetsrunnable assets + blocking check + dbt + schedule + sensor + pytest
- known-bugsdagster issues with workarounds
- sourcesevery source with its version
related gurus: data-pipeline (design, correctness, airflow/prefect comparison), dbt, olap (duckdb), feature-engineering.