From 37b6068ca198d607f3947a71f132f27d6a721e96 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E4=BB=98=E5=85=B8?= <fudianchn@gmail.com>
Date: Sat, 15 Aug 2026 19:54:28 +0800
Subject: [PATCH] fix: allow GROUPS as identifier by making it a non-reserved
 keyword (#2473)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: 付典 <fudianchn@gmail.com>
---
 .../jjtree/net/sf/jsqlparser/parser/JSqlParserCC.jjt  |  2 +-
 .../net/sf/jsqlparser/statement/KeywordsTest.java     | 11 +++++++++++
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/src/main/jjtree/net/sf/jsqlparser/parser/JSqlParserCC.jjt b/src/main/jjtree/net/sf/jsqlparser/parser/JSqlParserCC.jjt
index 5f8e91d11..59723124c 100644
--- a/src/main/jjtree/net/sf/jsqlparser/parser/JSqlParserCC.jjt
+++ b/src/main/jjtree/net/sf/jsqlparser/parser/JSqlParserCC.jjt
@@ -1287,6 +1287,7 @@ String NonReservedWord() :
       | tk=<K_FULLTEXT:"FULLTEXT">
       | tk=<K_FUNCTION:"FUNCTION">
       | tk=<K_GRANT:"GRANT">
+      | tk=<K_GROUPS:"GROUPS">
       | tk=<K_GROUP_CONCAT:"GROUP_CONCAT">
       | tk=<K_GUARD:"GUARD">
       | tk=<K_HASH:"HASH">
@@ -1577,7 +1578,6 @@ TOKEN: /* Reserved SQL Keywords and structural tokens */
 |   <K_GLOBAL:"GLOBAL">
 |   <K_GROUP:"GROUP">
 |   <K_GROUPING:"GROUPING">
-|   <K_GROUPS:"GROUPS">
 |   <K_HAVING:"HAVING">
 |   <K_IF:"IF">
 |   <K_IIF:"IIF">
diff --git a/src/test/java/net/sf/jsqlparser/statement/KeywordsTest.java b/src/test/java/net/sf/jsqlparser/statement/KeywordsTest.java
index b595ab096..9e2c14ce7 100644
--- a/src/test/java/net/sf/jsqlparser/statement/KeywordsTest.java
+++ b/src/test/java/net/sf/jsqlparser/statement/KeywordsTest.java
@@ -51,4 +51,15 @@ public void testCombinedTokenKeywords() throws JSQLParserException {
         String sqlStr = "SELECT current_date(3)";
         assertSqlCanBeParsedAndDeparsed(sqlStr, true);
     }
+
+    // #2473: GROUPS is a non-reserved keyword in PostgreSQL and must stay usable as an
+    // identifier, although it also introduces the GROUPS window frame unit.
+    @Test
+    public void testGroupsAsIdentifier() throws JSQLParserException {
+        assertSqlCanBeParsedAndDeparsed("SELECT groups FROM mytable", true);
+        assertSqlCanBeParsedAndDeparsed("SELECT * FROM groups", true);
+        assertSqlCanBeParsedAndDeparsed("SELECT a AS groups FROM mytable", true);
+        assertSqlCanBeParsedAndDeparsed("SELECT a groups FROM mytable", true);
+        assertSqlCanBeParsedAndDeparsed("CREATE TABLE mytable (groups INT)", true);
+    }
 }