Package dplyr version 1.1.4
right_join(
x,
y,
by = NULL,
copy = FALSE,
suffix = c(".x", ".y"),
...,
keep = NULL
)
## S3 method for class 'data.frame'
right_join(
x,
y,
by = NULL,
copy = FALSE,
suffix = c(".x", ".y"),
...,
keep = NULL,
na_matches = c("na", "never"),
multiple = "all",
unmatched = "drop",
relationship = NULL
)参数【x，y】：一对数据集（data frame），数据集扩展（比如：tibble），或者 lazy data frames（比如：来自 dbplyr 或 dtplyr）。
参数【by】：使用 join_by() 创建的联接规范，或要联接的变量的字符向量。
- 如果为 NULL（默认值），*_join() 将执行自然连接，使用参数【x】和参数【y】的所有共同变量。会有一条信息列出变量，以便您检查它们是否正确；如果明确提供变量，就可以抑制该信息。
- 要连接参数【x】和参数【y】之间的不同变量，请使用 join_by() 规范。例如，join_by(a == b) 将匹配 x$a 与 y$b。
- 要通过多个变量连接，请使用带有多个表达式的 join_by() 规范。例如，join_by(a == b, c == d) 将匹配 x$a 到 y$b，x$c 到 y$d。如果参数【x】和参数【y】的列名相同，可以只列出变量名，如 join_by(a,c)，从而缩短计算时间。
- join_by() 还可用于执行不等式连接、滚动连接和重叠连接。有关这些连接类型的详细信息，请参阅 ?join_by 文档。
- 对于简单的相等连接，也可以指定一个变量名字符向量来连接。例如，by = c("a", "b")将 x$a 连接到 y$a，将 x$b 连接到 y$b。如果参数【x】和参数【y】的变量名不同，可使用命名字符向量，如 by = c("x_a" = "y_a", "x_b" = "y_b")。
参数【copy】：如果参数【x】和参数【y】不是来自同一个数据源，且参数【copy】为 TRUE，那么参数【y】将被复制到与参数【x】相同的 src 中。这样就可以跨 srcs 连接表，但这可能是一项昂贵的操作，因此必须选择使用。
参数【suffix】：如果参数【x】和参数【y】中存在非连接的重复变量，输出时将添加这些后缀以消除歧义。应为长度为 2 的字符向量。
参数【...】：传入方法的其他参数。
参数【keep】：输出中是否应该保留参数【x】和参数【y】的连接键？
- 如果为 NULL（默认值），则等价连接只保留参数【x】的键值，而不等价连接则保留参数【x】和参数【y】的键值。
- 如果为 TRUE，则保留来自参数【x】和参数【y】的所有按键。
- 如果为 FALSE，则只保留参数【x】的键值。对于 right_join() 和 full_join()，与只存在于参数【y】中的行相对应的关键列中的数据会合并到来自参数【x】的关键列中。在不平等条件下连接时不能使用。
参数【na_matches】：两个 NA 值或两个 NaN 值应该匹配吗？
- 默认为 "na"，将两个 NA 值或两个 NaN 值视为相等，如 %in%、match() 和 merge()。
- "never " 将两个 NA 或两个 NaN 值视为不同的值，绝不会将它们匹配在一起或与任何其他值匹配。它类似于数据库源的连接和 base::merge(incomparables = NA)。
参数【multiple】：处理参数【x】中与参数【y】中多个匹配项匹配的行。对于参数【x】的每一行：
- 默认为 "all"，返回参数【y】中检测到的所有匹配。这与 SQL 的行为相同。
- "any " 返回参数【y】中检测到的一个匹配项，但不保证返回哪个匹配项。如果只需要检测是否至少有一个匹配项，它通常比 "first " 和 "last " 更快。
- "first " 返回在参数【y】中检测到的第一个匹配项。
- "last " 返回在参数【y】中检测到的最后一个匹配项。
参数【unmatched】：如何处理会导致丢弃行的不匹配键？
- "drop " 会从结果中删除不匹配的键。
- 如果检测到不匹配的键，"error " 会抛出一个错误。
参数【unmatched】的目的是防止在连接过程中意外丢弃记录。它只检查输入中可能丢行的不匹配键。
- left_join() 检查参数【y】；
- right_join() 检查参数【x】；
- inner_join() 检查参数【x】和参数【y】。
参数【relationship】：处理 参数【x】和参数【y】的键之间的预期关系。如果从下面列表中选择的预期关系无效，则会出错。
- 默认设置为 NULL，不希望参数【x】和参数【y】之间存在任何关系。不过，对于相等连接，它会检查是否存在多对多关系（这通常是意料之外的），如果出现这种关系，它会发出警告，提醒您仔细查看输入内容，或通过指定 "many-to-many" 来明确这种关系。
- "one-to-one" 期望：参数【x】中的每一行最多匹配参数【y】中的一行。参数【y】中的每一行最多匹配参数【x】中的一行。
- "one-to-many" 期望：参数【y】中的每一行最多匹配参数【x】中的一行。
- "many-to-one" 期望：参数【x】中的每一行最多匹配参数【y】中的一行。
- "many-to-many" 期望：并不执行任何关系检查，但如果您知道存在这种关系，则可以通过它来明确这种关系。
right_join() 会将所有观测值保留在参数【y】中。
