This is an automated email from the ASF dual-hosted git repository.
zhoujinsong pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/amoro.git
The following commit(s) were added to refs/heads/master by this push:
new 7f97dca0c [AMORO-4357][Docs] Document the table. prefix requirement
for catalog-level table properties (#4358)
7f97dca0c is described below
commit 7f97dca0cbbfa9752444e13cae0f8df22db2907f
Author: Akeron <[email protected]>
AuthorDate: Thu Sep 10 20:18:29 2026 +0800
[AMORO-4357][Docs] Document the table. prefix requirement for catalog-level
table properties (#4358)
* Document the table prefix requirement for catalog-level table properties
* Add link to Table configurations page in managing-catalogs doc
Co-authored-by: CodeFree <[email protected]>
---------
Co-authored-by: zhukeke <[email protected]>
Co-authored-by: CodeFree <[email protected]>
---
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 c29abb671..0bb7f5b78 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. For the full list of available table
properties, see [Table configurations](../user-guides/configurations.md).
+
+| 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**.
