From e3de9f05dc750a6d71054a25ac43401d5b506562 Mon Sep 17 00:00:00 2001
From: Spencer Torres <contact@spencertorres.com>
Date: Thu, 13 Jun 2024 19:35:32 +0000
Subject: [PATCH] update alternative query languages; add kusto

---
 .../developer/alternative-query-languages.md  | 55 +++++++++++++++++--
 1 file changed, 51 insertions(+), 4 deletions(-)

diff --git a/docs/en/guides/developer/alternative-query-languages.md b/docs/en/guides/developer/alternative-query-languages.md
index a5d41a8bee9..9c4a335ef08 100644
--- a/docs/en/guides/developer/alternative-query-languages.md
+++ b/docs/en/guides/developer/alternative-query-languages.md
@@ -5,16 +5,36 @@ title: Alternative Query Languages
 description: Use alternative query languages in ClickHouse
 ---
 
-You can use other query languages to query data in ClickHouse using the `dialect` setting. The currently supported dialects are:
+You can use other query languages to query data in ClickHouse using the `dialect` setting.
+After changing `dialect`, you can run queries in the newly configured dialect.
+
+The currently supported dialects are:
 - `clickhouse`: The default [ClickHouse SQL dialect](../../sql-reference/syntax.md)
+
+Experimental dialects:
 - `prql`: [Pipelined Relational Query Language](https://prql-lang.org/)
+- `kusto`: [Kusto Quey Language (KQL)](https://learn.microsoft.com/en-us/azure/data-explorer/kusto/query)
+
+### ClickHouse SQL
+
+The default SQL dialect for ClickHouse.
+
+```sql
+SET dialect = 'clickhouse'
+```
+
+## Experimental Dialects
+
+These dialects may not be fully supported or have all of the features of their original specification.
+
+### Pipelined Relational Query Language (PRQL)
 
 You can execute queries using the PRQL language after setting the dialect to `prql`:
 ```sql
 SET dialect = 'prql'
 ```
 
-Then you can use every PRQL feature that the included PRQL compiler supports:
+Then you can use every PRQL feature that the included compiler supports:
 
 ```prql
 from trips
@@ -24,7 +44,34 @@ aggregate {
 }
 ```
 
-Under the hood ClickHouse will translate the PRQL query into an SQL query and execute it. To switch back to the ClickHouse SQL dialect set the dialect to `clickhouse`:
+Under the hood ClickHouse will translate the PRQL query into an SQL query and execute it.
+
+### Kusto Query Language (KQL)
+
+Kusto may not be able to access all functions defined in ClickHouse.
+
+Enable Kusto:
 ```sql
-SET dialect = 'clickhouse'
+SET dialect = 'kusto'
 ```
+
+Example query that selects from `system.numbers(10)`:
+```sql
+numbers(10) | project number
+```
+
+```sql
+┌─number─┐
+│      0 │
+│      1 │
+│      2 │
+│      3 │
+│      4 │
+│      5 │
+│      6 │
+│      7 │
+│      8 │
+│      9 │
+└────────┘
+```
+