join.tbl_df

0th

Percentile

Join data frame tbls.

See join for a description of the general purpose of the functions.

Usage
# S3 method for tbl_df
inner_join(x, y, by = NULL, copy = FALSE, ...)

# S3 method for tbl_df left_join(x, y, by = NULL, copy = FALSE, ...)

# S3 method for tbl_df semi_join(x, y, by = NULL, copy = FALSE, ...)

# S3 method for tbl_df anti_join(x, y, by = NULL, copy = FALSE, ...)

Arguments
x,y
tbls to join
by
a character vector of variables to join by. If NULL, the default, join will do a natural join, using all variables with common names across the two tables. A message lists the variables so that you can check they're right - to suppress the message, supply a character vector.
copy
If y is not a data frame or tbl_df and copy is TRUE, y will be converted into a data frame
...
included for compatibility with the generic; otherwise ignored.
Aliases
  • anti_join.tbl_df
  • inner_join.tbl_df
  • join.tbl_df
  • left_join.tbl_df
  • semi_join.tbl_df
Examples
if (require("Lahman")) {
batting_df <- tbl_df(Batting)
person_df <- tbl_df(Master)

uperson_df <- tbl_df(Master[!duplicated(Master$playerID), ])

# Inner join: match batting and person data
inner_join(batting_df, person_df)
inner_join(batting_df, uperson_df)

# Left join: match, but preserve batting data
left_join(batting_df, uperson_df)

# Anti join: find batters without person data
anti_join(batting_df, person_df)
# or people who didn't bat
anti_join(person_df, batting_df)
}
Documentation reproduced from package dplyr, version 0.3, License: MIT + file LICENSE

Community examples

Looks like there are no examples yet.