feat(clickhouse): add ARRAY JOIN, LEFT/INNER ARRAY JOIN support

ClickHouse supports ARRAY JOIN clauses for unnesting arrays inline.
This adds JoinOperator variants for ARRAY JOIN, LEFT ARRAY JOIN,
and INNER ARRAY JOIN.

These joins take a table expression (the array to unnest) rather than
a standard table reference, and do not use ON/USING constraints.

Also adds Spanned impls for the new variants in spans.rs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: Cristhian Lopez Vidal

src/ast/query.rs

@@ -2755,6 +2755,13 @@ impl fmt::Display for Join {
                 self.relation,
                 suffix(constraint)
             )),
+            JoinOperator::ArrayJoin => f.write_fmt(format_args!("ARRAY JOIN {}", self.relation)),
+            JoinOperator::LeftArrayJoin => {
+                f.write_fmt(format_args!("LEFT ARRAY JOIN {}", self.relation))
+            }
+            JoinOperator::InnerArrayJoin => {
+                f.write_fmt(format_args!("INNER ARRAY JOIN {}", self.relation))
+            }
         }
     }
 }
@@ -2809,6 +2816,14 @@ pub enum JoinOperator {
     ///
     /// See <https://dev.mysql.com/doc/refman/8.4/en/join.html>.
     StraightJoin(JoinConstraint),
+    /// ClickHouse: `ARRAY JOIN` for unnesting arrays inline.
+    ///
+    /// See <https://clickhouse.com/docs/en/sql-reference/statements/select/array-join>.
+    ArrayJoin,
+    /// ClickHouse: `LEFT ARRAY JOIN` for unnesting arrays inline (preserves rows with empty arrays).
+    LeftArrayJoin,
+    /// ClickHouse: `INNER ARRAY JOIN` for unnesting arrays inline (filters rows with empty arrays).
+    InnerArrayJoin,
 }
 
 #[derive(Debug, Clone, PartialEq, PartialOrd, Eq, Ord, Hash)]

src/ast/spans.rs

@@ -2234,6 +2234,9 @@ impl Spanned for JoinOperator {
             JoinOperator::Anti(join_constraint) => join_constraint.span(),
             JoinOperator::Semi(join_constraint) => join_constraint.span(),
             JoinOperator::StraightJoin(join_constraint) => join_constraint.span(),
+            JoinOperator::ArrayJoin => Span::empty(),
+            JoinOperator::LeftArrayJoin => Span::empty(),
+            JoinOperator::InnerArrayJoin => Span::empty(),
         }
     }
 }

src/parser/mod.rs

@@ -15342,6 +15342,33 @@ impl<'a> Parser<'a> {
                         constraint: self.parse_join_constraint(false)?,
                     },
                 }
+            } else if dialect_of!(self is ClickHouseDialect | GenericDialect)
+                && self.parse_keywords(&[Keyword::INNER, Keyword::ARRAY, Keyword::JOIN])
+            {
+                // ClickHouse: INNER ARRAY JOIN
+                Join {
+                    relation: self.parse_table_factor()?,
+                    global,
+                    join_operator: JoinOperator::InnerArrayJoin,
+                }
+            } else if dialect_of!(self is ClickHouseDialect | GenericDialect)
+                && self.parse_keywords(&[Keyword::LEFT, Keyword::ARRAY, Keyword::JOIN])
+            {
+                // ClickHouse: LEFT ARRAY JOIN
+                Join {
+                    relation: self.parse_table_factor()?,
+                    global,
+                    join_operator: JoinOperator::LeftArrayJoin,
+                }
+            } else if dialect_of!(self is ClickHouseDialect | GenericDialect)
+                && self.parse_keywords(&[Keyword::ARRAY, Keyword::JOIN])
+            {
+                // ClickHouse: ARRAY JOIN
+                Join {
+                    relation: self.parse_table_factor()?,
+                    global,
+                    join_operator: JoinOperator::ArrayJoin,
+                }
             } else {
                 let natural = self.parse_keyword(Keyword::NATURAL);
                 let peek_keyword = if let Token::Word(w) = &self.peek_token_ref().token {

tests/sqlparser_clickhouse.rs

@@ -1751,6 +1751,24 @@ fn test_parse_not_null_in_column_options() {
     );
 }
 
+#[test]
+fn parse_array_join() {
+    // ClickHouse: plain ARRAY JOIN for unnesting arrays
+    clickhouse().verified_stmt("SELECT x FROM t ARRAY JOIN arr AS x");
+}
+
+#[test]
+fn parse_left_array_join() {
+    // ClickHouse: LEFT ARRAY JOIN preserves rows with empty/null arrays
+    clickhouse().verified_stmt("SELECT x FROM t LEFT ARRAY JOIN arr AS x");
+}
+
+#[test]
+fn parse_inner_array_join() {
+    // ClickHouse: INNER ARRAY JOIN filters rows with empty/null arrays
+    clickhouse().verified_stmt("SELECT x FROM t INNER ARRAY JOIN arr AS x");
+}
+
 fn clickhouse() -> TestedDialects {
     TestedDialects::new(vec![Box::new(ClickHouseDialect {})])
 }