Edit

Author: tyt2y3

Blog/blog/2025-08-20-sea-query-1.0.md

@@ -135,7 +135,20 @@ If you were constructing / pattern matching `Value` variants manually, `Box::new
 ### `non_exhaustive` AST enums
 
 [#891](https://github.com/SeaQL/sea-query/pull/891)
-`#[non_exhaustive]` are added to all AST enums. It allows us to add new features and extend the AST without breaking the API. If you encounter the following error,
+`#[non_exhaustive]` are added to all AST enums. It allows us to add new features and extend the AST without breaking the API.
+
+```rust
++ #[non_exhaustive]
+enum Mode {
+    Creation,
+    Alter,
+    TableAlter,
+}
+```
+
+#### Potential compile errors
+
+If you encounter the following error,
 please add a wildcard match `_ => {..}`
 ```rust
 error[E0004]: non-exhaustive patterns: `&_` not covered
@@ -160,7 +173,7 @@ help: ensure that all possible cases are being handled by adding a match arm wit
 [#927](https://github.com/SeaQL/sea-query/pull/927)
 Previously, the `TableRef` variants are a product of all valid combinations of `Option<Database>`, `Option<Schema>`, `Table` and `Option<Alias>`. It is excessive and makes pattern matching difficult.
 
-Now they're collapsed into one. `SchemaTable` is now simply a type alias of `TableName`. It makes constructing and pattern-matching `TableRef` much easier.
+Now they're collapsed into one. `SchemaTable` is now simply a type alias of `TableName`. It makes constructing and pattern-matching `TableRef` / `ColumnRef` much easier.
 
 ```rust
 // the following variants are collapsed into one:
@@ -178,16 +191,95 @@ enum TableRef {
     Table(TableName, Option<DynIden>), // optional Alias
     ..
 }
-// because it's restructured to:
+
 pub struct DatabaseName(pub DynIden);
 pub struct SchemaName(pub Option<DatabaseName>, pub DynIden);
+/// A table name, potentially qualified as [database.][schema.]table
 pub struct TableName(pub Option<SchemaName>, pub DynIden);
-// so TableName can represent [database.][schema.]table
 ```
 
+Similarly for `ColumnRef`:
+
+```rust
+// before
+enum ColumnRef {
+    Column(DynIden),
+    TableColumn(DynIden, DynIden),
+    SchemaTableColumn(DynIden, DynIden, DynIden),
+    Asterisk,
+    TableAsterisk(DynIden),
+}
+// now
+enum ColumnRef {
+    /// A column name, potentially qualified as [database.][schema.][table.]column
+    Column(ColumnName),
+    /// An `*` expression, potentially qualified as [database.][schema.][table.]*
+    Asterisk(Option<TableName>),
+}
+
+pub struct ColumnName(pub Option<TableName>, pub DynIden);
+```
+
+#### Potential compile errors
+
+`TableRef`
+
+```rust
+error[E0061]: this enum variant takes 2 arguments but 1 argument was supplied
+   --> src/entity/relation.rs:526:15
+    |
+ >  |     from_tbl: TableRef::Table("foo".into_iden()),
+    |               ^^^^^^^^^^^^^^^-------------------
+    |                              ||
+    |                              |expected `TableName`, found `DynIden`
+    |                              argument #2 of type `Option<DynIden>` is missing
+```
+It's recommended to use the `IntoTableRef` trait to convert types instead of constructing AST manually.
+```rust
+use sea_orm::sea_query::IntoTableRef;
+
+from_tbl: "foo".into_table_ref(),
+```
+
+`ColumnRef`
+
+```rust
+error[E0277]: the trait bound `fn(std::option::Option<TableName>) -> sea_query::ColumnRef {sea_query::ColumnRef::Asterisk}: IntoColumnRef` is not satisfied
+    --> src/executor/query.rs:1599:21
+    |
+ >  |             .column(ColumnRef::Asterisk)
+    |              ------ ^^^^^^^^^^^^^^^^^^^ the trait `sea_query::Iden` is not implemented for fn item `fn(std::option::Option<TableName>) -> sea_query::ColumnRef {sea_query::ColumnRef::Asterisk}`
+    |              |
+    |              required by a bound introduced by this call
+
+error[E0308]: mismatched types
+    --> src/executor/query.rs:1607:54
+    |
+ >  |                 SimpleExpr::Column(ColumnRef::Column("id".into_iden()))
+    |                                    ----------------- ^^^^^^^^^^^^^^^^ expected `ColumnName`, found `DynIden`
+    |                                    |
+    |                                    arguments to this enum variant are incorrect
+```
+In the former case `Asterisk` has an additional inner `Option<TableName>`, you can simply put `None`.
+```rust
+.column(ColumnRef::Asterisk(None))
+```
+In the latter case, `&'static str` can now be used in most methods that accepts `ColumnRef`.
+```rust
+Expr::column("id")
+```
+
+## New Features
+
+### Query Audit
+
+### Ergonomic raw SQL
+
 ## Release Plan
 
-This is just one of many new features we've added while preparing [SeaQuery 1.0](https://github.com/SeaQL/sea-query/blob/master/CHANGELOG.md#100---pending). This is currently an `rc` release, if you have ideas please [join the discussion](https://github.com/SeaQL/sea-query/discussions/795).
+[SeaQuery 1.0](https://github.com/SeaQL/sea-query/blob/master/CHANGELOG.md#100---pending) is currently an `rc` release, and we plan to finalize it soon - meaning no more major breaking changes. If you feel adventurous or want to use some of the latest features, you can upgrade today. Please let us know the problems you faced, this will help us and the community. If you have ideas / feedback please [join the discussion](https://github.com/SeaQL/sea-query/discussions/795) on GitHub!
+
+As SeaORM is based on top of SeaQuery, the breaking changes above would apply to all SeaORM users as well. We tried to minimize the impact to lightweight SeaORM users and most changes can be done mechanically. After that, it will be the most exciting release - SeaORM 2.0!
 
 ## Sponsor