Merge pull request #2312 from aiven/dorota-clickhouse-supported-proto…

…cols-interfaces

clickhouse: add ref doc for supported protocols and drivers

_toc.yml

@@ -855,6 +855,8 @@ entries:
         entries:
           - file: docs/products/clickhouse/reference/supported-table-engines
             title: Table engines
+          - file: docs/products/clickhouse/reference/supported-interfaces-drivers
+            title: Interfaces and drivers
           - file: docs/products/clickhouse/reference/metrics-list
             title: ClickHouse metrics in Grafana
           - file: docs/products/clickhouse/reference/supported-table-functions

docs/products/clickhouse/reference.rst

@@ -28,3 +28,7 @@ Additional reference information for Aiven for ClickHouse®:
     .. grid-item-card:: :doc:`Table functions supported in Aiven for ClickHouse® </docs/products/clickhouse/reference/supported-table-functions>`
         :shadow: md
         :margin: 2 2 0 0
+    .. grid-item-card:: :doc:`Interfaces and drivers supported in Aiven for ClickHouse® </docs/products/clickhouse/reference/supported-interfaces-drivers>`
+        :shadow: md
+        :margin: 2 2 0 0
+

docs/products/clickhouse/reference/supported-interfaces-drivers.rst

@@ -0,0 +1,50 @@
+Interfaces and drivers supported in Aiven for ClickHouse®
+=====================================================================
+
+Find out what technologies and tools you can use to interact with Aiven for ClickHouse®.
+
+.. _clickhouse-interfaces:
+
+Interfaces (protocols)
+----------------------
+
+Aiven for ClickHouse® supports the following fundamental underlying interfaces (protocols):
+
+* ``HTTPS``
+* ``Native TCP``
+* ``MySQL Interface``
+
+.. note::
+
+   For security reasons, you need TLS (plaintext) to connect to Aiven for ClickHouse. 
+
+.. topic:: Not supported interfaces (protocols)
+
+   * `HTTP`
+   * `gRPC`
+   * `PostgreSQL`
+
+.. seealso::
+
+   For the full list of interfaces and protocols supported in ClickHouse, check out `Drivers and Interfaces <https://clickhouse.com/docs/en/interfaces/overview>`_.
+
+Drivers (libraries)
+-------------------
+
+There are a number of drivers (libraries) that use one of :ref:`the fundamental underlying interfaces supported in Aiven for ClickHouse <clickhouse-interfaces>` under the hood. It's up to you to pick up a driver (library) of your choice and use it for connecting to your Aiven for ClickHouse service.
+
+.. seealso::
+
+   * Check out :doc:`how to use different drivers (libraries) for connecting to Aiven for ClickHouse </docs/products/clickhouse/howto/list-connect-to-service>`.
+
+   * For the full list of drivers and libraries that support connecting to ClickHouse, check out `Drivers and Interfaces <https://clickhouse.com/docs/en/interfaces/overview>`_.
+
+.. note::
+
+   You can connect to Aiven for ClickHouse with any driver that uses TLS and one of the supported protocols.
+
+Related reading
+---------------
+
+* :doc:`How to connect to Aiven for ClickHouse using different libraries </docs/products/clickhouse/howto/list-connect-to-service>`
+* `Drivers and interfaces supported in ClickHouse <https://clickhouse.com/docs/en/interfaces/overview>`_