Skip to content

[doc](function) Document ARRAY NULL ordering for min max - #4121

Open
Mryange wants to merge 2 commits into
apache:masterfrom
Mryange:doc-array-minmax-null-order
Open

Mryange wants to merge 2 commits into
apache:masterfrom
Mryange:doc-array-minmax-null-order

Conversation

@Mryange

@Mryange Mryange commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

What problem does this PR solve?

Issue Number: N/A

Problem Summary: The MIN and MAX documentation incorrectly described NULL array elements as the smallest values, while Doris compares ARRAY values lexicographically with NULL elements greater than non-NULL elements. MIN_BY and MAX_BY accepted ARRAY ordering expressions without documenting this behavior. This update documents the implemented ordering and distinguishes a NULL array value, which is ignored as a NULL aggregate input, from NULL elements inside an ARRAY.

Release note

None

Check List (For Author)

  • Test: git diff --check; documentation governance lint could not run because the checkout lacks the gray-matter dependency and yarn is unavailable.
  • Behavior changed: No
  • Does this need documentation: No

Mryange added a commit to apache/doris that referenced this pull request Sep 15, 2026
Problem Summary: Complex-type `min`, `max`, `min_by`, and `max_by` used
a NULL ordering direction different from ordinary SQL array comparisons.
This could select inconsistent results for arrays containing NULL
elements. The aggregate comparison direction is aligned with SQL array
ordering, and regression expectations are updated.


apache/doris-website#4121

### Release note

Complex-type aggregate ordering now follows SQL array NULL ordering.

### Check List (For Author)

- Test <!-- At least one of them must be included. -->
    - [ ] Regression test
    - [ ] Unit Test
    - [ ] Manual test (add detailed scripts or steps below)
    - [ ] No need to test or manual test. Explain why:
- [ ] This is a refactor/code format and no logic has been changed.
        - [ ] Previous test can cover this change.
        - [ ] No code files have been changed.
        - [ ] Other reason <!-- Add your reason?  -->

- Behavior changed:
    - [ ] No.
    - [ ] Yes. <!-- Explain the behavior change -->

- Does this need documentation?
    - [ ] No.
- [ ] Yes. <!-- Add document PR link here. eg:
apache/doris-website#1214 -->

### Check List (For Reviewer who merge this PR)

- [ ] Confirm the release note
- [ ] Confirm test cases
- [ ] Confirm document
- [ ] Add branch pick label <!-- Add branch pick label that this PR
should merge into -->
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.

1 participant