Spark 4.1: Fix Partition info not displayed in job description for RewritePositionDeleteFilesSparkAction

[manuzhang]

Closes #12414

After Fix:

[Copilot]

Pull request overview

This PR fixes an issue where partition information was not properly displayed in job descriptions for the RewritePositionDeleteFilesSparkAction in Spark 4.1. The fix adds a description field to StructProjection to carry partition information through the projection process.

Changes:

• Modified StructProjection to store and return a description string
• Updated PartitionUtil.coercePartition() to pass partition description when wrapping PartitionData
• Modified RewritePositionDeleteFilesSparkAction to extract and use the partition description in job descriptions

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
api/src/main/java/org/apache/iceberg/util/StructProjection.java	Added description field and getter method, plus overloaded wrap method to accept description
core/src/main/java/org/apache/iceberg/util/PartitionUtil.java	Updated to pass partition description when wrapping PartitionData instances
spark/v4.1/spark/src/main/java/org/apache/iceberg/spark/actions/RewritePositionDeleteFilesSparkAction.java	Added helper method to extract partition description for job descriptions

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The public method getDescription() lacks documentation explaining what the description represents, when it may be null, and its intended use case. Consider adding a Javadoc comment.

Suggested change

	/**
	* Returns the optional description associated with the currently wrapped {@link StructLike}.
	*
	* <p>The description is a human-readable identifier or context string supplied when calling
	* {@link #wrap(StructLike, String)}. It may be {@code null}, for example when
	* {@link #wrap(StructLike)} is used or when {@code null} is explicitly passed as the
	* description.
	*
	* <p>The description, if present, is propagated to projections created via
	* {@link #copyFor(StructLike)}.
	*
	* @return the description for the wrapped struct, or {@code null} if no description was set
	*/

[Copilot]

The overloaded wrap method with description parameter lacks documentation explaining the purpose of the description parameter and when it should be provided versus using the no-argument version.

Suggested change

	/**
	* Wraps a new {@link StructLike} instance in this projection.
	*
	* <p>The {@code description} is an optional, human-readable label for the wrapped struct,
	* which may be used in diagnostics such as error messages or logging. Callers that do not
	* need to associate a description with the struct can use {@link #wrap(StructLike)} instead,
	* which is equivalent to passing {@code null} for this parameter.
	*
	* @param newStruct the struct to wrap with this projection, or {@code null}
	* @param description an optional description of the wrapped struct, or {@code null}
	* @return this projection, wrapping the given struct
	*/