From 79247fe6135c4ed98bc341c33fa49cf720e98399 Mon Sep 17 00:00:00 2001
From: Nick Del Nano <ndelnano@yelp.com>
Date: Mon, 19 Feb 2024 12:14:08 -0800
Subject: [PATCH] Update flink docs with alter column support

---
 docs/docs/flink-ddl.md | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/docs/docs/flink-ddl.md b/docs/docs/flink-ddl.md
index c2b3051fde8d..0cb45372cb5c 100644
--- a/docs/docs/flink-ddl.md
+++ b/docs/docs/flink-ddl.md
@@ -200,12 +200,27 @@ For more details, refer to the [Flink `CREATE TABLE` documentation](https://nigh
 
 ### `ALTER TABLE`
 
-Iceberg only support altering table properties:
+Table properties:
 
 ```sql
 ALTER TABLE `hive_catalog`.`default`.`sample` SET ('write.format.default'='avro');
 ```
 
+Since Flink 1.17 Iceberg supports column DDL:
+* add column
+* modify column
+* drop column
+* rename column
+* add primary key
+
+```sql
+ALTER TABLE `hive_catalog`.`default`.`sample` ADD (col1 INTEGER);
+ALTER TABLE `hive_catalog`.`default`.`sample` MODIFY (col1 BIGINT);
+ALTER TABLE `hive_catalog`.`default`.`sample` DROP (col1);
+ALTER TABLE `hive_catalog`.`default`.`sample` RENAME col1 TO col2;
+ALTER TABLE `hive_catalog`.`default`.`sample` ADD (PRIMARY KEY (col1) NOT ENFORCED);
+```
+
 ### `ALTER TABLE .. RENAME TO`
 
 ```sql