

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 da tarefa de substituição de caracteres
<a name="CHAP_Tasks.CustomizingTasks.TaskSettings.CharacterSubstitution"></a>

Você pode especificar que sua tarefa de replicação realize substituições de caracteres no banco de dados de destino para todas as colunas do banco de dados de origem com o tipo de `WSTRING` dados AWS DMS `STRING` ou. 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). 

É possível configurar a substituição de caracteres para qualquer tarefa com endpoints dos seguintes bancos de dados de origem e de destino:
+ Bancos de dados de origem:
  + Oracle
  + Microsoft SQL Server
  + MySQL
  + MariaDB
  + PostgreSQL
  + SAP Adaptive Server Enterprise (ASE)
  + IBM Db2 LUW
+ Bancos de dados de destino:
  + Oracle
  + Microsoft SQL Server
  + MySQL
  + MariaDB
  + PostgreSQL
  + SAP Adaptive Server Enterprise (ASE)
  + banco de dados de origem

É possível especificar substituições de caracteres utilizando o parâmetro `CharacterSetSettings` nas configurações da tarefa. Essas substituições de caracteres ocorrem para caracteres especificados utilizando o valor de ponto de código Unicode em notação hexadecimal. É possível implementar as substituições em duas fases, na seguinte ordem, se ambas forem especificadas:

1. **Substituição individual de caracteres** — AWS DMS pode substituir os valores dos caracteres selecionados na fonte por valores de substituição especificados dos caracteres correspondentes no destino. Utilize a matriz `CharacterReplacements` no `CharacterSetSettings` para selecionar todos os caracteres de origem com os pontos de código Unicode que você especificar. Utilize essa matriz também para especificar os pontos de código de substituição para os caracteres correspondentes no destino. 

   Para selecionar todos os caracteres na origem que têm um determinado ponto de código, defina uma instância de `SourceCharacterCodePoint` na matriz `CharacterReplacements` para esse ponto de código. Depois, especifique o ponto de código de substituição para todos os caracteres de destino equivalentes definindo a instância correspondente de `TargetCharacterCodePoint` nessa matriz. Para excluir caracteres de destino em vez de substituí-los, defina as instâncias apropriadas de `TargetCharacterCodePoint` como zero (0). É possível substituir ou excluir quantos valores diferentes de caracteres de destino desejar especificando pares adicionais de configurações `SourceCharacterCodePoint` e `TargetCharacterCodePoint` na matriz `CharacterReplacements`. Se você especificar o mesmo valor para várias instâncias de `SourceCharacterCodePoint`, o valor da última configuração correspondente de `TargetCharacterCodePoint` se aplicará ao destino.

   Por exemplo, suponha que você especifique os seguintes valores para `CharacterReplacements`.

   ```
   "CharacterSetSettings": {
       "CharacterReplacements": [ {
           "SourceCharacterCodePoint": 62,
           "TargetCharacterCodePoint": 61
           }, {
           "SourceCharacterCodePoint": 42,
           "TargetCharacterCodePoint": 41
           }
       ]
   }
   ```

   Neste exemplo, AWS DMS substitui todos os caracteres com o valor hexadecimal 62 do ponto do código-fonte no destino por caracteres com o valor 61 do ponto de código. Além disso, AWS DMS substitui todos os caracteres com o ponto 42 do código-fonte no destino por caracteres com o valor 41 do ponto de código. Em outras palavras, o AWS DMS substitui todas as instâncias da letra `'b'` no destino pela letra `'a'`. Da mesma forma, AWS DMS substitui todas as instâncias da letra `'B'` no alvo pela letra`'A'`.

1. **Validação e substituição do conjunto** de caracteres — Após a conclusão de qualquer substituição individual de caracteres, AWS DMS pode garantir que todos os caracteres de destino tenham pontos de código Unicode válidos no único conjunto de caracteres que você especificar. Utilize o `CharacterSetSupport` em `CharacterSetSettings` para configurar essa verificação e modificação de caracteres de destino. Para especificar o conjunto de caracteres de verificação, defina `CharacterSet` em `CharacterSetSupport` como o valor de string do conjunto de caracteres. (Os valores possíveis de `CharacterSet` se seguem.) Você pode AWS DMS modificar os caracteres de destino inválidos de uma das seguintes formas:
   + Especifique um único ponto de código Unicode de substituição para todos os caracteres de destino inválidos, independentemente do ponto de código atual. Para configurar esse ponto de código de substituição, defina `ReplaceWithCharacterCodePoint` em `CharacterSetSupport` como o valor especificado.
   + Configure a exclusão de todos os caracteres de destino inválidos definindo `ReplaceWithCharacterCodePoint` como zero (0).

   Por exemplo, suponha que você especifique os seguintes valores para `CharacterSetSupport`.

   ```
   "CharacterSetSettings": {
       "CharacterSetSupport": {
           "CharacterSet": "UTF16_PlatformEndian",
           "ReplaceWithCharacterCodePoint": 0
       }
   }
   ```

   Neste exemplo, AWS DMS exclui todos os caracteres encontrados no destino que são inválidos no conjunto de `"UTF16_PlatformEndian"` caracteres. Portanto, todos os caracteres especificados com o valor hexadecimal `2FB6` são excluídos. Esse valor é inválido porque é um ponto de código Unicode de 4 bytes e UTF16 os conjuntos de caracteres aceitam somente caracteres com pontos de código de 2 bytes.

**nota**  
A tarefa de replicação conclui todas as substituições de caracteres especificadas antes de iniciar qualquer transformação global ou de tabela especificada por meio do mapeamento de tabela. Para obter mais informações sobre o mapeamento de tabela, consulte [Utilizar o mapeamento de tabela para especificar as configurações da tarefa](CHAP_Tasks.CustomizingTasks.TableMapping.md).  
A substituição de caracteres não é compatível com tipos de dados LOB. Isso inclui qualquer tipo de dados que o DMS considere um tipo de dados LOB. Por exemplo, o tipo de dados `Extended` no Oracle é considerado LOB. Para obter mais informações sobre tags, consulte [Tipos de dados de origem do Oracle](CHAP_Source.Oracle.md#CHAP_Source.Oracle.DataTypes): 

Os valores que AWS DMS oferecem suporte para `CharacterSet` aparecem na tabela a seguir.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/dms/latest/userguide/CHAP_Tasks.CustomizingTasks.TaskSettings.CharacterSubstitution.html)