(airflow) branch main updated: docs: clarify when to use custom `handler` (#68345)

[eladkal]

This is an automated email from the ASF dual-hosted git repository.

eladkal 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 48b17e8f809 docs: clarify when to use custom `handler` (#68345)
48b17e8f809 is described below

commit 48b17e8f8091360289dca24ea639bc749a145bf9
Author: Jose Muñoz <jmuno...@gmail.com>
AuthorDate: Fri Jun 12 09:16:24 2026 +0200

    docs: clarify when to use custom `handler` (#68345)
---
 providers/clickhousedb/docs/connections/clickhouse.rst | 2 +-
 providers/clickhousedb/docs/index.rst                  | 2 +-
 providers/clickhousedb/docs/operators/clickhouse.rst   | 4 +++-
 3 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/providers/clickhousedb/docs/connections/clickhouse.rst 
b/providers/clickhousedb/docs/connections/clickhouse.rst
index 45074460739..8f253fff8b9 100644
--- a/providers/clickhousedb/docs/connections/clickhouse.rst
+++ b/providers/clickhousedb/docs/connections/clickhouse.rst
@@ -74,7 +74,7 @@ Extra (optional)
       field adds a human-readable suffix, e.g. ``"my-pipeline"``.
     * ``session_settings`` *(dict)*: ClickHouse session-level settings applied 
to every
       query on this connection.  These are passed directly to the ``settings`` 
parameter of
-      ``clickhouse_connect.connect()``.  Common examples:
+      ``clickhouse_connect.get_client()``.  Common examples:
 
       .. code-block:: json
 
diff --git a/providers/clickhousedb/docs/index.rst 
b/providers/clickhousedb/docs/index.rst
index b8345dabde4..fac35e6656b 100644
--- a/providers/clickhousedb/docs/index.rst
+++ b/providers/clickhousedb/docs/index.rst
@@ -56,7 +56,7 @@
     :maxdepth: 1
     :caption: Resources
 
-    Example Dags 
<https://github.com/apache/airflow/tree/providers-clickhouse/|version|/providers/clickhouse/tests/system/clickhouse>
+    Example Dags 
<https://github.com/apache/airflow/tree/providers-clickhousedb/|version|/providers/clickhousedb/tests/system/clickhouse>
     PyPI Repository 
<https://pypi.org/project/apache-airflow-providers-clickhousedb/>
     Installing from sources <installing-providers-from-sources>
 
diff --git a/providers/clickhousedb/docs/operators/clickhouse.rst 
b/providers/clickhousedb/docs/operators/clickhouse.rst
index 5ebb53a3f1c..02bbd37fe83 100644
--- a/providers/clickhousedb/docs/operators/clickhouse.rst
+++ b/providers/clickhousedb/docs/operators/clickhouse.rst
@@ -62,7 +62,7 @@ An example usage of the SQLExecuteQueryOperator to connect to 
ClickHouse:
 Querying Data
 ^^^^^^^^^^^^^
 
-Use a ``handler`` to return query results:
+Query results are fetched with the default ``handler`` (``fetch_all_handler``):
 
 .. exampleinclude:: 
/../../clickhousedb/tests/system/clickhouse/example_clickhouse.py
     :language: python
@@ -70,6 +70,8 @@ Use a ``handler`` to return query results:
     :end-before: [END howto_operator_clickhouse_query]
     :dedent: 4
 
+To return something other than the full result set, pass a custom ``handler``. 
For example, ``fetch_one_handler`` to fetch only the first row.
+
 .. note::
 
     ``session_settings`` passed to 
:class:`~airflow.providers.clickhousedb.hooks.clickhouse.ClickHouseHook`