fix(parser): refresh transformer production doc and pin exact STRICT output

Signed-off-by: 付典 <fudianchn@gmail.com>

Author: fudianchn

src/main/jjtree/net/sf/jsqlparser/parser/JSqlParserCC.jjt

@@ -8333,9 +8333,9 @@ Expression SelectItemExpression() #ColumnsExpression(transformers != null):
 }
 
 /**
- * Parses a single ClickHouse transformer: APPLY(expression), EXCEPT (columns) or
- * REPLACE (selectItems). ClickHouse parses these in a loop, so they may repeat
- * and combine in any order.
+ * Parses a single ClickHouse transformer: APPLY(expression), EXCEPT [STRICT] (columns)
+ * or a pattern, REPLACE [STRICT] (selectItems). ClickHouse parses these in a loop, so
+ * they may repeat and combine in any order.
  */
 ColumnsTransformer ColumnsTransformer():
 {
@@ -8359,7 +8359,7 @@ ColumnsTransformer ColumnsTransformer():
           { transformer = new ColumnsTransformer(ColumnsTransformer.ColumnsTransformerType.APPLY)
                   .setApplyExpression(applyExpression); }
 
-        | tk=<K_EXCEPT>
+        | <K_EXCEPT>
           { strict = false; }
           [ <K_STRICT> { strict = true; } ]
           (
@@ -8375,7 +8375,7 @@ ColumnsTransformer ColumnsTransformer():
                 transformer.setExceptColumns(exceptColumns);
             } }
 
-        | tk=<K_EXCLUDE> exceptColumns = ParenthesedColumnList()
+        | <K_EXCLUDE> exceptColumns = ParenthesedColumnList()
           { transformer = new ColumnsTransformer(ColumnsTransformer.ColumnsTransformerType.EXCLUDE)
                   .setExceptColumns(exceptColumns); }
 

src/test/java/net/sf/jsqlparser/statement/select/ClickHouseTest.java

@@ -25,6 +25,7 @@
 import net.sf.jsqlparser.expression.operators.relational.ParenthesedExpressionList;
 import net.sf.jsqlparser.parser.CCJSqlParserUtil;
 import net.sf.jsqlparser.util.TablesNamesFinder;
+import net.sf.jsqlparser.util.deparser.StatementDeParser;
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.params.ParameterizedTest;
@@ -397,6 +398,16 @@ public void testAllColumnsExceptStrictIssue2636() throws JSQLParserException {
         Assertions.assertFalse(allColumns.getTransformers().get(1).isStrict());
         assertSqlCanBeParsedAndDeparsed(sql, true);
 
+        // the transformer survives as the second leg of a set operation
+        sql = "SELECT 1 UNION SELECT * EXCEPT STRICT (a) FROM t";
+        SetOperationList union = (SetOperationList) ((Select) CCJSqlParserUtil.parse(sql))
+                .getSelectBody();
+        PlainSelect rightLeg = (PlainSelect) union.getSelects().get(1);
+        AllColumns legColumns = Assertions.assertInstanceOf(AllColumns.class,
+                rightLeg.getSelectItems().get(0).getExpression());
+        Assertions.assertTrue(legColumns.getTransformers().get(0).isStrict());
+        assertSqlCanBeParsedAndDeparsed(sql, true);
+
         // the COLUMNS(...) matcher accepts the same STRICT form
         sql = "SELECT COLUMNS('m') EXCEPT STRICT (a) FROM t";
         select = (Select) CCJSqlParserUtil.parse(sql);
@@ -420,6 +431,10 @@ public void testAllColumnsReplaceStrictIssue2636() throws JSQLParserException {
         Assertions.assertTrue(transformer.isStrict());
         Assertions.assertEquals(2, transformer.getReplaceItems().size());
         Assertions.assertEquals("a", transformer.getReplaceItems().get(0).getAlias().getName());
+        Assertions.assertEquals(sql, select.toString());
+        StatementDeParser statementDeParser = new StatementDeParser(new StringBuilder());
+        select.accept(statementDeParser, null);
+        Assertions.assertEquals(sql, statementDeParser.getBuilder().toString());
         assertSqlCanBeParsedAndDeparsed(sql, true);
 
         sql = "SELECT COLUMNS('m') REPLACE STRICT(x + 1 AS x) FROM t";