

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configurações de tarefa de imagem anterior
<a name="CHAP_Tasks.CustomizingTasks.TaskSettings.BeforeImage"></a>

Ao gravar atualizações de CDC em um destino de streaming de dados, como o Kinesis ou o Apache Kafka, é possível exibir os valores originais de uma linha do banco de dados de origem antes da alteração por uma atualização. Para tornar isso possível, AWS DMS preenche uma *imagem anterior* dos eventos de atualização com base nos dados fornecidos pelo mecanismo do banco de dados de origem. Para obter informações sobre como utilizar um arquivo de configuração de tarefas para definir as configurações de tarefas, consulte [Exemplo de configurações de tarefas](CHAP_Tasks.CustomizingTasks.TaskSettings.md#CHAP_Tasks.CustomizingTasks.TaskSettings.Example).

Para isso, utilize o parâmetro `BeforeImageSettings` que adiciona um novo atributo JSON a cada operação de atualização com valores coletados do sistema do banco de dados de origem. 

Aplique `BeforeImageSettings` somente às tarefas de carga máxima mais CDC ou às tarefas de CDC somente. As tarefas de carga máxima mais CDC migram os dados existentes e replicam as alterações em andamento. As tarefas somente de CDC replicam somente as alterações de dados. 

Não aplique `BeforeImageSettings` a tarefas que são somente de carga total.

As opções possíveis para `BeforeImageSettings` são as seguintes:
+ `EnableBeforeImage`: ativa a geração de imagem anterior quando definido como `true`. O padrão é `false`. 
+ `FieldName`: atribui um nome ao novo atributo JSON. Quando `EnableBeforeImage` for `true`, `FieldName` será necessário e não poderá estar vazio.
+ `ColumnFilter`: especifica uma coluna a ser adicionada utilizando a geração de imagem anterior. Para adicionar somente colunas que fazem parte das chaves primárias da tabela, use o valor padrão, `pk-only`. Para adicionar qualquer coluna que tenha um valor de imagem anterior, use `all`. Observe que a imagem anterior não é compatível com tipos de dados de objetos binários grandes (LOB), como CLOB e BLOB.

O exemplo a seguir mostra a utilização de `BeforeImageSettings`. 

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

Para obter informações sobre as configurações de imagem anterior para o Kinesis, incluindo configurações adicionais de mapeamento de tabela, consulte [Utilizar uma imagem anterior para visualizar valores originais de linhas da CDC para um fluxo de dados do Kinesis como destino](CHAP_Target.Kinesis.md#CHAP_Target.Kinesis.BeforeImage).

Para obter informações sobre as configurações de imagem anterior para o Kafka, incluindo configurações adicionais de mapeamento de tabela, consulte [Utilizar uma imagem anterior para visualizar os valores originais de linhas da CDC para o Apache Kafka como destino](CHAP_Target.Kafka.md#CHAP_Target.Kafka.BeforeImage).