From b8bae98d35a5ae61e86399bdf50ea687fa4fbbdd Mon Sep 17 00:00:00 2001 From: zhukeke Date: Fri, 4 Sep 2026 18:39:44 +0800 Subject: [PATCH 1/2] Document the table prefix requirement for catalog-level table properties --- docs/admin-guides/managing-catalogs.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/admin-guides/managing-catalogs.md b/docs/admin-guides/managing-catalogs.md index c29abb6719..7435e13f87 100644 --- a/docs/admin-guides/managing-catalogs.md +++ b/docs/admin-guides/managing-catalogs.md @@ -76,6 +76,20 @@ Common properties include: ### Configure table properties If you want to add the same table properties to all tables under a catalog, you can add these table properties here on the catalog level. If you also configure this property on the table level, the property on the table will take effect. +{{< hint info >}} +When configuring table-level properties on a catalog, you **must prefix the key with `table.`**. The prefix will be automatically stripped when the property is applied to tables. For example, to set the default `self-optimizing.group` for all tables under the catalog, you need to configure `table.self-optimizing.group` instead of `self-optimizing.group`. Properties without the `table.` prefix will not be recognized as table-level defaults and will be treated as catalog-level properties only. +{{< /hint >}} + +The following table lists some examples: + +| Catalog property key | Effective table property key | Description | +|---------------------------------------------|-------------------------------------------|----------------------------------------------------------| +| `table.self-optimizing.enabled` | `self-optimizing.enabled` | Enable/disable self-optimizing for all tables | +| `table.self-optimizing.group` | `self-optimizing.group` | Set the default optimizer group for all tables | +| `table.table-expire.enabled` | `table-expire.enabled` | Enable/disable table expiration for all tables | +| `table.clean-orphan-file.enabled` | `clean-orphan-file.enabled` | Enable/disable orphan file cleaning for all tables | +| `table.log-store.enabled` | `log-store.enabled` | Enable/disable LogStore for all tables | + ## REST Catalog When a user needs to create a Iceberg REST Catalog, they can choose **External Catalog Type**、**Custom Metastore Type**、**Iceberg Table Format**, configure properties include: **catalog-impl=org.apache.iceberg.rest.RESTCatalog**, **uri=$restCatalog_uri**. From 3bd36382c1a7988b4e79de89c9858388c2585786 Mon Sep 17 00:00:00 2001 From: zhukeke Date: Thu, 10 Sep 2026 11:20:34 +0800 Subject: [PATCH 2/2] Add link to Table configurations page in managing-catalogs doc Co-authored-by: CodeFree --- docs/admin-guides/managing-catalogs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/admin-guides/managing-catalogs.md b/docs/admin-guides/managing-catalogs.md index 7435e13f87..0bb7f5b78e 100644 --- a/docs/admin-guides/managing-catalogs.md +++ b/docs/admin-guides/managing-catalogs.md @@ -80,7 +80,7 @@ If you want to add the same table properties to all tables under a catalog, you When configuring table-level properties on a catalog, you **must prefix the key with `table.`**. The prefix will be automatically stripped when the property is applied to tables. For example, to set the default `self-optimizing.group` for all tables under the catalog, you need to configure `table.self-optimizing.group` instead of `self-optimizing.group`. Properties without the `table.` prefix will not be recognized as table-level defaults and will be treated as catalog-level properties only. {{< /hint >}} -The following table lists some examples: +The following table lists some examples. For the full list of available table properties, see [Table configurations](../user-guides/configurations.md). | Catalog property key | Effective table property key | Description | |---------------------------------------------|-------------------------------------------|----------------------------------------------------------|