From d9e4b9a8aa843900def8ed8df021b7a3e44f0e51 Mon Sep 17 00:00:00 2001
From: Lukas Eder <lukas.eder@gmail.com>
Date: Wed, 10 Nov 2021 09:56:59 +0100
Subject: [PATCH] [jOOQ/jOOQ#12620] Document that the asterisk may lead to
 column order mismatches

---
 jOOQ/src/main/java/org/jooq/Table.java    | 7 +++++++
 jOOQ/src/main/java/org/jooq/impl/DSL.java | 7 +++++++
 2 files changed, 14 insertions(+)

diff --git a/jOOQ/src/main/java/org/jooq/Table.java b/jOOQ/src/main/java/org/jooq/Table.java
index bba3354953..28c1ad9886 100644
--- a/jOOQ/src/main/java/org/jooq/Table.java
+++ b/jOOQ/src/main/java/org/jooq/Table.java
@@ -343,6 +343,13 @@ extends
     /**
      * Create a qualified asterisk expression from this table
      * (<code>table.*</code>) for use with <code>SELECT</code>.
+     * <p>
+     * When using an asterisk, jOOQ will let the database server define the
+     * order of columns, as well as which columns are included in the result
+     * set. If using jOOQ with generated code, this may conflict with the column
+     * set and its ordering as defined at code generation time, meaning columns
+     * may be in a different order, there may be fewer or more columns than
+     * expected. It is usually better to list columns explicitly.
      *
      * @see DSL#asterisk()
      */
diff --git a/jOOQ/src/main/java/org/jooq/impl/DSL.java b/jOOQ/src/main/java/org/jooq/impl/DSL.java
index 3cc829d0f1..95d2b2a88e 100644
--- a/jOOQ/src/main/java/org/jooq/impl/DSL.java
+++ b/jOOQ/src/main/java/org/jooq/impl/DSL.java
@@ -29827,6 +29827,13 @@ public class DSL {
 
     /**
      * The asterisk (<code>*</code>) to be used in <code>SELECT</code> clauses.
+     * <p>
+     * When using an asterisk, jOOQ will let the database server define the
+     * order of columns, as well as which columns are included in the result
+     * set. If using jOOQ with generated code, this may conflict with the column
+     * set and its ordering as defined at code generation time, meaning columns
+     * may be in a different order, there may be fewer or more columns than
+     * expected. It is usually better to list columns explicitly.
      */
     @NotNull
     @Support