Skip to content

Commit d8d9b3a

Browse files
committed
[docs] Add document about add column at last.
1 parent 49ce39d commit d8d9b3a

File tree

2 files changed

+22
-0
lines changed

2 files changed

+22
-0
lines changed

website/docs/engine-flink/ddl.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -247,7 +247,19 @@ The following example illustrates reset the `table.datalake.enabled` option to i
247247
```sql title="Flink SQL"
248248
ALTER TABLE my_table RESET ('table.datalake.enabled');
249249
```
250+
### Add Column At Last
251+
Currently, Fluss only supports adding Nullable columns at the end of the table.
252+
Below are examples demonstrating how to add columns:
253+
```sql title="Flink SQL"
254+
-- Add a single column at the end of the table
255+
ALTER TABLE my_table ADD user_email STRING COMMENT 'User email address';
250256

257+
-- Add multiple columns at the end of the table
258+
ALTER TABLE MyTable ADD (
259+
user_email STRING COMMENT 'User email address',
260+
order_quantity INT
261+
);
262+
```
251263

252264
## Add Partition
253265

website/docs/maintenance/operations/upgrade-notes-0.9.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,16 @@ sidebar_position: 4
77

88
These upgrade notes discuss important aspects, such as configuration, behavior, or dependencies, that changed between Fluss 0.8 and Fluss 0.9. Please read these notes carefully if you are planning to upgrade your Fluss version to 0.9.
99

10+
## Add Column At Last.
11+
If you're only upgrading to Fluss v0.9 without modifying table schemas, you can safely skip this section.
12+
13+
However, If you plan to add columns to existing tables, follow these mandatory steps:
14+
1. Upgrade all Fluss servers to v0.9
15+
Ensure complete server infrastructure is running v0.9 before attempting any schema modifications.
16+
2. Restart and upgrade Fluss client to v0.9
17+
Old clients are incompatible with mixed schema versions and cannot properly read data with different schemas. This includes flink job, tier service and java client.
18+
19+
**Skipping these steps when adding columns may result in schema inconsistency issues or data inaccessibility.**
1020

1121
## Deprecation / End of Support
1222

0 commit comments

Comments
 (0)