连接

文件
文件	concatenate.hpp
	连接列的 API。

函数
rmm::device_buffer	cudf::concatenate_masks (host_span< column_view const > views, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	将 views 中所有元素的 views[i] 的位掩码从位 [views[i].offset(), views[i].offset() + views[i].size()) 连接到一个 rmm::device_buffer 中 更多...
std::unique_ptr< column >	cudf::concatenate (host_span< column_view const > columns_to_concat, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	将多个列连接成一个列。 更多...
std::unique_ptr< table >	cudf::concatenate (host_span< table_view const > tables_to_concat, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	将 tables_to_concat 的列垂直连接以返回一个表。 更多...

详细描述

函数文档

concatenate() [1/2]

std::unique_ptr<column> cudf::concatenate	(	host_span< column_view const >	columns_to_concat,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

将多个列连接成一个列。

异常

cudf::logic_error	如果输入列的类型不匹配
std::overflow_error	如果总输出行数超过 cudf::size_type

参数

columns_to_concat	要连接成一个列的 Column view
stream	用于设备内存操作和内核启动的 CUDA stream
mr	用于分配返回列的设备内存的设备内存资源

返回值

一个列，按相同顺序包含 columns_to_concat 中所有元素的行。

concatenate() [2/2]

std::unique_ptr<table> cudf::concatenate	(	host_span< table_view const >	tables_to_concat,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

将 tables_to_concat 的列垂直连接以返回一个表。

column_view c0 is {0,1,2,3}
column_view c1 is {4,5,6,7}
table_view t0{{c0, c0}};
table_view t1{{c1, c1}};
...
auto t = concatenate({t0.view(), t1.view()});
column_view tc0 = (t->view()).column(0) is {0,1,2,3,4,5,6,7}
column_view tc1 = (t->view()).column(1) is {0,1,2,3,4,5,6,7}

异常

cudf::logic_error	如果列数不匹配
std::overflow_error	如果总输出行数超过 cudf::size_type

参数

tables_to_concat	要连接成一个表的 Table view
stream	用于设备内存操作和内核启动的 CUDA stream
mr	用于分配返回表的设备内存的设备内存资源

返回值

一个表，按相同顺序包含 tables_to_concat 中所有元素的行。

concatenate_masks()

rmm::device_buffer cudf::concatenate_masks	(	host_span< column_view const >	views,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

将 views 中所有元素的 views[i] 的位掩码从位 [views[i].offset(), views[i].offset() + views[i].size()) 连接到一个 rmm::device_buffer 中

如果列不可为空，则返回空 buffer。

参数

views	要连接位掩码的 Column view
mr	用于分配返回内存的设备内存资源
stream	用于设备内存操作和内核启动的 CUDA stream

返回值

views vector 中所有 column view 的位掩码