You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@polaris.apache.org by di...@apache.org on 2025/10/31 22:09:29 UTC
(polaris) branch main updated: docs: add feature configuration section to Hive federation guide (#2952)
This is an automated email from the ASF dual-hosted git repository.
dimas 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 77e5a62d5 docs: add feature configuration section to Hive federation guide (#2952)
77e5a62d5 is described below
commit 77e5a62d57511b517479da842a5c5a0bae499470
Author: carc-prathyush-shankar <pr...@carbonarc.co>
AuthorDate: Fri Oct 31 17:09:24 2025 -0500
docs: add feature configuration section to Hive federation guide (#2952)
Add documentation for required feature flags when enabling
Hive Metastore federation. Users must configure three properties
in `application.properties` before Hive federation will work:
- `SUPPORTED_CATALOG_CONNECTION_TYPES`
- `SUPPORTED_EXTERNAL_CATALOG_AUTHENTICATION_TYPES`
- `ENABLE_CATALOG_FEDERATION`
Inspired from [this](https://apache-polaris.slack.com/archives/C084XDM50CB/p1761851426511259) Slack thread.
Co-authored-by: Prathyush Shankar <pr...@gmail.com>
---
.../federation/hive-metastore-federation.md | 20 ++++++++++++++++++++
1 file changed, 20 insertions(+)
diff --git a/site/content/in-dev/unreleased/federation/hive-metastore-federation.md b/site/content/in-dev/unreleased/federation/hive-metastore-federation.md
index 0d39a5e4a..f092a8a40 100644
--- a/site/content/in-dev/unreleased/federation/hive-metastore-federation.md
+++ b/site/content/in-dev/unreleased/federation/hive-metastore-federation.md
@@ -40,6 +40,26 @@ property to include `HIVE` (and any other non-REST backends you need):
`runtime/server/build.gradle.kts` wires the extension in only when this flag is present, so binaries
built without it will reject Hive federation requests.
+## Feature configuration
+
+After building Polaris with Hive support, enable the necessary feature flags in your
+`application.properties` file (or equivalent configuration mechanism such as environment variables or
+a Kubernetes ConfigMap):
+
+```properties
+# Allows both REST and HIVE connection type
+polaris.features."SUPPORTED_CATALOG_CONNECTION_TYPES"=["ICEBERG_REST","HIVE"]
+
+# Allows IMPLICIT authentication, needed for Hive federation
+polaris.features."SUPPORTED_EXTERNAL_CATALOG_AUTHENTICATION_TYPES"=["OAUTH","IMPLICIT"]
+
+# Enables the federation feature itself
+polaris.features."ENABLE_CATALOG_FEDERATION"=true
+```
+
+For Kubernetes deployments, add these properties to the ConfigMap mounted into the Polaris container
+(typically at `/deployment/config/application.properties`).
+
## Runtime requirements
- **Metastore connectivity:** Expose the HMS Thrift endpoint (`thrift://host:port`) to the Polaris