Skip to content

Add Avro Configuration Properties to Hive connector docs#25311

Merged
beinan merged 1 commit intoprestodb:masterfrom
martinsander00:fix-documentation-issue-24447
Jun 18, 2025
Merged

Add Avro Configuration Properties to Hive connector docs#25311
beinan merged 1 commit intoprestodb:masterfrom
martinsander00:fix-documentation-issue-24447

Conversation

@martinsander00
Copy link
Contributor

@martinsander00 martinsander00 commented Jun 13, 2025

Add Avro Configuration Properties to Hive connector docs

Introduce a new "Avro Configuration Properties" section describing:

  • hive.avro.schema.url and hive.avro.schema.literal for Presto table DDL
  • hive.metastore.avro.schema.reader.enabled for Hive 3.x Metastore (SerDeStorageSchemaReader)

Include the XML snippet and note about restarting the metastore to avoid "Storage schema reading not supported" errors.

Resolves: #24447

Description

Adds documentation for Avro configuration properties:

  • hive.avro.schema.url and hive.avro.schema.literal for Presto table DDL
  • hive.metastore.avro.schema.reader.enabled for Hive 3.x Metastore (SerDeStorageSchemaReader)

Include the XML snippet and note about restarting the metastore to avoid "Storage schema reading not supported" errors.

Motivation and Context

Adds Avro Configuration Properties so users with "java.lang.UnsupportedOperationException: Storage schema reading not supported" know how to address it.
Link to issue: #24447

Impact

None

Test Plan

None - documentation only change

Contributor checklist

  • Please make sure your submission complies with our contributing guide, in particular code style and commit standards.
  • PR description addresses the issue accurately and concisely. If the change is non-trivial, a GitHub Issue is referenced.
  • Documented new properties (with its default value), SQL syntax, functions, or other functionality.
  • If release notes are required, they follow the release notes guidelines.
  • Adequate tests were added if applicable.
  • CI passed.

Release Notes

Please follow release notes guidelines and fill in the release notes below.

== RELEASE NOTES ==

Documentation Changes
* Add :ref:`connector/hive:Avro Configuration Properties` to Hive Connector documentation.

@linux-foundation-easycla
Copy link

linux-foundation-easycla bot commented Jun 13, 2025

CLA Signed

The committers listed above are authorized under a signed CLA.

  • ✅ login: martinsander00 / name: Martin Sander (4873cf1)

Copy link
Contributor

@steveburnett steveburnett left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the documentation! Just a few suggestions. Looks good!

@github-project-automation github-project-automation bot moved this from 🆕 Unprioritized to 🏗 In progress in Presto Documentation Jun 13, 2025
@steveburnett
Copy link
Contributor

steveburnett commented Jun 13, 2025

Now that you have documentation to link to, please add the doc link to the release note entry. Here's the formatting to use - I tested this in a local doc build and it worked.

== RELEASE NOTES ==

Documentation Changes
* Add :ref:`connector/hive:Avro Configuration Properties` to Hive Connector documentation.

@steveburnett
Copy link
Contributor

Please sign the Presto CLA as mentioned in this comment.

@steveburnett
Copy link
Contributor

@agrawalreetika and @imjalpreet, would you PTAL at this new doc when you can?

@martinsander00 martinsander00 force-pushed the fix-documentation-issue-24447 branch 2 times, most recently from 7f40526 to cfa7248 Compare June 13, 2025 20:33
Copy link
Contributor

@steveburnett steveburnett left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a couple of formatting nits.

Introduce a new “Avro Configuration Properties” section describing:
-  and  for Presto table DDL
-  for Hive 3.x Metastore (SerDeStorageSchemaReader)
Include the XML snippet and note about restarting the metastore to avoid “Storage schema reading not supported” errors.

Resolves: prestodb#24447
@martinsander00 martinsander00 force-pushed the fix-documentation-issue-24447 branch from cfa7248 to 4873cf1 Compare June 17, 2025 21:48
Copy link
Contributor

@steveburnett steveburnett left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! (docs)

Pull updated branch, new local doc build, looks good. Thanks!

@github-project-automation github-project-automation bot moved this from 🏗 In progress to ✅ Done in Presto Documentation Jun 18, 2025
Copy link
Member

@beinan beinan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm, thanks for the contribution!

@beinan beinan merged commit 7739b44 into prestodb:master Jun 18, 2025
108 of 109 checks passed
@martinsander00 martinsander00 deleted the fix-documentation-issue-24447 branch June 18, 2025 18:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

Status: ✅ Done

Development

Successfully merging this pull request may close these issues.

[docs] how to configure Hive to support Avro tables

4 participants