Skip to content

feat: support connecting Python Hive3 Namespace to a Kerberos-secured Hive Metastore #45

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
zouhuajian wants to merge 1 commit into
base: main
Choose a base branch
from
Open

feat: support connecting Python Hive3 Namespace to a Kerberos-secured Hive Metastore #45

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions docs/src/hive3.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,22 @@ The **client.pool-size** property is optional and specifies the size of the HMS

The **root** property is optional and specifies the storage root location of the lakehouse on Hive catalog. Default value is the current working directory.

The **hive.metastore.sasl.enabled** property is optional. When set to `true`, the Python Hive3 implementation uses Kerberos SASL to connect to Hive Metastore instead of a plain Thrift transport.

The **hive.metastore.kerberos.principal** property is optional and may be used to derive the Kerberos service name from the metastore service principal, such as `hive-metastore/_HOST@EXAMPLE.COM`.

The **kerberos.service-name** property is optional and overrides the Kerberos service name used for SASL negotiation.

The **kerberos.client-principal** property is optional and specifies the Kerberos client principal to use during SASL negotiation. If omitted, the default local Kerberos credentials are used.

## Authentication

For Kerberos-secured Hive Metastore deployments with `hive.metastore.sasl.enabled=true`, clients must have valid Kerberos credentials available before opening the namespace connection.

For the Python implementation, enabling `hive.metastore.sasl.enabled=true` switches the metastore wrapper to a Kerberos SASL transport.

For the Java implementation, Kerberos-related Hive Metastore settings are typically provided through the Hadoop `Configuration` used to initialize the namespace.

## Object Mapping

### Namespace
Expand Down
4 changes: 4 additions & 0 deletions python/pyproject.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,8 @@ hive2 = [
hive3 = [
"thrift>=0.13.0",
"hive-metastore-client>=1.0.0",
"pure-sasl>=0.6.2",
"kerberos>=1.3.1",
]
iceberg = []
polaris = []
Expand All @@ -38,6 +40,8 @@ all = [
"botocore>=1.35.0",
"thrift>=0.13.0",
"hive-metastore-client>=1.0.0",
"pure-sasl>=0.6.2",
"kerberos>=1.3.1",
]
dev = [
"pytest>=7.0.0",
Expand Down
Loading
Loading