Skip to content

Clarify AssetPartitionDagRun provisional-run docstring#69982

Open
dstandish wants to merge 1 commit into
apache:mainfrom
astronomer:clarify-apdr-docstring
Open

Clarify AssetPartitionDagRun provisional-run docstring#69982
dstandish wants to merge 1 commit into
apache:mainfrom
astronomer:clarify-apdr-docstring

Conversation

@dstandish

Copy link
Copy Markdown
Contributor

Clarify the AssetPartitionDagRun docstring.

The previous wording ("we should not allow more than one like this") didn't state the
actual invariant. This spells out that:

  • rows are never deleted from the table, so multiple records per
    target_dag_id / partition_key are expected in general (each created dag run leaves
    its record behind), and
  • the real constraint is at most one row with a null created_dag_run_id per
    target_dag_id / partition_key (the outstanding provisional run), which the
    _lock_asset_model mutex enforces.

Docstring-only; no behavior change.


Was generative AI tooling used to co-author this PR?
  • Yes — Claude Code (Opus 4.8)

Generated-by: Claude Code (Opus 4.8) following the guidelines

The previous wording ("we should not allow more than one like this") did not
state the actual invariant. Make explicit that rows are never deleted — so
multiple records per target_dag_id/partition_key are expected — and that the
constraint is specifically at most one row with a null created_dag_run_id,
which the _lock_asset_model mutex enforces.
@dstandish
dstandish requested review from XD-DENG and ashb as code owners July 16, 2026 18:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant