This is an automated email from the ASF dual-hosted git repository.
jedcunningham pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new e1e93e682d0 Document the sql extra required for LLMSQLQueryOperator
(#70564)
e1e93e682d0 is described below
commit e1e93e682d05c8f993fca46293bdb8d23695bb19
Author: Jed Cunningham <[email protected]>
AuthorDate: Mon Jul 27 15:54:08 2026 -0600
Document the sql extra required for LLMSQLQueryOperator (#70564)
Users reached for the common.sql extra, which omits sqlglot, and hit an
import failure. Point them at the sql extra that installs sqlglot.
---
providers/common/ai/docs/operators/llm_sql.rst | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/providers/common/ai/docs/operators/llm_sql.rst
b/providers/common/ai/docs/operators/llm_sql.rst
index 84d5a2226e1..233f7262a95 100644
--- a/providers/common/ai/docs/operators/llm_sql.rst
+++ b/providers/common/ai/docs/operators/llm_sql.rst
@@ -26,6 +26,11 @@ SQL queries from natural language using an LLM.
The operator generates SQL but does not execute it. The generated query is
returned
as XCom and can be passed to ``SQLExecuteQueryOperator`` or used in downstream
tasks.
+Install the ``sql`` extra, which adds ``apache-airflow-providers-common-sql``
and
+`sqlglot <https://github.com/tobymao/sqlglot>`__ (used to validate the
generated SQL)::
+
+ pip install "apache-airflow-providers-common-ai[sql]"
+
.. seealso::
:ref:`Connection configuration <howto/connection:pydanticai>`
