

# 写入 Salesforce
<a name="salesforce-writing-to"></a>

**先决条件**

您要向其中写入内容的 Salesforce sObject。您将需要 `Account`、`Case` 或 `Opportunity` 等对象名称。

Salesforce 连接器支持四种写入操作：
+ INSERT
+ UPSERT
+ UPDATE
+ DELETE

使用 `UPSERT` 写入操作时，必须提供 `ID_FIELD_NAMES` 选项以指定记录的外部 ID 字段。

 您还能添加连接选项：
+  `TRANSFER_MODE`：支持两种模式：`SYNC` 和 `ASYNC`。默认值为 `SYNC`。设置为 `ASYNC` 时，将使用 Bulk API 2.0 Ingest 进行处理。
+  `FAIL_ON_FIRST_ERROR`：默认值为 `FALSE`，这意味着即使有一些失败的写入记录，AWS Glue 作业仍将继续处理所有数据。设置为 `TRUE` 时，如果有任何失败的写入记录，则 AWS Glue 作业将失败，并且不会继续处理。

**示例**

```
salesforce_write = glueContext.write_dynamic_frame.from_options(
    frame=frameToWrite,
    connection_type="salesforce",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "Account",
        "API_VERSION": "v60.0",
        "WRITE_OPERATION": "INSERT",
        "TRANSFER_MODE": "ASYNC",
        "FAIL_ON_FIRST_ERROR": "true"
    }
)
```