Skip to content

Document Airflow operator coverage as a table - #55

Open
peterpark-db wants to merge 1 commit into
mainfrom
docs/airflow-operator-table
Open

Document Airflow operator coverage as a table#55
peterpark-db wants to merge 1 commit into
mainfrom
docs/airflow-operator-table

Conversation

@peterpark-db

Copy link
Copy Markdown
Contributor

Rewrites the README's Supported Airflow Operators section from prose highlights into an exhaustive category table, matching the ADF section's format and the actual parser.

  • Table columns: Category | Operator(s) | Databricks target | Path — covering the 38 registry operators/sensors plus the dbt CLI, Cosmos, and TaskFlow constructs.
  • Makes the per-instance deterministic-vs-agentic model explicit (an operator lowers to a real task when its inputs are statically resolvable, else to a failing placeholder + gap), unlike ADF's fixed type split.
  • Corrects the time-sensor description: TimeSensor/TimeDeltaSensor route to agentic placeholders (not triggers); DateTimeSensor polls.
  • Adds previously-omitted supported operators (TriggerDagRunOperator, DatabricksCopyIntoOperator, PythonVirtualenvOperator/ExternalPythonOperator, DummyOperator/EmptyOperator, *Deferrable/*Async variants) and flags the always-agentic ones (BranchPythonOperator, ShortCircuitOperator, EmailOperator, ExternalTaskSensor, @task.branch/@task.short_circuit/@task_group).

Docs only; no code changes.

Replace the prose highlights in the README's Supported Airflow Operators section with an exhaustive category table (operator -> Databricks target -> deterministic/agentic path) built from the operator registry and coverage matrix. Make the per-instance deterministic-vs-agentic model explicit, mark the always-agentic constructs, fix the time-sensor description (TimeSensor/TimeDeltaSensor route to placeholders, not triggers), and reconcile the operator count.
@peterpark-db peterpark-db added the documentation Improvements or additions to documentation label Sep 9, 2026
@peterpark-db
peterpark-db requested a review from ghanse September 9, 2026 21:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant