(airflow) branch main updated: Document the sql extra required for LLMSQLQueryOperator (#70564)

[je...@apache.org]

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 <66...@users.noreply.github.com>
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>`