R语言【dplyr】——right_join(x, y)将y在x中找到的匹配项传回y

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】中。

---