kszucs commented on code in PR #45001:
URL: https://github.com/apache/arrow/pull/45001#discussion_r4007443825
##########
cpp/src/arrow/compute/api_scalar.h:
##########
@@ -1786,5 +1786,42 @@ ARROW_EXPORT Result<Datum> NanosecondsBetween(const
Datum& left, const Datum& ri
/// \note API not yet finalized
ARROW_EXPORT Result<Datum> MapLookup(const Datum& map, MapLookupOptions
options,
ExecContext* ctx = NULLPTR);
+
+/// \brief Construct a hash value for each row of the input.
+///
+/// The result is an Array of length equal to the length of the input;
however, the output
+/// shall be a UInt32Array, with each element being a hash constructed from
each row of
+/// the input. If the input Array is a NestedArray, this means that each
"attribute" or
+/// "field" of the input NestedArray corresponding to the same "row" will
collectively
+/// produce a single uint64_t hash. At the moment, this function does not take
options,
+/// though these may be added in the future.
+///
+/// \param[in] input_array input data to hash
+/// \param[in] ctx function execution context, optional
+/// \return elementwise hash values
+///
+/// \since 19.0.0
Review Comment:
Now \since 26.0.0 — the target release moved on while this sat.
##########
cpp/src/arrow/compute/api_scalar.h:
##########
@@ -1786,5 +1786,42 @@ ARROW_EXPORT Result<Datum> NanosecondsBetween(const
Datum& left, const Datum& ri
/// \note API not yet finalized
ARROW_EXPORT Result<Datum> MapLookup(const Datum& map, MapLookupOptions
options,
ExecContext* ctx = NULLPTR);
+
+/// \brief Construct a hash value for each row of the input.
+///
+/// The result is an Array of length equal to the length of the input;
however, the output
+/// shall be a UInt32Array, with each element being a hash constructed from
each row of
+/// the input. If the input Array is a NestedArray, this means that each
"attribute" or
+/// "field" of the input NestedArray corresponding to the same "row" will
collectively
+/// produce a single uint64_t hash. At the moment, this function does not take
options,
+/// though these may be added in the future.
+///
+/// \param[in] input_array input data to hash
+/// \param[in] ctx function execution context, optional
+/// \return elementwise hash values
+///
+/// \since 19.0.0
+/// \note API not yet finalized
+ARROW_EXPORT
+Result<Datum> Hash32(const Datum& input_array, ExecContext* ctx = NULLPTR);
+
+/// \brief Construct a hash value for each row of the input.
+///
+/// The result is an Array of length equal to the length of the input;
however, the output
+/// shall be a UInt64Array, with each element being a hash constructed from
each row of
+/// the input. If the input Array is a NestedArray, this means that each
"attribute" or
+/// "field" of the input NestedArray corresponding to the same "row" will
collectively
+/// produce a single uint64_t hash. At the moment, this function does not take
options,
+/// though these may be added in the future.
+///
+/// \param[in] input_array input data to hash
+/// \param[in] ctx function execution context, optional
+/// \return elementwise hash values
+///
+/// \since 19.0.0
Review Comment:
Now \since 26.0.0, same as above.
##########
cpp/src/arrow/compute/api_scalar.h:
##########
@@ -1786,5 +1786,42 @@ ARROW_EXPORT Result<Datum> NanosecondsBetween(const
Datum& left, const Datum& ri
/// \note API not yet finalized
ARROW_EXPORT Result<Datum> MapLookup(const Datum& map, MapLookupOptions
options,
ExecContext* ctx = NULLPTR);
+
+/// \brief Construct a hash value for each row of the input.
+///
+/// The result is an Array of length equal to the length of the input;
however, the output
+/// shall be a UInt32Array, with each element being a hash constructed from
each row of
+/// the input. If the input Array is a NestedArray, this means that each
"attribute" or
+/// "field" of the input NestedArray corresponding to the same "row" will
collectively
+/// produce a single uint64_t hash. At the moment, this function does not take
options,
Review Comment:
Reworded — the docstring now says the result has element type UInt32.
##########
cpp/src/arrow/compute/kernels/scalar_hash_benchmark.cc:
##########
@@ -0,0 +1,188 @@
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+#include <algorithm>
+#include <cstdint>
+#include <limits>
+#include <random>
+#include <string>
+#include <vector>
+
+#include "benchmark/benchmark.h"
+
+#include "arrow/testing/gtest_util.h"
+#include "arrow/testing/random.h"
+#include "arrow/util/hashing.h"
+
+#include "arrow/array/array_nested.h"
+#include "arrow/compute/exec.h"
+
+namespace arrow {
+namespace internal {
+
+// ------------------------------
+// Anonymous namespace with global params
+
+namespace {
+// copied from scalar_string_benchmark
+constexpr auto kSeed = 0x94378165;
+constexpr double null_prob = 0.2;
+
+static random::RandomArrayGenerator hashing_rng(kSeed);
+} // namespace
+
+// ------------------------------
+// Convenience functions
+
+static Result<std::shared_ptr<StructArray>> MakeStructArray(int64_t n_values,
+ int32_t min_strlen,
+ int32_t
max_strlen) {
+ auto vals_first = hashing_rng.Int64(n_values, 0,
std::numeric_limits<int64_t>::max());
+ auto vals_second = hashing_rng.String(n_values, min_strlen, max_strlen,
null_prob);
+ auto vals_third = hashing_rng.Int64(n_values, 0,
std::numeric_limits<int64_t>::max());
+
+ return arrow::StructArray::Make(
+ arrow::ArrayVector{vals_first, vals_second, vals_third},
+ arrow::FieldVector{arrow::field("first", arrow::int64()),
+ arrow::field("second", arrow::utf8()),
+ arrow::field("third", arrow::int64())});
+}
+
+// ------------------------------
+// Benchmark implementations
+
+static void Hash64Int64(benchmark::State& state) { // NOLINT non-const
reference
+ auto test_vals = hashing_rng.Int64(10000, 0,
std::numeric_limits<int64_t>::max());
+
+ while (state.KeepRunning()) {
+ ASSERT_OK_AND_ASSIGN(Datum hash_result, compute::CallFunction("hash64",
{test_vals}));
+ benchmark::DoNotOptimize(hash_result);
+ }
+
+ state.SetBytesProcessed(state.iterations() * test_vals->length() *
sizeof(int64_t));
+ state.SetItemsProcessed(state.iterations() * test_vals->length());
+}
+
+static void Hash64StructSmallStrings(
+ benchmark::State& state) { // NOLINT non-const reference
+ ASSERT_OK_AND_ASSIGN(std::shared_ptr<StructArray> values_array,
+ MakeStructArray(10000, 2, 20));
+
+ // 2nd column (index 1) is a string column, which has offset type of int32_t
+ ASSERT_OK_AND_ASSIGN(std::shared_ptr<Array> values_second,
+ values_array->GetFlattenedField(1));
+ std::shared_ptr<StringArray> str_vals =
Review Comment:
Applied — `auto str_vals =` (scalar_hash_benchmark.cc:92).
##########
cpp/src/arrow/compute/kernels/scalar_hash_benchmark.cc:
##########
@@ -0,0 +1,188 @@
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+#include <algorithm>
+#include <cstdint>
+#include <limits>
+#include <random>
+#include <string>
+#include <vector>
+
+#include "benchmark/benchmark.h"
+
+#include "arrow/testing/gtest_util.h"
+#include "arrow/testing/random.h"
+#include "arrow/util/hashing.h"
+
+#include "arrow/array/array_nested.h"
+#include "arrow/compute/exec.h"
+
+namespace arrow {
+namespace internal {
+
+// ------------------------------
+// Anonymous namespace with global params
+
+namespace {
+// copied from scalar_string_benchmark
+constexpr auto kSeed = 0x94378165;
+constexpr double null_prob = 0.2;
+
+static random::RandomArrayGenerator hashing_rng(kSeed);
+} // namespace
+
+// ------------------------------
+// Convenience functions
+
+static Result<std::shared_ptr<StructArray>> MakeStructArray(int64_t n_values,
+ int32_t min_strlen,
+ int32_t
max_strlen) {
+ auto vals_first = hashing_rng.Int64(n_values, 0,
std::numeric_limits<int64_t>::max());
+ auto vals_second = hashing_rng.String(n_values, min_strlen, max_strlen,
null_prob);
+ auto vals_third = hashing_rng.Int64(n_values, 0,
std::numeric_limits<int64_t>::max());
+
+ return arrow::StructArray::Make(
+ arrow::ArrayVector{vals_first, vals_second, vals_third},
+ arrow::FieldVector{arrow::field("first", arrow::int64()),
+ arrow::field("second", arrow::utf8()),
+ arrow::field("third", arrow::int64())});
+}
+
+// ------------------------------
+// Benchmark implementations
+
+static void Hash64Int64(benchmark::State& state) { // NOLINT non-const
reference
+ auto test_vals = hashing_rng.Int64(10000, 0,
std::numeric_limits<int64_t>::max());
+
+ while (state.KeepRunning()) {
+ ASSERT_OK_AND_ASSIGN(Datum hash_result, compute::CallFunction("hash64",
{test_vals}));
+ benchmark::DoNotOptimize(hash_result);
+ }
+
+ state.SetBytesProcessed(state.iterations() * test_vals->length() *
sizeof(int64_t));
+ state.SetItemsProcessed(state.iterations() * test_vals->length());
+}
+
+static void Hash64StructSmallStrings(
+ benchmark::State& state) { // NOLINT non-const reference
+ ASSERT_OK_AND_ASSIGN(std::shared_ptr<StructArray> values_array,
+ MakeStructArray(10000, 2, 20));
+
+ // 2nd column (index 1) is a string column, which has offset type of int32_t
+ ASSERT_OK_AND_ASSIGN(std::shared_ptr<Array> values_second,
+ values_array->GetFlattenedField(1));
+ std::shared_ptr<StringArray> str_vals =
+ std::static_pointer_cast<StringArray>(values_second);
+ int32_t total_string_size = str_vals->total_values_length();
+
+ while (state.KeepRunning()) {
+ ASSERT_OK_AND_ASSIGN(Datum hash_result,
+ compute::CallFunction("hash64", {values_array}));
+ benchmark::DoNotOptimize(hash_result);
+ }
+
+ state.SetBytesProcessed(state.iterations() *
+ ((values_array->length() * sizeof(int64_t)) +
+ (total_string_size) +
+ (values_array->length() * sizeof(int64_t))));
+ state.SetItemsProcessed(state.iterations() * 3 * values_array->length());
+}
+
+static void Hash64StructMediumStrings(
+ benchmark::State& state) { // NOLINT non-const reference
+ ASSERT_OK_AND_ASSIGN(std::shared_ptr<StructArray> values_array,
+ MakeStructArray(10000, 20, 120));
+
+ // 2nd column (index 1) is a string column, which has offset type of int32_t
+ ASSERT_OK_AND_ASSIGN(std::shared_ptr<Array> values_second,
+ values_array->GetFlattenedField(1));
+ std::shared_ptr<StringArray> str_vals =
Review Comment:
Applied, same as above.
##########
cpp/src/arrow/compute/kernels/scalar_hash_benchmark.cc:
##########
@@ -0,0 +1,188 @@
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+#include <algorithm>
+#include <cstdint>
+#include <limits>
+#include <random>
+#include <string>
+#include <vector>
+
+#include "benchmark/benchmark.h"
+
+#include "arrow/testing/gtest_util.h"
+#include "arrow/testing/random.h"
+#include "arrow/util/hashing.h"
+
+#include "arrow/array/array_nested.h"
+#include "arrow/compute/exec.h"
+
+namespace arrow {
+namespace internal {
+
+// ------------------------------
+// Anonymous namespace with global params
+
+namespace {
+// copied from scalar_string_benchmark
+constexpr auto kSeed = 0x94378165;
+constexpr double null_prob = 0.2;
+
+static random::RandomArrayGenerator hashing_rng(kSeed);
+} // namespace
+
+// ------------------------------
+// Convenience functions
+
+static Result<std::shared_ptr<StructArray>> MakeStructArray(int64_t n_values,
+ int32_t min_strlen,
+ int32_t
max_strlen) {
+ auto vals_first = hashing_rng.Int64(n_values, 0,
std::numeric_limits<int64_t>::max());
+ auto vals_second = hashing_rng.String(n_values, min_strlen, max_strlen,
null_prob);
+ auto vals_third = hashing_rng.Int64(n_values, 0,
std::numeric_limits<int64_t>::max());
+
+ return arrow::StructArray::Make(
+ arrow::ArrayVector{vals_first, vals_second, vals_third},
+ arrow::FieldVector{arrow::field("first", arrow::int64()),
+ arrow::field("second", arrow::utf8()),
+ arrow::field("third", arrow::int64())});
+}
+
+// ------------------------------
+// Benchmark implementations
+
+static void Hash64Int64(benchmark::State& state) { // NOLINT non-const
reference
+ auto test_vals = hashing_rng.Int64(10000, 0,
std::numeric_limits<int64_t>::max());
+
+ while (state.KeepRunning()) {
+ ASSERT_OK_AND_ASSIGN(Datum hash_result, compute::CallFunction("hash64",
{test_vals}));
+ benchmark::DoNotOptimize(hash_result);
+ }
+
+ state.SetBytesProcessed(state.iterations() * test_vals->length() *
sizeof(int64_t));
+ state.SetItemsProcessed(state.iterations() * test_vals->length());
+}
+
+static void Hash64StructSmallStrings(
+ benchmark::State& state) { // NOLINT non-const reference
+ ASSERT_OK_AND_ASSIGN(std::shared_ptr<StructArray> values_array,
+ MakeStructArray(10000, 2, 20));
+
+ // 2nd column (index 1) is a string column, which has offset type of int32_t
+ ASSERT_OK_AND_ASSIGN(std::shared_ptr<Array> values_second,
+ values_array->GetFlattenedField(1));
+ std::shared_ptr<StringArray> str_vals =
+ std::static_pointer_cast<StringArray>(values_second);
+ int32_t total_string_size = str_vals->total_values_length();
+
+ while (state.KeepRunning()) {
+ ASSERT_OK_AND_ASSIGN(Datum hash_result,
+ compute::CallFunction("hash64", {values_array}));
+ benchmark::DoNotOptimize(hash_result);
+ }
+
+ state.SetBytesProcessed(state.iterations() *
+ ((values_array->length() * sizeof(int64_t)) +
+ (total_string_size) +
+ (values_array->length() * sizeof(int64_t))));
+ state.SetItemsProcessed(state.iterations() * 3 * values_array->length());
+}
+
+static void Hash64StructMediumStrings(
+ benchmark::State& state) { // NOLINT non-const reference
+ ASSERT_OK_AND_ASSIGN(std::shared_ptr<StructArray> values_array,
+ MakeStructArray(10000, 20, 120));
+
+ // 2nd column (index 1) is a string column, which has offset type of int32_t
+ ASSERT_OK_AND_ASSIGN(std::shared_ptr<Array> values_second,
+ values_array->GetFlattenedField(1));
+ std::shared_ptr<StringArray> str_vals =
+ std::static_pointer_cast<StringArray>(values_second);
+ int32_t total_string_size = str_vals->total_values_length();
+
+ while (state.KeepRunning()) {
+ ASSERT_OK_AND_ASSIGN(Datum hash_result,
+ compute::CallFunction("hash64", {values_array}));
+ benchmark::DoNotOptimize(hash_result);
+ }
+
+ state.SetBytesProcessed(state.iterations() *
+ ((values_array->length() * sizeof(int64_t)) +
+ (total_string_size) +
+ (values_array->length() * sizeof(int64_t))));
+ state.SetItemsProcessed(state.iterations() * 3 * values_array->length());
+}
+
+static void Hash64StructLargeStrings(
+ benchmark::State& state) { // NOLINT non-const reference
+ ASSERT_OK_AND_ASSIGN(std::shared_ptr<StructArray> values_array,
+ MakeStructArray(10000, 120, 2000));
+
+ // 2nd column (index 1) is a string column, which has offset type of int32_t
+ ASSERT_OK_AND_ASSIGN(std::shared_ptr<Array> values_second,
+ values_array->GetFlattenedField(1));
+ std::shared_ptr<StringArray> str_vals =
Review Comment:
Applied, same as above.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
