This is an automated email from the ASF dual-hosted git repository.
yzheng pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/polaris.git
The following commit(s) were added to refs/heads/main by this push:
new 4f1d1c348 doc: Fix Polaris CLI example, add precondition for enabling
the feature flag (#3833)
4f1d1c348 is described below
commit 4f1d1c3482fd5ef8e89c781f5ba8c766bc6bcab7
Author: Nándor Kollár <[email protected]>
AuthorDate: Fri Feb 20 06:07:32 2026 +0100
doc: Fix Polaris CLI example, add precondition for enabling the feature
flag (#3833)
---
.../in-dev/unreleased/federation/iceberg-rest-federation.md | 12 +++++++++++-
1 file changed, 11 insertions(+), 1 deletion(-)
diff --git
a/site/content/in-dev/unreleased/federation/iceberg-rest-federation.md
b/site/content/in-dev/unreleased/federation/iceberg-rest-federation.md
index c3c4520af..23e7ca4b0 100644
--- a/site/content/in-dev/unreleased/federation/iceberg-rest-federation.md
+++ b/site/content/in-dev/unreleased/federation/iceberg-rest-federation.md
@@ -33,6 +33,16 @@ REST implementation), enabling a Polaris service to access
table and view entiti
`ConnectionConfigInfo.AuthenticationParameters`. OAuth2 client credentials,
bearer tokens, and AWS
SigV4 are supported; choose the scheme the remote service expects.
+## Feature configuration
+
+The catalog federation feature is disabled by default. Enable the necessary
feature flag in your application.properties
+file (or equivalent configuration mechanism such as environment variables or a
Kubernetes ConfigMap):
+
+```properties
+# Enables the federation feature itself
+polaris.features."ENABLE_CATALOG_FEDERATION"=true
+```
+
## Creating a federated REST catalog
The snippet below registers an external catalog that forwards to a remote
Polaris server using OAuth2
@@ -52,7 +62,7 @@ polaris catalogs create \
--catalog-token-uri
"https://remote-polaris.example.com/catalog/v1/oauth/tokens"; \
--catalog-client-id "<remote-client-id>" \
--catalog-client-secret "<remote-client-secret>" \
- --catalog-client-scopes "PRINCIPAL_ROLE:ALL" \
+ --catalog-client-scope "PRINCIPAL_ROLE:ALL" \
analytics_rest
```
