Skip to content

Commit de036ab

Browse files
committed
docs: Second review of fallback
1 parent 575def4 commit de036ab

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

vignettes/fallback.Rmd

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ This is achieved in two ways:
5151
- A carefully selected subset of dplyr operations, R functions, and R data types are implemented in DuckDB, focusing on faithful translation.
5252
- When DuckDB does not support an operation, duckplyr falls back to dplyr, guaranteeing identical behavior.
5353

54-
## DuckDB operation
54+
## DuckDB mode
5555

5656
The following operation is supported by duckplyr:
5757

@@ -76,8 +76,8 @@ The plan shows three operations:
7676
- a sort operation,
7777
- a projection (adding the `b` column and removing the `a` column).
7878

79-
Because each operation is supported by DuckDB, the resulting object contains a plan for the entire pipeline.
80-
The plan is only executed when the data is needed.
79+
Each operation is supported by DuckDB.
80+
The resulting object contains a plan for the entire pipeline that is executed lazily, only when the data is needed.
8181

8282
## Relation objects
8383

@@ -91,7 +91,7 @@ The `last_rel()` function shows the last relation that has been materialized:
9191
duckplyr::last_rel()
9292
```
9393

94-
It is NULL because nothing has been computed yet.
94+
It is `NULL` because nothing has been computed yet.
9595
Converting the object to a data frame triggers the computation:
9696

9797
```{r}
@@ -101,7 +101,7 @@ duckplyr::last_rel()
101101

102102
The `last_rel()` function now shows a relation that describes logical plan for executing the whole pipeline.
103103

104-
## Functionality not supported by DuckDB
104+
## Help from dplyr
105105

106106
Using a custom function with a side effect is not supported by DuckDB and triggers a dplyr fallback:
107107

@@ -151,7 +151,7 @@ The `last_rel()` function confirms that only the final `select()` is handled by
151151
## Enforce DuckDB operation
152152

153153
For any duck frame, one can control the automatic materialization.
154-
For fallbacks to dplyr, automatic materialization must be allowed for the frame at hand, as dplyr necessitate eager evaluation.
154+
For fallbacks to dplyr, automatic materialization must be allowed for the frame at hand, as dplyr necessitates eager evaluation.
155155

156156
Therefore, by making a data frame frugal, one can ensure a pipeline will error when a fallback to dplyr would have normally happened.
157157
See `vignette("prudence")` for details.

0 commit comments

Comments
 (0)