翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 前イメージタスク設定前
<a name="CHAP_Tasks.CustomizingTasks.TaskSettings.BeforeImage"></a>

Kinesis や Apache Kafka のようなデータストリーミングターゲットに CDC 更新を書き込む場合、更新により変更される前のソースデータベース行の元の値を表示できます。これを可能にするために、 はソースデータベースエンジンによって提供されたデータに基づいて、更新イベントの*前のイメージ* AWS DMS を入力します。タスク設定ファイルを使用してタスク設定を設定する方法については、「[タスク設定例](CHAP_Tasks.CustomizingTasks.TaskSettings.md#CHAP_Tasks.CustomizingTasks.TaskSettings.Example)」をご参照ください。

これを行うには、ソースデータベースシステムから収集された値を使用して、すべての更新オペレーションに新しい JSON 属性を追加する `BeforeImageSettings` パラメータを使用します。

`BeforeImageSettings` を全ロードと CDC タスクのみ、または CDC のみのタスクに適用することを忘れないでください。全ロードと CDC タスクにより、既存のデータが移行され、継続的変更のレプリケーションをできます。CDC のみのタスクは、データ変更のみのレプリケーションとなります。

全ロードのタスクには `BeforeImageSettings` を適用しないでください。

`BeforeImageSettings` で考えられるオプション：
+ `EnableBeforeImage` — `true` に設定すると、前イメージが有効になります。デフォルトは `false` です。
+ `FieldName` — 新しい JSON 属性に名前を割り当てます。`EnableBeforeImage` が `true` の場合、`FieldName` は必須であり、空にすることはできません。
+ `ColumnFilter` — 前イメージを使用して追加する列を指定します。テーブルのプライマリキーの一部である列だけを追加するには、デフォルト値 `pk-only` を使用します。前イメージ値を持つ列を追加するには、`all` を使用します。変換前イメージは、CLOB や BLOB などのラージバイナリオブジェクト (LOB) データ型をサポートしていないことに注意します。

`BeforeImageSettings` の使用例：

```
"BeforeImageSettings": {
    "EnableBeforeImage": true,
    "FieldName": "before-image",
    "ColumnFilter": "pk-only"
  }
```

追加のテーブルマッピング設定など、前イメージ設定前の詳細については、「[前イメージを使用した Kinesis データストリームの CDC 行の元の値のターゲットとしての表示](CHAP_Target.Kinesis.md#CHAP_Target.Kinesis.BeforeImage)」をご参照ください。

追加のテーブルマッピング設定を含む、Kafka の前イメージ設定の詳細については、「[ターゲットとして Apache Kafka の CDC 行の元の値を表示するために前イメージを使用](CHAP_Target.Kafka.md#CHAP_Target.Kafka.BeforeImage)」をご参照ください。