Document casting timestamp_tz column to a date as part of Iceberg optimize #12943

docs/src/main/sphinx/connector/delta-lake.md

@@ -543,6 +543,7 @@ TABLE AS </sql/create-table-as>` syntax.
 
 The connector supports the following [](/sql/alter-table) statements.
 
+(delta-lake-alter-table-execute)=
 #### ALTER TABLE EXECUTE
 
 The connector supports the following commands for use with {ref}`ALTER TABLE

docs/src/main/sphinx/connector/optimize.fragment

@@ -26,3 +26,13 @@ to filter which partitions are optimized:
 ALTER TABLE test_partitioned_table EXECUTE optimize
 WHERE partition_key = 1
 ```
+
+You can use a more complex `WHERE` clause to narrow down the scope of the
+`optimize` procedure. The following example casts the timestamp values to
+dates, and uses a comparison to only optimize partitions with data from the year
+2022 or newer:
+
+```
+ALTER TABLE test_table EXECUTE optimize
+WHERE CAST(timestamp_tz AS DATE) > DATE '2021-12-31'
+```

docs/src/main/sphinx/sql/alter-table.md

@@ -51,7 +51,12 @@ parameters. `ALTER TABLE EXECUTE` supports different commands on a
 per-connector basis.
 
 You can use the `=>` operator for passing named parameter values.
-The left side is the name of the parameter, the right side is the value being passed:
+The left side is the name of the parameter, the right side is the value being passed.
+
+Collapse files in a table that are over 10 megabytes in size with the `optimize`
+procedure from the [Hive](hive-alter-table-execute), [Delta
+Lake](delta-lake-alter-table-execute) , and
+[Iceberg](iceberg-alter-table-execute) connectors:
 
 ```
 ALTER TABLE hive.schema.test_table EXECUTE optimize(file_size_threshold => '10MB')
@@ -144,12 +149,6 @@ Set table property `x` to its default value in table\`\`people\`\`:
 ALTER TABLE people SET PROPERTIES x = DEFAULT;
 ```
 
-Collapse files in a table that are over 10 megabytes in size, as supported by
-the Hive connector:
-
-```
-ALTER TABLE hive.schema.test_table EXECUTE optimize(file_size_threshold => '10MB')
-```
 
 ## See also