构建器，用于指定如何将源 DataFrame 中的数据合并到目标 Delta 表中。您可以指定任意数量的 `whenMatched` 和 `whenNotMatched` 子句。以下是这些子句的约束。

• `whenMatched` 子句
  • `whenMatched` 子句中的条件是可选的。但是，如果存在多个 `whenMatched` 子句，则只有最后一个可以省略条件。
  • 当存在多个 `whenMatched` 子句并且存在满足多个子句的条件（或缺少条件）时，将执行第一个满足子句的操作。换句话说，`whenMatched` 子句的顺序很重要。
  • 如果所有 `whenMatched` 子句都不匹配满足合并条件的源-目标行对，则目标行将不会被更新或删除。
  • 如果要用源 DataFrame 的相应列更新目标 Delta 表的所有列，则可以使用 `whenMatched(...).updateAll()`。这等同于

            whenMatched(...).updateExpr(Map(
              ("col1", "source.col1"),
              ("col2", "source.col2"),
              ...))
    

• `whenNotMatched` 子句
  • `whenNotMatched` 子句中的条件是可选的。但是，如果存在多个 `whenNotMatched` 子句，则只有最后一个可以省略条件。
  • 当存在多个 `whenNotMatched` 子句并且存在满足多个子句的条件（或缺少条件）时，将执行第一个满足子句的操作。换句话说，`whenNotMatched` 子句的顺序很重要。
  • 如果没有 `whenNotMatched` 子句，或者存在但未匹配的源行不满足条件，则源行不会被插入。
  • 如果要将目标 Delta 表的所有列插入源 DataFrame 的相应列，则可以使用 `whenNotMatched(...).insertAll()`。这等同于

            whenNotMatched(...).insertExpr(Map(
              ("col1", "source.col1"),
              ("col2", "source.col2"),
              ...))
    

• `whenNotMatchedBySource` 子句
  • `whenNotMatchedBySource` 子句中的条件是可选的。但是，如果存在多个 `whenNotMatchedBySource` 子句，则只有最后一个可以省略条件。
  • 当存在多个 `whenNotMatchedBySource` 子句并且存在满足多个子句的条件（或缺少条件）时，将执行第一个满足子句的操作。换句话说，`whenNotMatchedBySource` 子句的顺序很重要。
  • 如果没有 `whenNotMatchedBySource` 子句，或者存在但未匹配的目标行不满足任何 `whenNotMatchedBySource` 子句条件，则目标行将不会被更新或删除。

Scala 示例：使用源 DataFrame 中的新键值更新键值 Delta 表

deltaTable
 .as("target")
 .merge(
   source.as("source"),
   "target.key = source.key")
 .withSchemaEvolution()
 .whenMatched()
 .updateExpr(Map(
   "value" -> "source.value"))
 .whenNotMatched()
 .insertExpr(Map(
   "key" -> "source.key",
   "value" -> "source.value"))
 .whenNotMatchedBySource()
 .updateExpr(Map(
   "value" -> "target.value + 1"))
 .execute()

Java 示例：使用源 DataFrame 中的新键值更新键值 Delta 表

deltaTable
 .as("target")
 .merge(
   source.as("source"),
   "target.key = source.key")
 .withSchemaEvolution()
 .whenMatched()
 .updateExpr(
    new HashMap<String, String>() {{
      put("value", "source.value");
    }})
 .whenNotMatched()
 .insertExpr(
    new HashMap<String, String>() {{
     put("key", "source.key");
     put("value", "source.value");
   }})
 .whenNotMatchedBySource()
 .updateExpr(
    new HashMap<String, String>() {{
     put("value", "target.value + 1");
   }})
 .execute();