[HUDI-519] Document the need for Avro dependency shading/relocation for custom payloads, need for spark-avro

• Type: Task
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 0.5.1
• Component/s: docs, Usability
• Assignee: leesf
• Reporter: Udit Mehrotra
• Created: 10/Jan/20 22:44
• Updated: 01/Apr/20 00:01
• Resolved: 01/Apr/20 00:01

Description

In https://github.com/apache/incubator-hudi/pull/1005 we are migrating Hudi to Spark 2.4.4. As part of this migration, we also had to migrate Hudi to use Avro 1.8.2 (required by spark), while Hive still uses older version of Avro.

This has resulted in the need to shade Avro in hadoop-mr-bundle. This has implications on users of Hudi, who implement custom record payloads. They would have start shading Avro in there custom jars, similar to how it shaded in hadoop-mr-bundle.

This Jira is to track the documentation of this caveat in release notes, and if needed at other places like website etc.

Issue Links

• is a child of: HUDI-543 Carefully draft release notes for 0.5.1 with all breaking/user impacting changes