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á. # Usando o Amazon DocumentDB como destino para o AWS Database Migration Service Para obter informações sobre quais versões do Amazon DocumentDB (com compatibilidade com o MongoDB) são compatíveis, consulte. AWS DMS [Metas para AWS DMS](CHAP_Introduction.Targets.md) É possível utilizar o AWS DMS para migrar os dados para o Amazon DocumentDB (compatível com MongoDB) de qualquer mecanismo de dados de origem compatível com o AWS DMS . O mecanismo de origem pode estar em um serviço AWS gerenciado, como Amazon RDS, Aurora ou Amazon S3. Ou o mecanismo pode estar em um banco de dados autogerenciado, como o MongoDB em execução no Amazon EC2 ou on-premises. Você pode usar AWS DMS para replicar dados de origem para bancos de dados, coleções ou documentos do Amazon DocumentDB. **nota** Se o endpoint de origem for o MongoDB ou o Amazon DocumentDB, execute a migração no **Modo documento**. O MongoDB armazena dados em um formato JSON binário (BSON). AWS DMS suporta todos os tipos de dados BSON que são compatíveis com o Amazon DocumentDB. Para obter uma lista desses tipos de dados, consulte [ APIsMongoDB, operações e tipos de dados suportados no Guia](https://docs.aws.amazon.com/documentdb/latest/developerguide/mongo-apis.html) do desenvolvedor do *Amazon DocumentDB*. Se o endpoint de origem for um banco de dados relacional, AWS DMS mapeia objetos do banco de dados para o Amazon DocumentDB da seguinte forma: + Um banco de dados relacional ou esquema de banco de dados, é mapeado para um *banco de dados* Amazon DocumentDB. + As tabelas dentro de um banco de dados relacional são mapeadas para *coleções* no Amazon DocumentDB. + Os registros em uma tabela relacional são mapeados para *documentos* no Amazon DocumentDB. Cada documento é construído a partir de dados no registro de origem. Se o endpoint de origem for o Amazon S3, os objetos resultantes do Amazon DocumentDB corresponderão às regras de mapeamento do AWS DMS para o Amazon S3. Por exemplo, considere o URI a seguir. ``` s3://amzn-s3-demo-bucket/hr/employee ``` Nesse caso, AWS DMS mapeia os objetos `amzn-s3-demo-bucket` para o Amazon DocumentDB da seguinte forma: + A parte de nível superior do URI (`hr`) é mapeada para um banco de dados Amazon DocumentDB. + A próxima parte do URI (`employee`) é mapeada para uma coleção do Amazon DocumentDB. + Cada objeto em `employee` é mapeado para um documento no Amazon DocumentDB. Para obter mais informações sobre as regras de mapeamento do Amazon S3, consulte [Usando o Amazon S3 como fonte para AWS DMS](CHAP_Source.S3.md). **Configurações do endpoint do Amazon DocumentDB** Nas AWS DMS versões 3.5.0 e superiores, você pode melhorar o desempenho da captura de dados de alteração (CDC) para endpoints do Amazon DocumentDB ajustando as configurações de tarefas para threads paralelos e operações em massa. Para fazer isso, especifique o número de threads simultâneos, filas por thread e o número de registros a serem armazenados em um buffer usando as configurações da tarefa `ParallelApply*`. Por exemplo, suponha que você queira executar um carregamento de CDC e aplicar 128 threads em paralelo. Você também quer acessar 64 filas por thread, com 50 registros armazenados por buffer. Para promover o desempenho do CDC, AWS DMS oferece suporte a estas configurações de tarefas: + `ParallelApplyThreads`— Especifica o número de threads simultâneos que são AWS DMS usados durante um carregamento do CDC para enviar registros de dados para um endpoint de destino do Amazon DocumentDB. O valor padrão é zero (0) e o valor máximo é 32. + `ParallelApplyBufferSize`: especifica o número máximo de registros a serem armazenados em cada fila de buffer para que os threads simultâneos enviem para um endpoint de destino do Amazon DocumentDB durante uma carga de CDC. O valor padrão é 100 e o valor máximo é 1.000. Use essa opção quando `ParallelApplyThreads` especificar mais de um thread. + `ParallelApplyQueuesPerThread`: especifica o número de filas que cada thread acessa para utilizar registros de dados das filas e gerar uma carga em lote para um endpoint do Amazon DocumentDB durante a CDC. O padrão é um. O máximo é 512. **nota** Para destinos do Amazon DocumentDB, a aplicação paralela do CDC pode causar erros de chave duplicada ou paralisar a aplicação do CDC para cargas de trabalho que usam índices exclusivos secundários ou exigem uma ordenação estrita das alterações. Use a configuração padrão de aplicação do CDC de thread único para essas cargas de trabalho. Para obter detalhes adicionais sobre como trabalhar com o Amazon DocumentDB como destino AWS DMS, consulte as seguintes seções: **Topics** + [Mapear dados de uma origem para um destino do Amazon DocumentDB](#CHAP_Target.DocumentDB.data-mapping) + [Conexão aos clusters elásticos do Amazon DocumentDB como destino](#CHAP_Target.DocumentDB.data-mapping.elastic-cluster-connect) + [Replicação contínua com o Amazon DocumentDB como destino](#CHAP_Target.DocumentDB.data-mapping.ongoing-replication) + [Limitações da utilização do Amazon DocumentDB como destino](#CHAP_Target.DocumentDB.limitations) + [Utilizar configurações de endpoint com o Amazon DocumentDB como destino](#CHAP_Target.DocumentDB.ECAs) + [Tipos de dados de destino do Amazon DocumentDB](#CHAP_Target.DocumentDB.datatypes) **nota** Para ver um step-by-step passo a passo do processo de migração, consulte [Migração do MongoDB para o Amazon DocumentDB](https://docs.aws.amazon.com/dms/latest/sbs/CHAP_MongoDB2DocumentDB.html) no Guia de migração. AWS Database Migration Service Step-by-Step ## Mapear dados de uma origem para um destino do Amazon DocumentDB AWS DMS lê registros do endpoint de origem e constrói documentos JSON com base nos dados que ele lê. Para cada documento JSON, é AWS DMS necessário determinar um `_id` campo para atuar como um identificador exclusivo. Ele grava o documento JSON em uma coleção do Amazon DocumentDB, utilizando o campo `_id` como uma chave primária. ### Dados de origem que são uma coluna individual Se os dados de origem consistirem em uma única coluna, os dados deverão ser de um tipo de string. (Dependendo do mecanismo de origem, o tipo de dados real pode ser VARCHAR, NVARCHAR, TEXT, LOB, CLOB ou similar.) AWS DMS assume que os dados são um documento JSON válido e replica os dados para o Amazon DocumentDB no estado em que se encontram. Se o documento JSON resultante contiver um campo chamado `_id`, o campo será utilizado como o `_id` exclusivo no Amazon DocumentDB. Se o JSON não contiver um campo `_id`, o Amazon DocumentDB gerará um valor de `_id` automaticamente. ### Dados de origem que são várias colunas Se os dados de origem consistirem em várias colunas, AWS DMS criará um documento JSON a partir de todas essas colunas. Para determinar o `_id` campo do documento, AWS DMS faça o seguinte: + Se uma das colunas for chamada `_id`, os dados dessa coluna serão utilizados como o `_id` de destino. + Se não houver uma `_id` coluna, mas os dados de origem tiverem uma chave primária ou um índice exclusivo, AWS DMS use essa chave ou o valor do índice como `_id` valor. Os dados da chave primária ou do índice exclusivo também aparece como campos explícitos no documento JSON. + Se não houver nenhuma coluna `_id` e nenhuma chave primária ou índice exclusivo, o Amazon DocumentDB gerará um valor de `_id` automaticamente. ### Coagir um tipo de dados no endpoint de destino AWS DMS pode modificar estruturas de dados ao gravar em um endpoint de destino do Amazon DocumentDB. É possível solicitar essas alterações renomeando colunas e tabelas no endpoint de origem ou fornecendo regras de transformação que são aplicadas quando uma tarefa está sendo executada. #### Utilizar um documento JSON aninhado (json\$1 prefix) Para coagir um tipo de dados, é possível prefixar o nome da coluna de origem com `json_` (ou seja, `json_columnName`) manualmente ou utilizando uma transformação. Nesse caso, a coluna é criada como um documento JSON aninhado dentro do documento de destino, e não como um campo de string. Por exemplo, suponha que você deseja migrar o documento a seguir de um endpoint de origem do MongoDB. ``` { "_id": "1", "FirstName": "John", "LastName": "Doe", "ContactDetails": "{"Home": {"Address": "Boston","Phone": "1111111"},"Work": { "Address": "Boston", "Phone": "2222222222"}}" } ``` Se você não coagir nenhum dos tipos de dados de origem, o documento `ContactDetails` incorporado será migrado como uma string. ``` { "_id": "1", "FirstName": "John", "LastName": "Doe", "ContactDetails": "{\"Home\": {\"Address\": \"Boston\",\"Phone\": \"1111111\"},\"Work\": { \"Address\": \"Boston\", \"Phone\": \"2222222222\"}}" } ``` No entanto, é possível adicionar uma regra de transformação para coagir `ContactDetails` para um objeto JSON. Por exemplo, suponha que o nome original da coluna de origem seja `ContactDetails`. Para coagir o tipo de dados como JSON aninhado, a coluna no endpoint de origem precisa ser renomeada como “json\$1ContactDetails” adicionando o prefixo “\$1json\$1\$1 “na origem manualmente ou por meio de regras de transformação. Por exemplo, é possível utilizar a regra de transformação abaixo: ``` { "rules": [ { "rule-type": "transformation", "rule-id": "1", "rule-name": "1", "rule-target": "column", "object-locator": { "schema-name": "%", "table-name": "%", "column-name": "ContactDetails" }, "rule-action": "rename", "value": "json_ContactDetails", "old-value": null } ] } ``` AWS DMS replica o ContactDetails campo como JSON aninhado, da seguinte forma. ``` { "_id": "1", "FirstName": "John", "LastName": "Doe", "ContactDetails": { "Home": { "Address": "Boston", "Phone": "1111111111" }, "Work": { "Address": "Boston", "Phone": "2222222222" } } } ``` #### Utilizar uma matriz JSON (array\$1 prefix) Para coagir um tipo de dados, é possível prefixar o nome de uma coluna com `array_` (ou seja, `array_columnName`) manualmente ou utilizando uma transformação. Nesse caso, AWS DMS considera a coluna como uma matriz JSON e a cria como tal no documento de destino. Suponha que você deseja migrar o documento a seguir de um endpoint de origem do MongoDB. ``` { "_id" : "1", "FirstName": "John", "LastName": "Doe",
 "ContactAddresses": ["Boston", "New York"],
 "ContactPhoneNumbers": ["1111111111", "2222222222"] } ``` Se você não coagir nenhum dos tipos de dados de origem, o documento `ContactDetails` incorporado será migrado como uma string. ``` { "_id": "1", "FirstName": "John", "LastName": "Doe",
 "ContactAddresses": "[\"Boston\", \"New York\"]",
 "ContactPhoneNumbers": "[\"1111111111\", \"2222222222\"]"
 } ``` No entanto, é possível adicionar regras de transformação para coagir `ContactAddress` e `ContactPhoneNumbers` para matrizes JSON, conforme mostrado na tabela a seguir. **** | Nome original da coluna de origem | Coluna de origem renomeada | | --- | --- | | ContactAddress | array\$1ContactAddress | | ContactPhoneNumbers | array\$1ContactPhoneNumbers | AWS DMS replica `ContactAddress` e da `ContactPhoneNumbers` seguinte forma. ``` { "_id": "1", "FirstName": "John", "LastName": "Doe", "ContactAddresses": [ "Boston", "New York" ], "ContactPhoneNumbers": [ "1111111111", "2222222222" ] } ``` ### Conectar-se ao Amazon DocumentDB utilizando TLS Por padrão, um cluster recém-criado do Amazon DocumentDB aceita conexões seguras somente quando o Transport Layer Security (TLS) é utilizado. Quando o TLS está ativado, cada conexão ao Amazon DocumentDB requer uma chave pública. Você pode recuperar a chave pública para o Amazon DocumentDB baixando o arquivo`rds-combined-ca-bundle.pem`,, de AWS um bucket hospedado do Amazon S3. Para obter mais informações sobre como baixar esse arquivo, consulte [Criptografar conexões utilizando TLS](https://docs.aws.amazon.com/documentdb/latest/developerguide/security.encryption.ssl.html) no *Guia do desenvolvedor do Amazon DocumentDB* Depois de baixar esse arquivo.pem, você pode importar a chave pública que ele contém, AWS DMS conforme descrito a seguir. #### Console de gerenciamento da AWS **Para importar o arquivo (.pem) da chave pública** 1. Abra o AWS DMS console em [https://console.aws.amazon.com/dms](https://console.aws.amazon.com/dms). 1. No painel de navegação, escolha **Certificates**. 1. Selecione **Import certificate (Importar certificado)** e faça o seguinte: + Para **Certificate identifier (Identificador do certificado)**, insira um nome exclusivo para o certificado, por exemplo `docdb-cert`. + Em **Importar arquivo**, navegue até o local onde você salvou o arquivo .pem. Quando estiver satisfeito com as configurações, selecione **Add new CA certificate (Adicionar novo certificado de CA)**. #### AWS CLI Utilize o comando `aws dms import-certificate`, conforme mostrado no exemplo a seguir. ``` aws dms import-certificate \ --certificate-identifier docdb-cert \ --certificate-pem file://./rds-combined-ca-bundle.pem ``` Ao criar um endpoint de AWS DMS destino, forneça o identificador do certificado (por exemplo,`docdb-cert`). Além disso, defina o parâmetro do modo SSL como `verify-full`. ## Conexão aos clusters elásticos do Amazon DocumentDB como destino Nas AWS DMS versões 3.4.7 e superiores, você pode criar um endpoint de destino do Amazon DocumentDB como um cluster elástico. Se você criar o endpoint de destino como um cluster elástico, precisará anexar um novo certificado SSL ao endpoint do cluster elástico do Amazon DocumentDB porque o certificado SSL existente não funcionará. **Como anexar um novo certificado SSL ao endpoint do cluster elástico do Amazon DocumentDB** 1. Em um navegador, abra [ https://www.amazontrust.com/repository/SFSRootCAG2o.pem](https://www.amazontrust.com/repository/SFSRootCAG2.pem) e salve o conteúdo em um `.pem` arquivo com um nome de arquivo exclusivo, por exemplo. `SFSRootCAG2.pem` Esse é o arquivo de certificado que você precisa importar nas etapas subsequentes. 1. Crie o endpoint do cluster elástico e defina as seguintes opções: 1. Em **Configuração do endpoint**, escolha **Adicionar novo certificado CA**. 1. Em **Identificador de certificado**, insira **SFSRootCAG2.pem**. 1. Em **Importar arquivo de certificado**, escolha **Escolher arquivo** e navegue até o arquivo `SFSRootCAG2.pem` baixado anteriormente. 1. Selecione e abra o arquivo `SFSRootCAG2.pem` baixado. 1. Escolha **Importar certificado**. 1. No menu suspenso **Escolha um certificado**, escolha **SFSRootCAG2.pem**. O novo certificado SSL do arquivo `SFSRootCAG2.pem` baixado agora está anexado ao endpoint do cluster elástico do Amazon DocumentDB. ## Replicação contínua com o Amazon DocumentDB como destino Se a replicação contínua (captura de dados de alteração, CDC) estiver ativada para o Amazon DocumentDB como destino, as versões 3.5.0 e superior do AWS DMS proporcionarão uma melhoria no desempenho vinte vezes maior do que nas versões anteriores. Em versões anteriores, onde AWS DMS processava até 250 registros por segundo, AWS DMS agora processa com eficiência mais de 5000 registros por segundo. AWS DMS também garante que os documentos no Amazon DocumentDB permaneçam sincronizados com a fonte. Quando um registro de origem é criado ou atualizado, primeiro é AWS DMS necessário determinar qual registro do Amazon DocumentDB é afetado, fazendo o seguinte: + Se o registro da origem tiver uma coluna chamada `_id`, o valor dessa coluna determinará o `_id` correspondente na coleção do Amazon DocumentDB. + Se não houver uma `_id` coluna, mas os dados de origem tiverem uma chave primária ou um índice exclusivo, AWS DMS use essa chave ou valor de índice como o da `_id` coleção Amazon DocumentDB. + Se o registro de origem não tiver uma `_id` coluna, uma chave primária ou um índice exclusivo, todas as colunas de origem AWS DMS corresponderão aos campos correspondentes na coleção Amazon DocumentDB. Quando um novo registro de origem é criado, AWS DMS grava um documento correspondente no Amazon DocumentDB. Se um registro de origem existente for atualizado, AWS DMS atualiza os campos correspondentes no documento de destino no Amazon DocumentDB. Todos os campos que existem no documento de destino, mas não no registro da origem permanecem inalterados. Quando um registro de origem é excluído, o documento correspondente é AWS DMS excluído do Amazon DocumentDB. ### Alterações estruturais (DDL) na origem Com a replicação contínua, qualquer alteração nas estruturas de dados da origem (como tabelas, colunas e assim por diante) é propagada para seus equivalentes no Amazon DocumentDB. Em bancos de dados relacionais, essas alterações são iniciadas utilizando instruções da linguagem de definição de dados (DDL). Você pode ver como AWS DMS propaga essas alterações para o Amazon DocumentDB na tabela a seguir. **** | DDL na origem | Efeito no destino do Amazon DocumentDB | | --- | --- | | CREATE TABLE | Cria uma coleção vazia. | | Instrução que renomeia uma tabela (RENAME TABLE, ALTER TABLE...RENAME e semelhante) | Renomeia a coleção. | | TRUNCATE TABLE | Remove todos os documentos da coleção, mas somente se HandleSourceTableTruncated for true. Para obter mais informações, consulte [Configurações de tarefa para processamento de DDL de processamento de alterações](CHAP_Tasks.CustomizingTasks.TaskSettings.DDLHandling.md). | | DROP TABLE | Exclui a coleção, mas somente se HandleSourceTableDropped for true. Para obter mais informações, consulte [Configurações de tarefa para processamento de DDL de processamento de alterações](CHAP_Tasks.CustomizingTasks.TaskSettings.DDLHandling.md). | | Instrução que adiciona uma coluna a uma tabela (ALTER TABLE...ADD e semelhante) | A instrução DDL é ignorada e um aviso é emitido. Quando o primeiro INSERT é realizado na origem, o novo campo é adicionado ao documento de destino. | | ALTER TABLE...RENAME COLUMN | A instrução DDL é ignorada e um aviso é emitido. Quando o primeiro INSERT é realizado na origem, o campo recém-nomeado é adicionado ao documento de destino. | | ALTER TABLE...DROP COLUMN | A instrução DDL é ignorada e um aviso é emitido. | | Instrução que altera o tipo de dados da coluna (ALTER COLUMN...MODIFY e semelhante) | A instrução DDL é ignorada e um aviso é emitido. Quando o primeiro INSERT é realizado na origem com o novo tipo de dados, o documento de destino é criado com um campo desse novo tipo de dados. | ## Limitações da utilização do Amazon DocumentDB como destino As seguintes limitações se aplicam ao usar o Amazon DocumentDB como destino para: AWS DMS + No Amazon DocumentDB, os nomes de coleção não podem conter o símbolo de dólar (\$1). Além disso, os nomes do banco de dados não podem conter caracteres Unicode. + AWS DMS não suporta a fusão de várias tabelas de origem em uma única coleção do Amazon DocumentDB. + Quando AWS DMS os processos são alterados de uma tabela de origem que não tem uma chave primária, todas as colunas LOB nessa tabela são ignoradas. + Se a opção **Alterar tabela** estiver habilitada, e o AWS DMS encontrar uma coluna de origem chamada “*\$1id*”, essa coluna aparecerá como “*\$1\$1id*” (dois sublinhados) na tabela de alteração. + Se você escolher o Oracle como o endpoint de origem, a origem do Oracle deverá ter o registro em log suplementar total ativado. Caso contrário, se houver colunas na origem que não foram alteradas, os dados serão carregados no Amazon DocumentDB como valores nulos. + A configuração de `TargetTablePrepMode:TRUNCATE_BEFORE_LOAD` da tarefa de replicação não é compatível para utilização com um endpoint de destino do DocumentDB. + Não é possível usar coleções limitadas do MongoDB no Amazon DocumentDB. No entanto, o AWS DMS migra automaticamente esses objetos como coleções ilimitadas no DocumentDB de destino. + A aplicação paralela do CDC aos destinos do Amazon DocumentDB pode causar erros de chave duplicada ou a aplicação paralisada do CDC para cargas de trabalho que usam índices exclusivos secundários ou exigem uma ordenação estrita das alterações. Para essas cargas de trabalho, use a configuração padrão de aplicação CDC de thread único. ## Utilizar configurações de endpoint com o Amazon DocumentDB como destino É possível utilizar as configurações de endpoint para configurar o destino do Amazon DocumentDB de forma semelhante à utilização de atributos de conexão adicional. Você especifica as configurações ao criar o endpoint de destino usando o AWS DMS console ou usando o `create-endpoint` comando no [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/dms/index.html), com a sintaxe `--doc-db-settings '{"EndpointSetting": "value", ...}'` JSON. A tabela a seguir mostra as configurações do endpoint que é possível utilizar com o Amazon DocumentDB como destino. | Nome do atributo | Valores válidos | Valor padrão e descrição | | --- | --- | --- | | `replicateShardCollections` | booleano `true` `false` | Quando `true`, essa configuração de endpoint tem os seguintes efeitos e impõe as seguintes limitações: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/dms/latest/userguide/CHAP_Target.DocumentDB.html) | ## Tipos de dados de destino do Amazon DocumentDB Na tabela a seguir, você pode encontrar os tipos de dados de destino do Amazon DocumentDB que são compatíveis com o uso do AWS DMS e o mapeamento padrão dos tipos de dados do AWS DMS. Para obter mais informações sobre os tipos de dados do AWS DMS, consulte[Tipos de dados do AWS Database Migration Service](CHAP_Reference.DataTypes.md). | AWS Tipo de dados DMS | Tipo de dados do Amazon DocumentDB | | --- | --- | | BOOLEAN | Booleano | | BYTES | Dados binários | | DATE | Data | | TIME | Cadeia de caracteres (UTF8) | | DATETIME | Data | | INT1 | Inteiro de 32 bits | | INT2 | Inteiro de 32 bits | | INT4 | Inteiro de 32 bits | | INT8 | Inteiro de 64 bits | | NUMERIC | Cadeia de caracteres (UTF8) | | REAL4 | Duplo | | REAL8 | Duplo | | STRING | Se os dados forem reconhecidos como JSON, eles serão AWS DMS migrados para o Amazon DocumentDB como um documento. Caso contrário, os dados serão mapeados para String (UTF8). | | UINT1 | Inteiro de 32 bits | | UINT2 | Inteiro de 32 bits | | UINT4 | Inteiro de 64 bits | | UINT8 | Cadeia de caracteres (UTF8) | | WSTRING | Se os dados forem reconhecidos como JSON, eles serão AWS DMS migrados para o Amazon DocumentDB como um documento. Caso contrário, os dados serão mapeados para String (UTF8). | | BLOB | Binário | | CLOB | Se os dados forem reconhecidos como JSON, eles serão AWS DMS migrados para o Amazon DocumentDB como um documento. Caso contrário, os dados serão mapeados para String (UTF8). | | NCLOB | Se os dados forem reconhecidos como JSON, eles serão AWS DMS migrados para o Amazon DocumentDB como um documento. Caso contrário, os dados serão mapeados para String (UTF8). |