filtered_join.hpp
Go to the documentation of this file.
1 /*
2  * SPDX-FileCopyrightText: Copyright (c) 2025-2026, NVIDIA CORPORATION.
3  * SPDX-License-Identifier: Apache-2.0
4  */
5 
6 #pragma once
7 
9 #include <cudf/types.hpp>
11 #include <cudf/utilities/export.hpp>
13 
14 #include <rmm/cuda_stream_view.hpp>
15 #include <rmm/device_uvector.hpp>
16 
17 namespace CUDF_EXPORT cudf {
18 
25 namespace detail {
29 class filtered_join;
30 } // namespace detail
31 
47  public:
48  filtered_join() = delete;
49  ~filtered_join();
50  filtered_join(filtered_join const&) = delete;
51  filtered_join(filtered_join&&) = delete;
52  filtered_join& operator=(filtered_join const&) = delete;
53  filtered_join& operator=(filtered_join&&) = delete;
54 
66  cudf::null_equality compare_nulls,
67  rmm::cuda_stream_view stream);
68 
83  cudf::null_equality compare_nulls,
84  double load_factor,
85  rmm::cuda_stream_view stream);
86 
107  [[nodiscard]] std::unique_ptr<rmm::device_uvector<size_type>> semi_join(
108  cudf::table_view const& left,
111 
132  [[nodiscard]] std::unique_ptr<rmm::device_uvector<size_type>> anti_join(
133  cudf::table_view const& left,
136 
137  private:
138  std::unique_ptr<cudf::detail::filtered_join> _impl;
139 };
140  // end of group
142 
143 } // namespace CUDF_EXPORT cudf
Filtered hash join that builds a hash table from the right (filter) table on creation and probes resu...
std::unique_ptr< rmm::device_uvector< size_type > > anti_join(cudf::table_view const &left, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref()) const
Returns a vector of row indices corresponding to an anti-join between the specified tables.
std::unique_ptr< rmm::device_uvector< size_type > > semi_join(cudf::table_view const &left, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref()) const
Returns a vector of row indices corresponding to a semi-join between the specified tables.
filtered_join(cudf::table_view const &right, cudf::null_equality compare_nulls, double load_factor, rmm::cuda_stream_view stream)
Constructs a filtered hash join object for subsequent probe calls.
filtered_join(cudf::table_view const &right, cudf::null_equality compare_nulls, rmm::cuda_stream_view stream)
Constructs a filtered hash join object for subsequent probe calls.
A set of cudf::column_view's of the same size.
Definition: table_view.hpp:189
rmm::cuda_stream_view const get_default_stream()
Get the current default stream.
rmm::device_async_resource_ref get_current_device_resource_ref()
Get the current device memory resource reference.
cuda::mr::resource_ref< cuda::mr::device_accessible > device_async_resource_ref
null_equality
Enum to consider two nulls as equal or unequal.
Definition: types.hpp:141
cuDF interfaces
Definition: host_udf.hpp:26
Class definitions for (mutable)_table_view
Type declarations for libcudf.