You are viewing a plain text version of this content. The canonical link for it is here.

Posted to commits@airflow.apache.org by "amoghrajesh (via GitHub)" <gi...@apache.org> on 2026/06/06 10:21:49 UTC

[PR] Make task and asset store row size limits configurable [airflow]

amoghrajesh opened a new pull request, #68133:
URL: https://github.com/apache/airflow/pull/68133

    <!-- SPDX-License-Identifier: Apache-2.0
         https://www.apache.org/licenses/LICENSE-2.0 -->
   
   <!--
   Thank you for contributing!
   
   Please provide above a brief description of the changes made in this pull request.
   Write a good git commit message following this guide: http://chris.beams.io/posts/git-commit/
   
   Please make sure that your code changes are covered with tests.
   And in case of new features or big changes remember to adjust the documentation.
   
   Feel free to ping (in general) for the review if you do not see reaction for a few days
   (72 Hours is the minimum reaction time you can expect from volunteers) - we sometimes miss notifications.
   
   In case of an existing issue, reference it using one of the following:
   
   * closes: #ISSUE
   * related: #ISSUE
   -->
   
   ---
   
   ##### Was generative AI tooling used to co-author this PR?
   
   <!--
   If generative AI tooling has been used in the process of authoring this PR, please
   change below checkbox to `[X]` followed by the name of the tool, uncomment the "Generated-by".
   -->
   
   - [ ] Yes (please specify the tool below)
   
   <!--
   Generated-by: [Tool Name] following [the guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#gen-ai-assisted-contributions)
   -->
   
   
   ### What's being solved?
   
   The task and asset store had a hardcoded 64 KB size limit that in core API datamodels that could not be adjusted without code changes. Users with legitimate large-payload use case had no way to raise it, and the limit wasn't enforced consistently too, the core API validated it but the execution API (worker path) did not.
   
   ### Current behaviour
   
   - Core API rejected values over 64 KB with a hardcoded limit.
   - Execution API (worker writes) had no size check at all.
   - No config key existed to adjust the limit.
   
   ### Proposed change
   
   Adds `[state_store] max_value_storage_bytes` (default `65535`) to control the limit:
   
   - **Core API** (task and asset store): rejects oversized values with HTTP 400. Set to `0` to disable the limit entirely. DB column limits then apply (~1 GB on PostgreSQL, 16 MB on MySQL).
   - **Task SDK** (`task_store.set()` and `asset_store.set()`): logs a warning in task logs when the serialized value exceeds the limit, but allows the write through to not interrupt the execution mid run. The warning suggests configuring a custom `[state_store] backend` for large payloads.
   
   
   ### Testing
   
   Running example:
   
   Task Store:
   ```python
       @task
       def my_task(**context: Context):
           task_state = context["task_store"]
           value = "x" * 700000
           task_state.set("str_value", value)
   ```
   
   <img width="2555" height="903" alt="image" src="https://github.com/user-attachments/assets/737f21ca-55fb-4501-8dcd-772142270130" />
   
   
   Asset store:
   ```python
   with DAG(
       dag_id="aip103_asset_producer",
       start_date=pendulum.datetime(2026, 1, 1, tz="UTC"),
       schedule=None,
       catchup=False,
       tags=["aip-103", "asset-state-test"],
   ):
   
       @task(outlets=[aip103_test_asset])
       def produce(**context):
           print(f"Producer running for {aip103_test_asset.uri!r}")
           w = "w" * 700000
           context["asset_store"].set("my_asset_value_watermark", w)
   
       produce()
   ```
   
   
   <img width="2555" height="903" alt="image" src="https://github.com/user-attachments/assets/a0c25408-b9f9-482f-926b-e6ba2503e0ad" />
   
   
   
   
   
   
   ---
   
   * Read the **[Pull Request Guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#pull-request-guidelines)** for more information. Note: commit author/co-author name and email in commits become permanently public when merged.
   * For fundamental code changes, an Airflow Improvement Proposal ([AIP](https://cwiki.apache.org/confluence/display/AIRFLOW/Airflow+Improvement+Proposals)) is needed.
   * When adding dependency, check compliance with the [ASF 3rd Party License Policy](https://www.apache.org/legal/resolved.html#category-x).
   * For significant user-facing changes create newsfragment: `{pr_number}.significant.rst`, in [airflow-core/newsfragments](https://github.com/apache/airflow/tree/main/airflow-core/newsfragments). You can add this file in a follow-up commit after the PR is created so you know the PR number.
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org