Skip to content

[MINOR][SQL] Fix incorrect type wording in Row getter scaladoc#57240

Closed
LuciferYang wants to merge 1 commit into
apache:masterfrom
LuciferYang:SPARK-tier3-scaladoc-cleanup
Closed

[MINOR][SQL] Fix incorrect type wording in Row getter scaladoc#57240
LuciferYang wants to merge 1 commit into
apache:masterfrom
LuciferYang:SPARK-tier3-scaladoc-cleanup

Conversation

@LuciferYang

@LuciferYang LuciferYang commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

What changes were proposed in this pull request?

Fixes copy-pasted type wording in the scaladoc of several Row getters in the sql-api module. The phrase "value at position i of <type> type" had been copy-pasted from the date getters onto getters that return other types:

  • getGeometry: "of date type" -> "of geometry type"
  • getGeography: "of date type" -> "of geography type"
  • getTimestamp / getInstant: "of date type" -> "of timestamp type"
  • getJavaMap: "of array type" -> "of map type"

Why are the changes needed?

The type wording on these getters was incorrect (copy-pasted from sibling getters), which is misleading in the generated API docs.

Does this PR introduce any user-facing change?

No. Documentation-only; no behavior change.

How was this patch tested?

No tests needed (documentation only).

Was this patch authored or co-authored using generative AI tooling?

Generated-by: Claude Code(Opus 4.8)

### What changes were proposed in this pull request?

Fixes copy-pasted type wording in the scaladoc of several `Row` getters in the
sql-api module. The phrase "value at position i of `<type>` type" was copy-pasted
from the date getters onto getters that return other types:

- `getGeometry`: "of date type" -> "of geometry type"
- `getGeography`: "of date type" -> "of geography type"
- `getTimestamp` / `getInstant`: "of date type" -> "of timestamp type"
- `getJavaMap`: "of array type" -> "of map type"

### Why are the changes needed?

The type wording on these getters was incorrect (copy-pasted from sibling getters),
which is misleading in the generated API docs.

### Does this PR introduce _any_ user-facing change?

No. Documentation-only; no behavior change.

### How was this patch tested?

No tests needed (documentation only).

### Was this patch authored or co-authored using generative AI tooling?

Generated-by: Ducc

@MaxGekk MaxGekk left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM. I verified each reworded getter's Scaladoc now matches its actual return type (getGeometry→geometry, getGeography→geography, getTimestamp/getInstant→timestamp, getJavaMap→map) and lines up with the sibling getters' convention (getDate/getLocalDate=date, getSeq/getList=array, getMap=map, getStruct=struct).

I also checked for anything similar left to fix: grepping the rest of Row.scala shows no other "of <wrong> type" mismatch remains, and the pattern doesn't appear in any other hand-written source file (the only other occurrences are in the generated sql/api/target/java/.../Row.java, which regenerates from this source). So the fix is complete.

@dongjoon-hyun dongjoon-hyun left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

BTW, we had better get a JIRA ID because we need to backport this, @LuciferYang .

@uros-b uros-b left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thank you for the fix @LuciferYang!

LuciferYang added a commit that referenced this pull request Jul 17, 2026
### What changes were proposed in this pull request?

Fixes copy-pasted type wording in the scaladoc of several `Row` getters in the sql-api module. The phrase "value at position i of `<type>` type" had been copy-pasted from the date getters onto getters that return other types:

- `getGeometry`: "of date type" -> "of geometry type"
- `getGeography`: "of date type" -> "of geography type"
- `getTimestamp` / `getInstant`: "of date type" -> "of timestamp type"
- `getJavaMap`: "of array type" -> "of map type"

### Why are the changes needed?

The type wording on these getters was incorrect (copy-pasted from sibling getters), which is misleading in the generated API docs.

### Does this PR introduce _any_ user-facing change?

No. Documentation-only; no behavior change.

### How was this patch tested?

No tests needed (documentation only).

### Was this patch authored or co-authored using generative AI tooling?

Generated-by: Claude Code(Opus 4.8)

Closes #57240 from LuciferYang/SPARK-tier3-scaladoc-cleanup.

Authored-by: YangJie <yangjie01@baidu.com>
Signed-off-by: yangjie01 <yangjie01@baidu.com>
(cherry picked from commit 2abe31b)
Signed-off-by: yangjie01 <yangjie01@baidu.com>
@LuciferYang

Copy link
Copy Markdown
Contributor Author

Merge Summary:

Posted by merge_spark_pr.py

@LuciferYang

Copy link
Copy Markdown
Contributor Author

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants