From c67245c66f4152ede33a774c852fc892be4c8d0f Mon Sep 17 00:00:00 2001
From: okumin <git@okumin.com>
Date: Sat, 21 Dec 2024 13:43:00 +0900
Subject: [PATCH] Document sort direction and null order in Iceberg

---
 docs/src/main/sphinx/connector/iceberg.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/src/main/sphinx/connector/iceberg.md b/docs/src/main/sphinx/connector/iceberg.md
index 6ec6cd7bd4e0..42cb12927220 100644
--- a/docs/src/main/sphinx/connector/iceberg.md
+++ b/docs/src/main/sphinx/connector/iceberg.md
@@ -1502,6 +1502,18 @@ CREATE TABLE example.customers.orders (
 WITH (sorted_by = ARRAY['order_date'])
 ```
 
+You can explicitly configure sort directions or null ordering in the following way:
+
+```
+CREATE TABLE example.customers.orders (
+    order_id BIGINT,
+    order_date DATE,
+    account_number BIGINT,
+    customer VARCHAR,
+    country VARCHAR)
+WITH (sorted_by = ARRAY['order_date DESC NULLS FIRST', 'order_id ASC NULLS LAST'])
+```
+
 Sorting can be combined with partitioning on the same column. For example:
 
 ```