Skip to content

Commit d7482ca

Browse files
Merge branch 'main' into fix-14734-regex-escaped-newlines
2 parents dc8952b + 9af44c6 commit d7482ca

107 files changed

Lines changed: 4883 additions & 1258 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/ISSUE_TEMPLATE/bug_report.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: Bug report
3-
about: Create a bug report to help us improve RAPIDS Accelerator for Apache Spark
3+
about: Create a bug report to help us improve the NVIDIA cuDF plugin for Apache Spark
44
title: "[BUG]"
55
labels: "? - Needs Triage, bug"
66
assignees: ''

.github/ISSUE_TEMPLATE/feature_request.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: Feature request
3-
about: Suggest an idea for RAPIDS Accelerator for Apache Spark
3+
about: Suggest an idea for the NVIDIA cuDF plugin for Apache Spark
44
title: "[FEA]"
55
labels: "? - Needs Triage, feature request"
66
assignees: ''

.github/ISSUE_TEMPLATE/submit-question.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: Submit question
3-
about: Ask a general question about RAPIDS Accelerator for Apache Spark here, or open a thread in the Discussions tab
3+
about: Ask a general question about the NVIDIA cuDF plugin for Apache Spark here, or open a thread in the Discussions tab
44
title: "[QST]"
55
labels: "? - Needs Triage, question"
66
assignees: ''

.github/PULL_REQUEST_TEMPLATE.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
<!--
22
3-
Thank you for contributing to RAPIDS Accelerator for Apache Spark!
3+
Thank you for contributing to the NVIDIA cuDF plugin for Apache Spark!
44
5-
Please read https://github.com/NVIDIA/spark-rapids/blob/HEAD/CONTRIBUTING.md#creating-a-pull-request before making this PR.
5+
Please read https://github.com/NVIDIA/cudf-spark/blob/HEAD/CONTRIBUTING.md#creating-a-pull-request before making this PR.
66
77
The following are the guidelines to help the review process go smoothly. Please read them carefully and fill out relevant information as much as possible.
88

.github/copilot-instructions.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# GitHub Copilot Review Instructions for spark-rapids
22

3-
spark-rapids is a GPU acceleration plugin for Apache Spark.
3+
cudf-spark is a GPU acceleration plugin for Apache Spark.
44
For full project context, coding conventions, and code examples,
55
see [AGENTS.md](../AGENTS.md).
66

@@ -10,7 +10,7 @@ When reviewing shim code or GPU operator implementations, cross-reference
1010
these upstream repositories to verify correctness:
1111
- **apache/spark** — verify GPU behavior matches the CPU implementation in the target Spark version (expression evaluation semantics, null handling, type coercion, catalog/partition behavior)
1212
- **rapidsai/cudf** — verify cuDF API usage (column operations, memory allocation semantics, null handling)
13-
- **NVIDIA/spark-rapids-jni** — verify JNI binding signatures, memory ownership rules, error codes
13+
- **NVIDIA/cudf-spark-jni** — verify JNI binding signatures, memory ownership rules, error codes
1414

1515
## Review Checklist
1616

@@ -26,7 +26,7 @@ these upstream repositories to verify correctness:
2626
- [ ] H5: Configuration — new RapidsConf without docs/defaults; should use .internal() if not user-visible; new features default off
2727
- [ ] H6: Magic numbers — unexplained numeric literals without named constants or comments
2828
- [ ] H7: Pre-merge CI gaps — only selected shims run unit tests; [databricks] needed for DB CI; feature-gated tests need explicit enable; limited Scala 2.13 coverage
29-
- [ ] H8: Upstream dependencies — SNAPSHOT changes from spark-rapids-jni/cudf may break; verify API usage against upstream repos
29+
- [ ] H8: Upstream dependencies — SNAPSHOT changes from cudf-spark-jni/cudf may break; verify API usage against upstream repos
3030

3131
## Do NOT Comment On
3232

CODE_OF_CONDUCT.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## Overview
44

5-
Define the code of conduct followed and enforced by the RAPIDS Accelerator for Apache Spark project
5+
Define the code of conduct followed and enforced by the NVIDIA cuDF plugin for Apache Spark project
66

77
### Intended audience
88

CONTRIBUTING.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
1-
# Contributing to RAPIDS Accelerator for Apache Spark
1+
# Contributing to the NVIDIA cuDF plugin for Apache Spark
22

3-
Contributions to RAPIDS Accelerator for Apache Spark fall into the following three categories.
3+
Contributions to the NVIDIA cuDF plugin for Apache Spark fall into the following three categories.
44

55
1. To report a bug, request a new feature, or report a problem with
6-
documentation, please file an [issue](https://github.com/NVIDIA/spark-rapids/issues/new/choose)
6+
documentation, please file an [issue](https://github.com/NVIDIA/cudf-spark/issues/new/choose)
77
describing in detail the problem or new feature. The project team evaluates
88
and triages issues, and schedules them for a release. If you believe the
99
issue needs priority attention, please comment on the issue to notify the
1010
team.
1111
2. To propose and implement a new Feature, please file a new feature request
12-
[issue](https://github.com/NVIDIA/spark-rapids/issues/new/choose). Describe the
12+
[issue](https://github.com/NVIDIA/cudf-spark/issues/new/choose). Describe the
1313
intended feature and discuss the design and implementation with the team and
1414
community. Once the team agrees that the plan looks good, go ahead and
1515
implement it using the [code contributions](#code-contributions) guide below.
@@ -48,7 +48,7 @@ building at least running to the `verify` phase, e.g.:
4848
mvn verify
4949
```
5050

51-
After a successful build, the RAPIDS Accelerator jar will be in the `dist/target/` directory.
51+
After a successful build, the cuDF plugin jar will be in the `dist/target/` directory.
5252
This will build the plugin for a single version of Spark. By default, this is Apache Spark
5353
3.3.0. To build against other versions of Spark you use the `-Dbuildver=XXX` command line option
5454
to Maven. For instance to build Spark 3.3.0 you would use:
@@ -83,7 +83,7 @@ build versions. See the next section for more details.
8383

8484
You might see a warning during scala-maven-plugin compile goal invocation.
8585
```
86-
[INFO] Compiling 94 Scala sources and 1 Java source to /home/user/gits/NVIDIA/spark-rapids/tests/target/spark3XY/test-classes ...
86+
[INFO] Compiling 94 Scala sources and 1 Java source to /home/user/gits/NVIDIA/cudf-spark/tests/target/spark3XY/test-classes ...
8787
OpenJDK 64-Bit Server VM warning: CodeCache is full. Compiler has been disabled.
8888
OpenJDK 64-Bit Server VM warning: Try increasing the code cache size using -XX:ReservedCodeCacheSize=
8989
CodeCache: size=245760Kb used=236139Kb max_used=243799Kb free=9620Kb
@@ -167,7 +167,7 @@ In many situations the user knows that the Plugin jar will be deployed for a sin
167167
release. It is most commonly the case when a container image for a cloud or local deployment includes
168168
Spark binaries as well. In such a case it is advantageous to create a jar with
169169
a conventional class directory structure avoiding complications such as
170-
[#3704](https://github.com/NVIDIA/spark-rapids/issues/3704). To this end add
170+
[#3704](https://github.com/NVIDIA/cudf-spark/issues/3704). To this end add
171171
`-DallowConventionalDistJar=true` when invoking Maven.
172172
173173
```bash
@@ -214,15 +214,15 @@ for a single Spark version Shim alone.
214214
To this end in a pre-production build you can set the Boolean property
215215
`dist.jar.compress` to `false`, its default value is `true`.
216216
217-
Furthermore, after the first build execution on the clean repository the spark-rapids-jni
217+
Furthermore, after the first build execution on the clean repository the cudf-spark-jni
218218
SNAPSHOT dependency typically does not change until the next nightly CI build, or the next install
219219
to the local Maven repo if you are working on a change to the native code. So you can save
220220
significant time spent on repeated unpacking these dependencies by adding `-Drapids.jni.unpack.skip`
221221
to the `dist` build command.
222222
223223
The time saved is more significant if you are merely changing
224224
the `aggregator` module, or the `dist` module, or just incorporating changes from
225-
[spark-rapids-jni](https://github.com/NVIDIA/spark-rapids-jni/blob/branch-23.04/CONTRIBUTING.md#local-testing-of-cross-repo-contributions-cudf-spark-rapids-jni-and-spark-rapids)
225+
[cudf-spark-jni](https://github.com/NVIDIA/cudf-spark-jni/blob/branch-23.04/CONTRIBUTING.md#local-testing-of-cross-repo-contributions-cudf-spark-rapids-jni-and-spark-rapids)
226226
227227
For example, to quickly repackage `rapids-4-spark` after the
228228
initial `./build/buildall` you can iterate by invoking
@@ -280,7 +280,7 @@ Last tested with IntelliJ IDEA 2023.1.2 (Community Edition)
280280
281281
##### Manual Maven Install for a target Spark build
282282
283-
Before proceeding with importing spark-rapids into IDEA or switching to a different Spark release
283+
Before proceeding with importing cudf-spark into IDEA or switching to a different Spark release
284284
profile, execute the install phase with the corresponding `buildver`, e.g. for Spark 3.4.0:
285285
286286
```bash
@@ -378,7 +378,7 @@ rm -vf .bloop
378378
ln -s .bloop-spark330 .bloop
379379
```
380380
381-
You can now open the spark-rapids as a
381+
You can now open the cudf-spark as a
382382
[BSP project in IDEA](https://www.jetbrains.com/help/idea/bsp-support.html)
383383
384384
Read on for VS Code Scala Metals instructions.
@@ -446,15 +446,15 @@ We welcome pull requests with tips on how to setup your favorite IDE!
446446
447447
### Your first issue
448448
449-
1. Read the [Developer Overview](docs/dev/README.md) to understand how the RAPIDS Accelerator
449+
1. Read the [Developer Overview](docs/dev/README.md) to understand how the cuDF
450450
plugin works.
451451
2. Find an issue to work on. The best way is to look for the
452-
[good first issue](https://github.com/NVIDIA/spark-rapids/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)
453-
or [help wanted](https://github.com/NVIDIA/spark-rapids/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22)
452+
[good first issue](https://github.com/NVIDIA/cudf-spark/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)
453+
or [help wanted](https://github.com/NVIDIA/cudf-spark/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22)
454454
labels.
455455
3. Comment on the issue stating that you are going to work on it.
456456
4. Code! Make sure to update unit tests and integration tests if needed! [refer to test section](#testing-your-code)
457-
5. When done, [create your pull request](https://github.com/NVIDIA/spark-rapids/compare).
457+
5. When done, [create your pull request](https://github.com/NVIDIA/cudf-spark/compare).
458458
6. Verify that CI passes all [status checks](https://help.github.com/articles/about-status-checks/).
459459
Fix if needed.
460460
7. Wait for other developers to review your code and update code as needed.
@@ -464,7 +464,7 @@ Remember, if you are unsure about anything, don't hesitate to comment on issues
464464
and ask for clarifications!
465465
466466
### Code Formatting
467-
RAPIDS Accelerator for Apache Spark follows the same coding style guidelines as the Apache Spark
467+
The NVIDIA cuDF plugin for Apache Spark follows the same coding style guidelines as the Apache Spark
468468
project. For IntelliJ IDEA users, an
469469
[example code style settings file](docs/dev/idea-code-style-settings.xml) is available in the
470470
`docs/dev/` directory.

DF_UDF_README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,21 +7,21 @@ are also used as a way to standardize processing logic across an organization or
77
But UDFs come with some downsides. The biggest one is visibility into the processing being done. SQL is a language that
88
can be highly optimized. But a UDF in most cases is a black box, that the SQL optimizer cannot do anything about.
99
This can result in less than ideal query planning. Additionally, accelerated execution environments, like the
10-
RAPIDS Accelerator for Apache Spark have no easy way to replace UDFs with accelerated versions, which can result in
10+
NVIDIA cuDF plugin for Apache Spark have no easy way to replace UDFs with accelerated versions, which can result in
1111
slow performance.
1212

1313
This attempts to add visibility to the code reuse use case by providing a way to implement a UDF in terms of dataframe
1414
commands.
1515

1616
## Setup
1717

18-
The dataframe UDF plugin is packaged in the same jar as the RAPIDS Accelerator for Apache Spark. This jar will need to
18+
The dataframe UDF plugin is packaged in the same jar as the cuDF plugin. This jar will need to
1919
be added as a compile time dependency for code that wants to use this feature as well as adding the jar to your Spark
2020
classpath just like you would do for GPU acceleration.
2121

2222
If you plan to not use the GPU accelerated processing, but still want dataframe UDF support on CPU applications then
2323
add `com.nvidia.spark.DFUDFPlugin` to the `spark.sql.extensions` config. If you do use GPU accelerated processing
24-
the RAPIDS Plugin will enable this automatically. You don't need to set the `spark.sql.extensions` config, but it
24+
the cuDF plugin will enable this automatically. You don't need to set the `spark.sql.extensions` config, but it
2525
won't hurt anything if you do add it. Now you can implement a UDF in terms of Dataframe operations.
2626

2727
## Usage

README.md

Lines changed: 16 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,19 @@
1-
# RAPIDS Accelerator For Apache Spark
2-
NOTE: For the latest stable [README.md](https://github.com/nvidia/spark-rapids/blob/main/README.md) ensure you are on the main branch.
1+
# NVIDIA cuDF plugin for Apache Spark
2+
NOTE: For the latest stable [README.md](https://github.com/nvidia/cudf-spark/blob/main/README.md) ensure you are on the main branch.
33

4-
The RAPIDS Accelerator for Apache Spark provides a set of plugins for
5-
[Apache Spark](https://spark.apache.org) that leverage GPUs to accelerate processing
6-
via the [RAPIDS](https://rapids.ai) libraries.
4+
The NVIDIA cuDF plugin for [Apache Spark](https://spark.apache.org) provides a plugin library that
5+
leverages GPUs to accelerate processing via the [cuDF](https://github.com/rapidsai/cudf) (CUDA
6+
DataFrame) libraries.
77

88
Documentation on the current release can be found [here](https://nvidia.github.io/cudf-spark/).
99

1010
To get started and try the plugin out use the [getting started guide](https://docs.nvidia.com/spark-rapids/user-guide/latest/getting-started/overview.html).
1111

12-
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/NVIDIA/spark-rapids)
12+
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/NVIDIA/cudf-spark)
13+
14+
Note: The NVIDIA cuDF plugin for Apache Spark was formerly known as the RAPIDS Accelerator for
15+
Apache Spark. The RAPIDS name will be sunset over time. Github links from `spark-rapids` will
16+
redirect to `cudf-spark`. Artifact names will remain the same for now.
1317

1418
## Compatibility
1519

@@ -29,8 +33,8 @@ The plugin has a set of Spark configs that control its behavior and are document
2933
## Issues & Questions
3034

3135
We use github to track bugs, feature requests, and answer questions. File an
32-
[issue](https://github.com/NVIDIA/spark-rapids/issues/new/choose) for a bug or feature request. Ask
33-
or answer a question on the [discussion board](https://github.com/NVIDIA/spark-rapids/discussions).
36+
[issue](https://github.com/NVIDIA/cudf-spark/issues/new/choose) for a bug or feature request. Ask
37+
or answer a question on the [discussion board](https://github.com/NVIDIA/cudf-spark/discussions).
3438

3539
## Download
3640

@@ -46,8 +50,8 @@ See the [build instructions in the contributing guide](CONTRIBUTING.md#building-
4650
Tests are described [here](tests/README.md).
4751

4852
## Integration
49-
The RAPIDS Accelerator For Apache Spark does provide some APIs for doing zero copy data
50-
transfer into other GPU enabled applications. It is described
53+
The cuDF plugin provides some APIs for doing zero copy data transfer into other GPU enabled
54+
applications. It is described
5155
[here](https://docs.nvidia.com/spark-rapids/user-guide/latest/additional-functionality/ml-integration.html).
5256

5357
Currently, we are working with XGBoost to try to provide this integration out of the box.
@@ -67,9 +71,8 @@ for more details on how to use the tools.
6771

6872
## Dependency for External Projects
6973

70-
If you need to develop some functionality on top of RAPIDS Accelerator For Apache Spark (we currently
71-
limit support to GPU-accelerated UDFs) we recommend you declare our distribution artifact
72-
as a `provided` dependency.
74+
If you develop functionality on top of the cuDF plugin (we currently limit support to
75+
GPU-accelerated UDFs) we recommend you declare the distribution artifact as a `provided` dependency.
7376

7477
```xml
7578
<dependency>

datagen/README.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,12 +8,11 @@ data between tables for joins. To accomplish this we wrote
88

99
## Setup Environment
1010

11-
To get started with big data generation the first thing you need to do is
12-
to include the appropriate jar on the classpath for your version of Apache Spark.
13-
Note that this does not run on the GPU, but it does use parts of the shim framework
14-
that the RAPIDS Accelerator does. The jar is specific to the version of Spark you
15-
are using and is not pushed to Maven Central. Because of this you will have to
16-
build it from source yourself.
11+
To get started with big data generation the first thing you need to do is to include the appropriate
12+
jar on the classpath for your version of Apache Spark. Note that this does not run on the GPU, but
13+
it does use parts of the shim framework that the NVIDIA cuDF plugin for Apache Spark does. The jar
14+
is specific to the version of Spark you are using and is not pushed to Maven Central. Because of
15+
this you will have to build it from source yourself.
1716

1817
```shell
1918
cd datagen
@@ -344,7 +343,7 @@ spark.time(fdf.join(ddf).groupBy("agg_key").agg(min("value"),
344343
Time taken: 890163 ms
345344
```
346345

347-
Or you could run it with the RAPIDS Accelerator where the data generations is still
346+
Or you could run it with the cuDF plugin where the data generations is still
348347
done on the CPU and cut the time down to just 75,696 ms
349348

350349
But what if we wanted to join on multiple columns, or do an aggregation with

0 commit comments

Comments
 (0)