Skip to content

Commit 77e5a62

Browse files
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 <prathyush2018@gmail.com>
1 parent f438d26 commit 77e5a62

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

site/content/in-dev/unreleased/federation/hive-metastore-federation.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,26 @@ property to include `HIVE` (and any other non-REST backends you need):
4040
`runtime/server/build.gradle.kts` wires the extension in only when this flag is present, so binaries
4141
built without it will reject Hive federation requests.
4242

43+
## Feature configuration
44+
45+
After building Polaris with Hive support, enable the necessary feature flags in your
46+
`application.properties` file (or equivalent configuration mechanism such as environment variables or
47+
a Kubernetes ConfigMap):
48+
49+
```properties
50+
# Allows both REST and HIVE connection type
51+
polaris.features."SUPPORTED_CATALOG_CONNECTION_TYPES"=["ICEBERG_REST","HIVE"]
52+
53+
# Allows IMPLICIT authentication, needed for Hive federation
54+
polaris.features."SUPPORTED_EXTERNAL_CATALOG_AUTHENTICATION_TYPES"=["OAUTH","IMPLICIT"]
55+
56+
# Enables the federation feature itself
57+
polaris.features."ENABLE_CATALOG_FEDERATION"=true
58+
```
59+
60+
For Kubernetes deployments, add these properties to the ConfigMap mounted into the Polaris container
61+
(typically at `/deployment/config/application.properties`).
62+
4363
## Runtime requirements
4464

4565
- **Metastore connectivity:** Expose the HMS Thrift endpoint (`thrift://host:port`) to the Polaris

0 commit comments

Comments
 (0)