[Enhancement](mmhash) Support mmhash3_u64_v2

[linrrzqqq]

What problem does this PR solve?

Issue Number: close #xxx

Related PR: #xxx

Problem Summary:

Release note

doc : apache/doris-website#3499

Support function murmur_hash3_u64_v2(str)

Doris> SELECT 
    ->     str, 
    ->     expect,
    ->     mmhash3_64_v2,
    ->     mmhash3_u64_v2,
    ->     (mmhash3_u64_v2 = expect AND mmhash3_u64_v2 = i64_to_ui64) AS is_equal
    -> FROM (
    ->     SELECT 
    ->         str, 
    ->         expect, 
    ->         murmur_hash3_64_v2(str) AS mmhash3_64_v2,
    ->     murmur_hash3_u64_v2(str) AS mmhash3_u64_v2,
    ->         CAST(murmur_hash3_64_v2(str) AS LARGEINT) & 18446744073709551615 AS i64_to_ui64
    ->     FROM test_mmhash
    -> ) t;
+-----------------------+----------------------+----------------------+----------------------+----------+
| str                   | expect               | mmhash3_64_v2        | mmhash3_u64_v2       | is_equal |
+-----------------------+----------------------+----------------------+----------------------+----------+
| 1001221503_1756808272 | 5812833316175944114  |  5812833316175944114 | 5812833316175944114  |        1 |
| 1013199993_1756808272 | 15798640563451009166 | -2648103510258542450 | 15798640563451009166 |        1 |
| 1020273884_1756808272 | 12805835714636863314 | -5640908359072688302 | 12805835714636863314 |        1 |
| 1105507704_1756808272 | 2845780245957209604  |  2845780245957209604 | 2845780245957209604  |        1 |
+-----------------------+----------------------+----------------------+----------------------+----------+

Check List (For Author)

• Test

  • 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

• Behavior changed:

  • No.
  • Yes.

• Does this need documentation?

  • No.
  • Yes. [Enhancement](mmhash) Support mmhash3_u64_v2 doris-website#3499

Check List (For Reviewer who merge this PR)

• Confirm the release note
• Confirm test cases
• Confirm document
• Add branch pick label

[hello-stephen]

Thank you for your contribution to Apache Doris.
Don't know what should be done next? See How to process your PR.

Please clearly describe your PR:

1. What problem was fixed (it's best to include specific error reporting information). How it was fixed.
2. Which behaviors were modified. What was the previous behavior, what is it now, why was it modified, and what possible impacts might there be.
3. What features were added. Why was this function added?
4. Which code was refactored and why was this part of the code refactored?
5. Which functions were optimized and what is the difference before and after the optimization?

[linrrzqqq]

run buildall

[hello-stephen]

FE UT Coverage Report

Increment line coverage 7.69% (1/13) 🎉
Increment coverage report
Complete coverage report

[doris-robot]

TPC-H: Total hot run time: 27009 ms

machine: 'aliyun_ecs.c7a.8xlarge_32C64G'
scripts: https://github.com/apache/doris/tree/master/tools/tpch-tools
Tpch sf100 test result on commit 314c1b3d028a82c48428cf9664c3d68c727cd95a, data reload: false

------ Round 1 ----------------------------------
orders	Doris	NULL	NULL	0	0	0	NULL	0	NULL	NULL	2023-12-26 18:27:23	2023-12-26 18:42:55	NULL	utf-8	NULL	NULL	
============================================
q1	17635	4443	4335	4335
q2	q3	10637	828	533	533
q4	4682	355	243	243
q5	7631	1201	998	998
q6	182	171	144	144
q7	785	838	667	667
q8	9998	1505	1332	1332
q9	5548	4759	4716	4716
q10	6324	1926	1637	1637
q11	474	235	256	235
q12	748	575	473	473
q13	18056	2808	1919	1919
q14	226	240	215	215
q15	q16	754	744	680	680
q17	750	837	466	466
q18	6245	5435	5326	5326
q19	1128	987	630	630
q20	549	490	376	376
q21	4528	1819	1825	1819
q22	373	352	265	265
Total cold run time: 97253 ms
Total hot run time: 27009 ms

----- Round 2, with runtime_filter_mode=off -----
orders	Doris	NULL	NULL	150000000	42	6422171781	NULL	22778155	NULL	NULL	2023-12-26 18:27:23	2023-12-26 18:42:55	NULL	utf-8	NULL	NULL	
============================================
q1	4800	4544	4559	4544
q2	q3	3892	4318	3820	3820
q4	916	1211	782	782
q5	4107	4578	4326	4326
q6	178	173	138	138
q7	1795	1654	1546	1546
q8	2525	2760	2648	2648
q9	7550	7392	7443	7392
q10	3731	4049	3558	3558
q11	528	443	430	430
q12	486	619	442	442
q13	2487	3101	2202	2202
q14	310	299	283	283
q15	q16	726	800	802	800
q17	1203	1427	1403	1403
q18	7202	6805	6689	6689
q19	927	1021	1059	1021
q20	2120	2198	2024	2024
q21	3992	3560	3352	3352
q22	447	433	396	396
Total cold run time: 49922 ms
Total hot run time: 47796 ms

[doris-robot]

TPC-DS: Total hot run time: 168322 ms

machine: 'aliyun_ecs.c7a.8xlarge_32C64G'
scripts: https://github.com/apache/doris/tree/master/tools/tpcds-tools
TPC-DS sf100 test result on commit 314c1b3d028a82c48428cf9664c3d68c727cd95a, data reload: false

query5	4325	635	525	525
query6	330	237	201	201
query7	4221	457	265	265
query8	341	237	222	222
query9	8744	2731	2697	2697
query10	533	397	345	345
query11	6970	5121	4876	4876
query12	184	122	121	121
query13	1325	458	347	347
query14	5793	3717	3475	3475
query14_1	2828	2793	2824	2793
query15	206	195	173	173
query16	985	491	457	457
query17	907	734	660	660
query18	2436	453	346	346
query19	218	207	184	184
query20	127	123	120	120
query21	208	132	111	111
query22	13190	14009	14689	14009
query23	16810	16256	15986	15986
query23_1	16101	15683	15557	15557
query24	7117	1599	1209	1209
query24_1	1212	1198	1216	1198
query25	551	460	403	403
query26	1249	268	151	151
query27	2773	478	299	299
query28	4477	1833	1826	1826
query29	824	566	478	478
query30	299	221	190	190
query31	1014	938	889	889
query32	83	72	65	65
query33	518	336	285	285
query34	905	870	532	532
query35	646	686	596	596
query36	1098	1138	950	950
query37	138	98	84	84
query38	2950	2870	2918	2870
query39	860	813	807	807
query39_1	797	797	784	784
query40	231	155	134	134
query41	77	70	73	70
query42	261	255	251	251
query43	235	245	227	227
query44	
query45	199	189	181	181
query46	862	988	590	590
query47	2081	2153	2075	2075
query48	305	314	231	231
query49	639	459	396	396
query50	683	277	213	213
query51	4107	4073	4042	4042
query52	263	268	252	252
query53	287	335	287	287
query54	316	265	257	257
query55	91	87	85	85
query56	319	319	301	301
query57	1920	1688	1812	1688
query58	279	258	263	258
query59	2787	2923	2763	2763
query60	338	333	315	315
query61	157	154	150	150
query62	616	587	531	531
query63	308	272	277	272
query64	5047	1299	995	995
query65	
query66	1464	452	347	347
query67	24167	24235	24228	24228
query68	
query69	394	307	296	296
query70	988	957	966	957
query71	331	319	281	281
query72	2818	2673	2419	2419
query73	541	558	334	334
query74	9626	9570	9360	9360
query75	2856	2753	2453	2453
query76	2295	1036	661	661
query77	361	384	308	308
query78	11055	11202	10432	10432
query79	1107	767	580	580
query80	891	605	535	535
query81	526	261	229	229
query82	1345	158	118	118
query83	339	268	242	242
query84	303	124	100	100
query85	919	498	456	456
query86	388	311	297	297
query87	3173	3078	3039	3039
query88	3555	2677	2658	2658
query89	455	365	346	346
query90	1884	176	173	173
query91	185	167	142	142
query92	76	72	76	72
query93	898	840	508	508
query94	518	283	308	283
query95	584	347	309	309
query96	652	523	229	229
query97	2467	2470	2390	2390
query98	232	216	217	216
query99	974	989	921	921
Total cold run time: 249611 ms
Total hot run time: 168322 ms

[doris-robot]

BE UT Coverage Report

Increment line coverage 🎉

Increment coverage report
Complete coverage report

Category	Coverage
Function Coverage	52.89% (19936/37690)
Line Coverage	36.41% (186800/513003)
Region Coverage	32.67% (144848/443387)
Branch Coverage	33.87% (63514/187544)

[hello-stephen]

BE Regression && UT Coverage Report

Increment line coverage 100% (0/0) 🎉

Increment coverage report
Complete coverage report

Category	Coverage
Function Coverage	71.86% (26524/36913)
Line Coverage	54.72% (279898/511470)
Region Coverage	51.86% (232088/447509)
Branch Coverage	53.39% (100433/188110)

[zclllyybb]

/review

[Copilot]

Pull request overview

Adds a new hash scalar function murmur_hash3_u64_v2 (unsigned 64-bit MurmurHash3 v2 exposed as LARGEINT) across FE/Nereids and BE, plus regression coverage to validate results and null handling.

Changes:

• Register murmur_hash3_u64_v2 in FE (builtin function list + Nereids expression/visitor support).
• Implement and register the BE function variant returning Int128 to represent unsigned 64-bit results.
• Extend regression tests and golden outputs for the new function (including table + multi-arg cases).

Reviewed changes

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

Show a summary per file

File	Description
regression-test/suites/query_p0/sql_functions/hash_functions/test_hash_function.groovy	Adds query tests + validation helper and table coverage for murmur_hash3_u64_v2.
regression-test/data/query_p0/sql_functions/hash_functions/test_hash_function.out	Adds expected outputs for the new test cases.
fe/fe-core/src/main/java/org/apache/doris/nereids/trees/expressions/visitor/ScalarFunctionVisitor.java	Adds visitor hook for the new scalar function.
fe/fe-core/src/main/java/org/apache/doris/nereids/trees/expressions/functions/scalar/MurmurHash3U64V2.java	Introduces Nereids scalar function definition/signatures for murmur_hash3_u64_v2.
fe/fe-core/src/main/java/org/apache/doris/catalog/BuiltinScalarFunctions.java	Registers the new function as a builtin scalar.
be/src/exprs/function/function_hash.cpp	Adds BE implementation/registration for murmur_hash3_u64_v2 using Int128 output.

---

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

[github-actions]

Code Review Summary for Enhancement Support mmhash3_u64_v2

This PR adds a new murmur_hash3_u64_v2 function that returns the unsigned 64-bit murmur hash value as a LARGEINT type. The approach reuses the existing MurmurHash3Impl template with TYPE_LARGEINT as the return type, storing the uint64_t hash result in a __int128_t column to preserve unsigned semantics.

Critical Checkpoint Conclusions

• Goal / Does the code accomplish it? Yes. The function correctly returns the unsigned interpretation of the murmur_hash3_64_v2 hash value by storing uint64_t in LARGEINT (__int128_t). Tests verify murmur_hash3_u64_v2(x) == CAST(murmur_hash3_64_v2(x) AS LARGEINT) & 0xFFFFFFFFFFFFFFFF.

• Is the modification minimal and focused? Yes. The change is small and focused: 5 lines in BE, a new FE function class following the exact pattern of MurmurHash364V2, and comprehensive tests.

• Concurrency? Not applicable. No concurrent data structures involved.

• Lifecycle / static init? Not applicable.

• Configuration items? None added.

• Incompatible changes / rolling upgrades? No incompatible changes. This is purely additive (new function). Mixed-version clusters will simply not recognize murmur_hash3_u64_v2 on older nodes, which is expected behavior for new functions.

• Parallel code paths? The static_cast<uint64_t> change to the seed parameter affects the shared execute() code path for all non-TYPE_INT instantiations. For the existing TYPE_BIGINT case, static_cast<uint64_t>(int64_t) is identical to the previous implicit conversion — no behavioral change. For TYPE_LARGEINT, the cast correctly truncates to the lower 64 bits (upper bits are always zero since values come from murmur_hash3_64() widened to __int128_t).

• Special conditional checks? The get_name() template uses if constexpr with correct ordering: TYPE_INT → TYPE_LARGEINT → is_mmh64_v2 → default. All four instantiations resolve correctly.

• FE-BE type consistency? FE returns LargeIntType, BE uses DataTypeInt128 / ColumnVector<TYPE_LARGEINT> — these are consistent.

• Test coverage? Good coverage: null handling, empty string, single-arg, multi-arg (2 and 3 args), table-based tests, constant folding tests, and cross-validation against the masked murmur_hash3_64_v2 result. Expected output values verified correct (e.g., 2^64 + (-2648103510258542450) = 15798640563451009166).

• Observability? Not needed for a pure scalar function.

• Transaction / persistence? Not applicable.

• FE-BE variable passing? Not applicable.

• Performance? Using LARGEINT (__int128_t) doubles memory per hash value (16 bytes vs 8 bytes needed). This is a design trade-off since Doris lacks an unsigned 64-bit type, and using LARGEINT is the standard approach. No performance anti-patterns.

• Other issues? One minor test standards issue: the test drops the table at the end of the test (line 95 of groovy), which goes against the coding standard of preserving tables for debugging. See inline comment.

Overall

The implementation is correct and well-tested. One minor test standards issue noted.

[zclllyybb]

LGTM

[github-actions]

PR approved by at least one committer and no changes requested.

[github-actions]

PR approved by anyone and no changes requested.