

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á.

# Começando com AWS Database Migration Service
<a name="CHAP_GettingStarted"></a>

No tutorial a seguir, você pode descobrir como realizar uma migração de banco de dados com AWS Database Migration Service (AWS DMS).

Para executar uma migração de banco de dados, execute as seguintes etapas:

1. Configure sua AWS conta seguindo as etapas em[Configurado para AWS Database Migration Service](CHAP_GettingStarted.SettingUp.md).

1. Crie os bancos de dados de amostra e um cliente do Amazon EC2 para preencher o banco de dados de origem e testar a replicação. Além disso, crie uma nuvem privada virtual (VPC) com base no serviço Amazon Virtual Private Cloud (Amazon VPC) para conter os recursos do tutorial. Para criar esses recursos, siga as etapas em [Pré-requisitos completos para configurar AWS Database Migration Service](CHAP_GettingStarted.Prerequisites.md).

1. Preencha o banco de dados de origem utilizando um [exemplo de script de criação de banco de dados](https://github.com/aws-samples/aws-database-migration-samples). 

1. Use a Conversão de Esquema DMS para converter o esquema do banco de dados de origem para o banco de dados de destino. Siga as etapas em [Conceitos básicos da DMS Schema Conversion](getting-started.md). Como alternativa, se você estiver usando o legacy AWS Schema Conversion Tool (AWS SCT), siga as etapas em[Esquema de migração](CHAP_GettingStarted.SCT.md).

1. Crie uma instância de replicação para executar todos os processos da migração. Para fazer isso e as tarefas a seguir, siga as etapas em [Replicação](CHAP_GettingStarted.Replication.md).

1. Especifique os endpoints dos bancos de dados de origem e de destino. Para obter informações sobre como criar endpoints, consulte [Criar endpoints de origem e de destino](CHAP_Endpoints.Creating.md).

1. Crie uma tarefa para definir as tabelas e os processos de replicação que deseja utilizar e inicie a replicação. Para obter informações sobre como criar tarefas de migração de banco de dados, consulte [Criar uma tarefa](CHAP_Tasks.Creating.md).

1. Verifique se a replicação está funcionando executando consultas no banco de dados de destino.

## Saiba mais sobre como trabalhar com AWS Database Migration Service
<a name="CHAP_GettingStarted.References"></a>

Posteriormente neste guia, você aprenderá a AWS DMS migrar seus dados de e para os bancos de dados comerciais e de código aberto mais usados. 

Também é recomendável verificar os seguintes recursos ao preparar e executar um projeto de migração de banco de dados:
+ [AWS DMS Step-by-Step Guia de migração](https://docs.aws.amazon.com/dms/latest/sbs/DMS-SBS-Welcome.html) — Este guia fornece step-by-step orientações detalhadas sobre o processo de migração de dados para o. AWS
+ [AWS DMS Referência da API](https://docs.aws.amazon.com/dms/latest/APIReference/Welcome.html) — Essa referência descreve detalhadamente todas as operações AWS Database Migration Service da API.
+ [AWS CLI for AWS DMS](https://docs.aws.amazon.com/cli/latest/reference/dms/index.html) — Esta referência fornece informações sobre como usar o AWS Command Line Interface (AWS CLI) com AWS DMS.

# Configurado para AWS Database Migration Service
<a name="CHAP_GettingStarted.SettingUp"></a>

## Inscreva-se para um Conta da AWS
<a name="sign-up-for-aws"></a>

Se você não tiver umConta da AWS, conclua as etapas a seguir para criar um.

**Para se inscrever em um Conta da AWS**

1. Abra a [https://portal.aws.amazon.com/billing/inscrição.](https://portal.aws.amazon.com/billing/signup)

1. Siga as instruções online.

   Parte do procedimento de inscrição envolve receber uma chamada telefônica ou uma mensagem de texto e inserir um código de verificação pelo teclado do telefone.

   Quando você se inscreve em umConta da AWS, um *Usuário raiz da conta da AWS*é criado. O usuário-raiz tem acesso a todos os Serviços da AWS e recursos na conta. Como prática recomendada de segurança, atribua o acesso administrativo a um usuário e use somente o usuário-raiz para executar [tarefas que exigem acesso de usuário-raiz](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).

AWSenvia um e-mail de confirmação após a conclusão do processo de inscrição. A qualquer momento, você pode visualizar a atividade atual da sua conta e gerenciar sua conta acessando [https://aws.amazon.com/e](https://aws.amazon.com/) escolhendo **Minha conta**.

## Criar um usuário com acesso administrativo
<a name="create-an-admin"></a>

Depois de se inscrever em umConta da AWS, proteja seu Usuário raiz da conta da AWSCentro de Identidade do AWS IAM, habilite e crie um usuário administrativo para que você não use o usuário root nas tarefas diárias.

**Proteja seu Usuário raiz da conta da AWS**

1.  Faça login [Console de gerenciamento da AWS](https://console.aws.amazon.com/)como proprietário da conta escolhendo **Usuário raiz** e inserindo seu endereço de Conta da AWS e-mail. Na próxima página, insira a senha.

   Para obter ajuda ao fazer login usando o usuário-raiz, consulte [Fazer login como usuário-raiz](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) no *Guia do usuário do Início de Sessão da AWS*.

1. Habilite a autenticação multifator (MFA) para o usuário-raiz.

   Para obter instruções, consulte [Habilitar um dispositivo de MFA virtual para seu usuário Conta da AWS raiz (console) no Guia](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) do *usuário do IAM*.

**Criar um usuário com acesso administrativo**

1. Habilita o Centro de Identidade do IAM.

   Para obter instruções, consulte [Habilitar o Centro de Identidade do AWS IAM](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-set-up-for-idc.html) no *Guia do usuário do Centro de Identidade do AWS IAM*.

1. No Centro de Identidade do IAM, conceda o acesso administrativo a um usuário.

   Para ver um tutorial sobre como usar o Diretório do Centro de Identidade do IAM como fonte de identidade, consulte [Configurar o acesso do usuário com o padrão Diretório do Centro de Identidade do IAM](https://docs.aws.amazon.com//singlesignon/latest/userguide/quick-start-default-idc.html) no *Guia Centro de Identidade do AWS IAM do usuário*.

**Iniciar sessão como o usuário com acesso administrativo**
+ Para fazer login com o seu usuário do Centro de Identidade do IAM, use o URL de login enviado ao seu endereço de e-mail quando o usuário do Centro de Identidade do IAM foi criado.

  Para obter ajuda para fazer login usando um usuário do IAM Identity Center, consulte Como [fazer login no portal de AWS acesso](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html) no *Guia Início de Sessão da AWS do usuário*.

**Atribuir acesso a usuários adicionais**

1. No Centro de Identidade do IAM, crie um conjunto de permissões que siga as práticas recomendadas de aplicação de permissões com privilégio mínimo.

   Para obter instruções, consulte [Criar um conjunto de permissões](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-started-create-a-permission-set.html) no *Guia do usuário do Centro de Identidade do AWS IAM*.

1. Atribua usuários a um grupo e, em seguida, atribua o acesso de logon único ao grupo.

   Para obter instruções, consulte [Adicionar grupos](https://docs.aws.amazon.com//singlesignon/latest/userguide/addgroups.html) no *Guia do usuário do Centro de Identidade do AWS IAM*.

# Pré-requisitos completos para configurar AWS Database Migration Service
<a name="CHAP_GettingStarted.Prerequisites"></a>

Nesta seção, você pode aprender as tarefas de pré-requisito para AWS DMS, como configurar seus bancos de dados de origem e destino. Como parte dessas tarefas, configure também uma nuvem privada virtual (VPC) com base no serviço da Amazon VPC para conter os recursos. Além disso, configure uma instância do Amazon EC2 utilizada para preencher o banco de dados de origem e verificar a replicação no banco de dados de destino.

**nota**  
O preenchimento do banco de dados de origem demora até 45 minutos.

Para este tutorial, crie um banco de dados MariaDB como a origem e um banco de dados PostgreSQL como o destino. Este cenário utiliza mecanismos de bancos de dados comuns e de baixo custo para demonstrar a replicação. O uso de mecanismos de banco de dados diferentes demonstra AWS DMS recursos para migrar dados entre plataformas heterogêneas.

Os recursos deste tutorial utilizam a região Oeste dos EUA (Oregon). Se você quiser usar uma AWS região diferente, especifique a região escolhida em vez de onde aparece Oeste dos EUA (Oregon).

**nota**  
Para simplicidade, os bancos de dados criados para este tutorial não usam criptografia ou outros recursos avançados de segurança. Utilize recursos de segurança para manter os bancos de dados de produção seguros. Para obter mais informações, consulte [Segurança no Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.html).

Para obter as etapas de pré-requisito, consulte os tópicos a seguir.

**Topics**
+ [Crie uma VPC](#CHAP_GettingStarted.Prerequisites.VPC)
+ [Criação de grupos de parâmetros do Amazon RDS](#CHAP_GettingStarted.Prerequisites.params)
+ [Criação do banco de dados de origem do Amazon RDS](#CHAP_GettingStarted.Prerequisites.sdatabase)
+ [Criação do banco de dados Amazon RDS de destino](#CHAP_GettingStarted.Prerequisites.tdatabase)
+ [Criação de um cliente do Amazon EC2](#CHAP_GettingStarted.Prerequisites.client)
+ [Preenchimento do banco de dados de origem](#CHAP_GettingStarted.Prerequisites.Populate)

## Crie uma VPC
<a name="CHAP_GettingStarted.Prerequisites.VPC"></a>

Nesta seção, você cria uma VPC para conter seus AWS recursos. Usar uma VPC é uma prática recomendada ao usar AWS recursos, para que seus bancos de dados, instâncias do Amazon EC2, grupos de segurança e assim por diante estejam logicamente organizados e seguros. 

A utilização de uma VPC para os recursos do tutorial também garante excluir todos os recursos utilizados ao concluir o tutorial. Exclua todos os recursos que uma VPC contém para poder excluí-la.

**Para criar uma VPC para uso com AWS DMS**

1. Faça login no Console de gerenciamento da AWS e abra o console da Amazon VPC em. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)

1. No painel de navegação, escolha **Painel da VPC** e **Criar VPC**.

1. Na página **Criar VPC**, escolha as seguintes opções:
   + **Recursos a serem criados**: **VPC e mais**.
   + **Geração automática da etiqueta de nome**: escolha **Gerar automaticamente** e insira **DMSVPC**.
   + **IPv4 bloco**: **10.0.1.0/24**
   + **IPv6 Bloco CIDR: Sem bloco IPv6 ** **CIDR**
   + **Locação**: **Padrão**
   + **Número de zonas de disponibilidade**: 2
   + **Número de sub-redes públicas**: 2
   + **Número de sub-redes privadas**: 2
   + **Gateways NAT (\$1)**: **Nenhum**
   + **Endpoints da VPC**: **Nenhum**

   Escolha **Criar VPC**.

1. No painel de navegação, escolha **Seu VPCs**. Anote o ID da VPC da **DMSVPC**.

1. No painel de navegação, escolha **Grupos de segurança**. 

1. Escolha o grupo chamado **padrão** que tem um **ID de VPC** que corresponda ao ID anotado para **DMSVPC**.

1. Vá para a guia **Regras de entrada** e escolha **Editar regras de entrada**.

1. Escolha **Adicionar regra**. **Adicione uma regra do tipo **MySQL/Aurora** e escolha **Anywhere** - para Source. IPv4** 

1. Escolha **Adicionar regra** novamente. **Adicione uma regra do tipo **PostgreSQL** e **escolha Anywhere IPv4** - para Source.**

1. Escolha **Salvar regras**.

## Criação de grupos de parâmetros do Amazon RDS
<a name="CHAP_GettingStarted.Prerequisites.params"></a>

Para especificar configurações para seus bancos de dados de origem e destino AWS DMS, use grupos de parâmetros do Amazon RDS. Para permitir a replicação inicial e contínua entre os bancos de dados, configure o seguinte:
+ O log binário do seu banco de dados de origem, para que ele AWS DMS possa determinar quais atualizações incrementais ele precisa replicar.
+ A função de replicação do seu banco de dados de destino, de forma que AWS DMS ignore as restrições de chave estrangeira durante a transferência inicial de dados. Com essa configuração, é AWS DMS possível migrar dados fora de ordem.

**Para criar grupos de parâmetros para uso com AWS DMS**

1. Abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. No painel de navegação, escolha **Grupos de parâmetros**.

1. Na página **Grupos de parâmetros**, escolha **Criar grupo de parâmetros**.

1. Na página **Criar grupo de parâmetros**, insira as seguintes configurações:
   + **Família de grupos de parâmetros**: **mariadb10.6**
   + **Nome do grupo:** **dms-mariadb-parameters**
   + **Descrição:** **Group for specifying binary log settings for replication**

   Escolha **Criar**.

1. Na página **Grupos de parâmetros **dms-mariadb-parameters****, escolha e, na **dms-mariadb-parameters**página, escolha **Editar**.

1. Defina os parâmetros a seguir como um dos seguintes valores:
   + **binlog\$1checksum**: **NENHUM**
   + **binlog\$1format**: **LINHA**

   Escolha **Salvar alterações**.

1. Na página **Grupos de parâmetros**, escolha **Criar grupo de parâmetros** novamente.

1. Na página **Criar grupo de parâmetros**, insira as seguintes configurações:
   + **Família de grupos de parâmetros**: **postgres16**
   + **Nome do grupo:** **dms-postgresql-parameters**
   + **Descrição:** **Group for specifying role setting for replication**

   Escolha **Criar**.

1. Na página **Grupos de parâmetros**, escolha **dms-postgresql-parameters**.

1. **Na **dms-postgresql-parameters**página, escolha **Editar** e defina o parâmetro **session\$1replication\$1role** como réplica.** Observe que o parâmetro **session\$1replication\$1role** não está na primeira página de parâmetros. Utilize os controles de paginação ou o campo de pesquisa para localizar o parâmetro.

1. Escolha **Salvar alterações**.

## Criação do banco de dados de origem do Amazon RDS
<a name="CHAP_GettingStarted.Prerequisites.sdatabase"></a>

Utilize o procedimento a seguir para criar o banco de dados Amazon RDS de origem.

**Como criar o banco de dados Amazon RDS para MariaDB de origem**

1. Abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Na página **Painel**, escolha **Criar banco de dados** na seção **Banco de dados**. Não escolha **Criar banco de dados** na seção **Tentar a nova opção de implantação multi-AZ do Amazon RDS para MySQL e PostgreSQL** na parte superior da página.

1. Na página **Criar banco de dados**, defina as seguintes opções:
   + **Escolher um método de criação de banco de dados**: escolha **Criação padrão**.
   + **Opções do mecanismo**: em **Tipo de mecanismo**, escolha **MariaDB**. Em **Versão**, deixe **MariaDB 10.6.14** selecionado.
   + **Modelos**: escolha **Dev/teste**.
   + **Configurações**: 
     + **Identificador da instância do banco de dados**: insira **dms-mariadb**.
     + Na seção **Configurações de credenciais**, insira o seguinte:
       + **Nome do usuário principal**: deixe como**admin**.
       + Deixe a opção **Gerenciar credenciais mestras no AWS Secrets Manager desmarcada**.
       + **Gerar automaticamente uma senha**: deixe desmarcada.
       + **Senha principal**: insira **changeit**.
       + **Confirmar senha**: insira **changeit** novamente.
   + **Configuração da instância**: 
     + **Classe da instância do banco de dados**: deixe a opção **Classes padrão** escolhida.
     + Em **Classe da instância do banco de dados**, escolha **db.m5.large**.
   + **Armazenamento**: 
     + Desmarque a caixa **Ativar escalabilidade automática do armazenamento**.
     + Deixe o restante das configurações como estão.
   + **Disponibilidade e durabilidade**: deixe a opção **Não criar uma instância em espera** selecionada.
   + **Conectividade**:
     + **Recurso de computação**, deixe **Não conectar-se a um recurso de computação do EC2**
     + **Tipo de rede**: Deixe **IPv4**selecionado.
     + **Nuvem privada virtual**: **DMSVPC-vpc**
     + **Acesso público**: **Sim**. Ative o acesso público para utilizar a AWS Schema Conversion Tool.
     + **Zona de disponibilidade**: **us-west-2a**
     + Deixe o restante das configurações como estão.
   + **Autenticação do banco de dados**: deixe **Autenticação por senha** selecionada.
   + Em **Monitoramento**, desmarque a caixa **Ativar o Performance Insights**. Expanda a seção **Configuração adicional** e desmarque a caixa **Ativar monitoramento avançado**.
   + Expanda **Configuração adicional**.
     + Em **Opções de banco de dados**, insira **dms\$1sample** como o **Nome do banco de dados inicial**. 
     + Em **Grupo de parâmetros do banco** de dados, escolha **dms-mariadb-parameters**.
     + Em **Grupo de opções**, deixe **default:mariadb-10-6** selecionado.
     + Em **Backup**, faça o seguinte:
       + Deixe a opção **Ativar backups automáticos** selecionada. O banco de dados de origem deve ter backups automáticos ativados para compatibilidade com a replicação contínua.
       + Em **Período de retenção de backup**, escolha **Um dia**.
       + Em **Janela de backup**, deixe a opção **Sem preferência** selecionada.
       + Desmarque a caixa **Copiar tags para snapshots**.
       + Deixe a **opção Ativar replicação em outra AWS região desmarcada**.
     + Em **Criptografia**, desmarque a caixa **Ativar criptografia**.
     + Deixe a seção **Exportações de logs** como está.
     + Em **Manutenção**, desmarque a caixa **Ativar o upgrade automático da versão secundária** e deixe a configuração **Janela de manutenção** como **Sem preferência**.
     + Deixe a opção **Ativar a proteção contra exclusão** desmarcada.

1. Selecione **Criar banco de dados**.

## Criação do banco de dados Amazon RDS de destino
<a name="CHAP_GettingStarted.Prerequisites.tdatabase"></a>

Repita o procedimento anterior para criar o banco de dados Amazon RDS de destino, com as seguintes alterações.

**Como criar o banco de dados RDS para PostgreSQL de destino**

1. Repita as etapas de 1 e 2 do procedimento anterior. 

1. Na página **Criar banco de dados**, defina as mesmas opções, exceto estas:

   1. Em **Opções do mecanismo**, escolha **PostgreSQL**.

   1. Em **Versão**, escolha uma versão **PostgreSQL 16** disponível.

   1. Em **Identificador de instância de banco de dados**, insira **dms-postgresql**.

   1. Em **Nome de usuário principal**, deixe **postgres** selecionado.

   1. Para o **grupo de parâmetros do banco** de dados, escolha **dms-postgresql-parameters**.

   1. Desmarque **Ativar backups automáticos**.

1. Selecione **Criar banco de dados**.

## Criação de um cliente do Amazon EC2
<a name="CHAP_GettingStarted.Prerequisites.client"></a>

Nesta seção, você cria um cliente do Amazon EC2. Utilize esse cliente para preencher o banco de dados de origem com dados para replicação. Também é possível utilizar esse cliente para verificar a replicação executando consultas no banco de dados de destino.

A utilização de um cliente do Amazon EC2 para acessar os bancos de dados fornece as seguintes vantagens em relação ao acesso aos bancos de dados pela internet:
+ É possível restringir o acesso aos bancos de dados a clientes que estejam na mesma VPC.
+ Confirmamos que as ferramentas utilizadas neste tutorial funcionam e são fáceis de instalar no Amazon Linux 2023, que é recomendável utilizar neste tutorial.
+ As operações de dados entre componentes em uma VPC geralmente têm um desempenho melhor do que por meio da internet.

**Como criar e configurar um cliente do Amazon EC2 para preencher o banco de dados de origem**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No **Painel**, escolha **Iniciar instância**.

1. Na página **Iniciar uma instância**, insira os seguintes valores:

   1. Na seção **Nome e tags**, insira **DMSClient** para **Nome**.

   1. Na seção **Imagens de aplicações e de sistemas operacionais (Imagem de máquina da Amazon)** deixe as configurações como estão.

   1. Na seção **Tipo de instância**, escolha **t2.xlarge**.

   1. Na seção **Par de chaves (login)**, escolha **Criar um novo par de chaves**. 

   1. Na página **Criar par de chaves** insira o seguinte:
      + **Nome do par de chaves**: **DMSKeyPair**
      + **Tipo de par de chaves**: deixe como **RSA**.
      + **Formato de arquivo de chave privada**: escolha **pem** para OpenSSH no MacOS ou Linux ou **ppk** para PuTTY no Windows.

      Salve o arquivo de chave quando solicitado.
**nota**  
Também é possível utilizar um par de chaves existente do Amazon EC2 em vez de criar um novo.

   1. Na seção **Configurações de rede**, escolha **Editar**. Escolha as seguintes configurações:
      + **VPC *obrigatória***: escolha a VPC com o ID registrado para a VPC **DMSVPC-vpc**.
      + **Sub-rede**: escolha a primeira sub-rede pública.
      + **Atribuir IP público automaticamente:** escolha **Habilitar**.

      Deixe o restante das configurações como estão e escolha **Iniciar instância**.

## Preenchimento do banco de dados de origem
<a name="CHAP_GettingStarted.Prerequisites.Populate"></a>

Nesta seção, você encontra endpoints para os bancos de dados de origem e de destino para uso posterior, e utiliza as seguintes ferramentas para preencher o banco de dados de origem:
+ Git, para baixar o script que preenche o banco de dados de origem.
+ Cliente MariaDB, para executar esse script.

### Obtenção de endpoints
<a name="CHAP_GettingStarted.Prerequisites.Populate.Hosts"></a>

Encontre e anote os endpoints das instâncias de banco de dados do RDS para MariaDB e do RDS para PostgreSQL para uso posterior.

**Como encontrar os endpoints da instância do banco de dados**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. No painel de navegação, escolha **Bancos de dados**.

1. Escolha o banco de dados **dms-mariadb** e anote o valor do **Endpoint** do banco de dados.

1. Repita as etapas anteriores para o banco de dados **dms-postgresql**.

### Preenchimento do banco de dados de origem
<a name="CHAP_GettingStarted.Prerequisites.Populate.Git"></a>

Em seguida, conecte-se à sua instância cliente, instale o software necessário, baixe AWS exemplos de scripts de banco de dados do Git e execute os scripts para preencher seu banco de dados de origem.

**Como preencher o banco de dados de origem**

1. Conecte-se à instância do cliente utilizando o nome do host e a chave pública salva nas etapas anteriores. 

   Para ter mais informações sobre como conectar-se a uma instância do Amazon EC2, consulte [Accessing Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstances.html) no *Guia do usuário do Amazon EC2*.
**nota**  
Se estiver utilizando o PuTTY, habilite os keepalives de TCP na página de configurações da **Conexão** para que a conexão não atinja o tempo limite devido à inatividade.

1. Instale o Git, o MariaDB e o PostgreSQL. Confirme a instalação conforme necessário.

   ```
   $ sudo yum install git
   $ sudo dnf install mariadb105
   $ sudo dnf install postgresql15
   ```

1. Execute o comando a seguir para baixar os scripts de criação de banco de dados do GitHub.

   ```
   git clone https://github.com/aws-samples/aws-database-migration-samples.git
   ```

1. Mude para o diretório `aws-database-migration-samples/mysql/sampledb/v1/`.

1. Execute o comando a seguir. Forneça o endpoint para a instância do RDS de origem anotada anteriormente, por exemplo `dms-mariadb.cdv5fbeyiy4e.us-east-1.rds.amazonaws.com`.

   ```
   mysql -h dms-mariadb.abcdefghij01.us-east-1.rds.amazonaws.com -P 3306 -u admin -p dms_sample < ~/aws-database-migration-samples/mysql/sampledb/v1/install-rds.sql
   ```

1. Deixe o script de criação do banco de dados ser executado. O script demora até 45 minutos para criar o esquema e preencher os dados. É possível ignorar com segurança os erros e avisos exibidos pelo script.

# Migrando seu esquema de origem para seu banco de dados de destino usando AWS SCT
<a name="CHAP_GettingStarted.SCT"></a>

Recomendamos usar o DMS Schema Conversion para converter seus esquemas de banco de dados de origem. Para obter mais informações, consulte [Conceitos básicos da DMS Schema Conversion](getting-started.md). Se você preferir usar o legado AWS Schema Conversion Tool, siga as etapas abaixo.

**Para migrar seu esquema de origem para seu banco de dados de destino com AWS SCT**

1. Instale AWS Schema Conversion Tool o. Para obter mais informações, consulte [Instalação, verificação e atualização da AWS SCT](https://docs.aws.amazon.com/SchemaConversionTool/latest/userguide/CHAP_Installing.html#CHAP_Installing.Procedure) no *AWS Guia do usuário da Schema Conversion Tool*. 

   Ao baixar drivers JDBC para o MySQL e o PostgreSQL, anote o local em que salva os drivers, caso a ferramenta solicite a localização deles.

1. Abra AWS Schema Conversion Tool o. Escolha **Arquivo** e **Novo projeto**.

1. Na janela **Novo projeto**, defina os seguintes valores:
   + Defina o **Nome do projeto** como **DMSProject**.
   + Mantenha a **localização** como está para armazenar seu AWS SCT projeto na pasta padrão.

   Escolha **OK**.

1. Escolha **Adicionar origem** para adicionar um banco de dados MySQL de origem ao projeto e escolha **MySQL** e **Avançar**.

1. Na página **Adicionar origem**, defina os seguintes valores:
   + **Nome da conexão**: **source**
   + **Nome do servidor**: insira o endpoint do banco de dados MySQL anotado anteriormente.
   + **Porta do servidor**: **3306**
   + **Nome do usuário**: **admin**
   + **Senha**: **changeit**

1. Escolha **Adicionar destino** para adicionar um banco de dados de destino do Amazon RDS para PostgreSQL ao projeto e escolha **Amazon RDS para PostgreSQL**. Escolha **Próximo**.

1. Na página **Adicionar origem**, defina os seguintes valores:
   + **Nome da conexão**: **target**
   + **Nome do servidor**: insira o endpoint do banco de dados PostgreSQL anotado anteriormente.
   + **Porta do servidor**: **5432**
   + **Banco de dados**: insira o nome do banco de dados PostgreSQL.
   + **Nome do usuário**: **postgres**
   + **Senha**: **changeit**

1. No painel esquerdo, escolha **dms\$1sample** em **Esquemas**. No painel direito, escolha o banco de dados Amazon RDS para PostgreSQL de destino. Escolha **Criar mapeamento**. Você pode adicionar várias regras de mapeamento a um único AWS SCT projeto. Para obter mais informações sobre regras de mapeamento, consulte [Criação de regras de mapeamento](https://docs.aws.amazon.com/SchemaConversionTool/latest/userguide/CHAP_Mapping.html). 

1. Escolha **Visualização principal**.

1. No painel esquerdo, escolha **dms\$1sample** em **Esquemas**. Abra o menu de contexto (clique com o botão direito do mouse) e selecione **Converter esquema**. Confirme a ação.

   Depois que a ferramenta converte o esquema, o esquema **dms\$1sample** aparece no painel direito.

1. No painel direito, em **Esquemas**, abra o menu de contexto (clique com o botão direito do mouse) de **dms\$1sample** e escolha **Aplicar ao banco de dados.** Confirme a ação.

Verifique se a migração do esquema foi concluída. Siga as etapas a seguir.

**Para verificar a migração do esquema**

1. Conecte-se ao cliente do Amazon EC2.

1. Inicie o cliente do PSQL com o comando a seguir. Especifique o endpoint do banco de dados PostgreSQL e forneça a senha do banco de dados quando solicitado.

   ```
   psql \
      --host=dms-postgresql.abcdefg12345.us-west-2.rds.amazonaws.com \
      --port=5432 \
      --username=postgres \
      --password \
      --dbname=dms_sample
   ```

1. Consulte uma das tabelas (vazias) para verificar se AWS SCT aplicou o esquema corretamente,

   ```
   dms_sample=> SELECT * from dms_sample.player;
    id | sport_team_id | last_name | first_name | full_name
   ----+---------------+-----------+------------+-----------
   (0 rows)
   ```

# Configurar a replicação para AWS Database Migration Service
<a name="CHAP_GettingStarted.Replication"></a>

Neste tópico, você configura a replicação entre os bancos de dados de origem e de destino.

## Etapa 1: criar uma instância de replicação usando o console AWS DMS
<a name="CHAP_GettingStarted.Replication.ReplicationInstance"></a>

Para começar a trabalhar AWS DMS, crie uma instância de replicação.

Uma *instância de replicação* executa a migração real de dados entre os endpoints de origem e de destino. A instância precisa de armazenamento e capacidade de processamento suficientes para executar as tarefas que migram os dados do banco de dados de origem para o banco de dados de destino. O tamanho dessa instância de replicação depende da quantidade de dados a serem migrados e das tarefas que a instância precisa executar. Para obter mais informações sobre as instâncias de replicação, consulte [Trabalhando com uma instância de AWS DMS replicação](CHAP_ReplicationInstance.md).

![\[Criação de uma instância de replicação\]](http://docs.aws.amazon.com/pt_br/dms/latest/userguide/images/datarep-create-replication-30a.png)


**Como criar uma instância de replicação utilizando o console**

1. Faça login no Console de gerenciamento da AWS e abra o AWS DMS console em [https://console.aws.amazon.com/dms/v2/](https://console.aws.amazon.com/dms/v2/).

1. No painel de navegação, selecione **Instâncias de replicação** e escolha **Criar instância de replicação**.

1. Na página **Criar instância de replicação**, especifique a configuração da instância de replicação:

   1. Em **Nome**, insira **DMS-instance**. 

   1. Em **Descrição**, insira uma breve descrição para a instância de replicação (opcional).

   1. Em **Classe de instância**, deixe **dms.t3.medium** escolhida.

      A instância precisa de armazenamento, de rede e de capacidade de processamento suficientes para a migração. Para obter mais informações sobre como escolher uma classe de instância, consulte [Escolhendo a instância de replicação AWS DMS certa para sua migração](CHAP_ReplicationInstance.Types.md).

   1. Em **Versão do mecanismo**, aceite o padrão.

   1. Em **Multi AZ**, escolha **Workload de dev ou de teste (Single-AZ)**.

   1. Em **Armazenamento alocado (GiB)**, aceite o padrão de 50 GiB.

      Em AWS DMS, o armazenamento é usado principalmente por arquivos de log e transações em cache. Para transações armazenadas em cache, o armazenamento só é usado quando as transações devem ser gravadas em disco. Como resultado, AWS DMS não usa uma quantidade significativa de armazenamento.

   1. Para **Tipo de rede**, escolha **IPv4**.

   1. Em **VPC**, escolha **DMSVPC**.

   1. Em **Grupo de sub-redes de replicação**, deixe o grupo de sub-redes de replicação escolhido atualmente.

   1. Desmarque **Publicamente acessível**.

1. Escolha a guia **Segurança avançada e configuração de rede** para definir os valores das configurações de rede e de criptografia, se necessário: 

   1. Em **Zona de disponibilidade**, escolha **us-west-2a**.

   1. Em **Grupos de segurança da VPC**, escolha o grupo de segurança **Padrão**, se ainda não estiver escolhido.

   1. Em **AWS KMS key**, deixe **(Padrão) aws/dms** escolhido.

1. Deixe as configurações na guia **Manutenção** como estão. O padrão é uma janela de 30 minutos selecionada aleatoriamente a partir de um bloco de 8 horas para cada AWS região, ocorrendo em um dia aleatório da semana.

1. Escolha **Criar**.

AWS DMS cria uma instância de replicação para realizar sua migração.

## Etapa 2: Especificar endpoints de origem e de destino
<a name="CHAP_GettingStarted.Replication.Endpoints"></a>

Enquanto a instância de replicação estiver sendo criada, é possível especificar os endpoints dos datastore de destino para os bancos de dados Amazon RDS criados anteriormente. Crie cada endpoint separadamente.

![\[Criação de endpoint\]](http://docs.aws.amazon.com/pt_br/dms/latest/userguide/images/datarep-create-endpoint-30a.png)


**Para especificar um endpoint de origem e um endpoint de banco de dados usando o console AWS DMS**

1. No console, escolha **Endpoints** no painel de navegação e escolha **Criar endpoint**.

1. Na página **Criar endpoint**, escolha o tipo de endpoint de **Origem**. Escolha caixa **Selecionar instância de banco de dados RDS** e escolha a instância **dms-mariadb**.

1. Na seção **Configuração de endpoint**, insira **dms-mysql-source** para o **Identificador do endpoint**.

1. Em **Mecanismo de origem**, deixe o **MySQL** escolhido.

1. Em **Acesso ao banco de dados de endpoint**, escolha **Fornecer informações de acesso manualmente**. Verifique se a **Porta**, o **Modo SSL (Secure Socket Layer)**, o **Nome do usuário** e a **Senha** estão corretos. 

1. Escolha a guia **Testar a conexão do endpoint (opcional)** Em **VPC**, escolha **DMSVPC**.

1. Em **Instância de replicação**, deixe **dms-instance** escolhida.

1. Escolha **Executar teste**.

   Depois de escolher **Executar teste**, AWS DMS cria o endpoint com os detalhes que você forneceu e se conecta a ele. Se a conexão falhar, edite a definição do endpoint e teste a conexão novamente. Também é possível excluir o endpoint manualmente.

1. Depois que o teste for bem-sucedido, escolha **Criar endpoint**.

1. Especifique um endpoint de banco de dados de destino usando o AWS DMS console. Para isso, repita as etapas anteriores, com as seguintes configurações:
   + **Tipo de endpoint**: **Endpoint de destino**.
   + **Instância do RDS**: **dms-postgresql**
   + **Identificador do endpoint**: **dms-postgresql-target**
   + **Mecanismo de destino**: deixe **PostgreSQL** escolhido.

Quando você terminar de fornecer todas as informações para seus endpoints, AWS DMS cria seus endpoints de origem e destino para uso durante a migração do banco de dados. 

## Etapa 3: Criar uma tarefa e migrar os dados
<a name="CHAP_GettingStarted.Replication.Tasks"></a>

Nesta etapa, você cria uma tarefa para migrar os dados entre os bancos de dados criados. 

![\[Criação de uma tarefa de migração\]](http://docs.aws.amazon.com/pt_br/dms/latest/userguide/images/datarep-create-task-20a.png)


**Como criar uma tarefa de migração e iniciar a migração do banco de dados**

1. No painel de navegação do console, escolha **Tarefas de migração de banco de dados** e escolha **Criar tarefa**. A página **Criar tarefa de migração de banco de dados** é aberta. 

1. Na seção **Configuração da tarefa**, especifique as seguintes opções de tarefa: 
   + **Identificador da tarefa**: insira **dms-task**.
   + **Instância de replicação**: escolha sua instância de replicação (**dms-instance-vpc- *<vpc id>***). 
   + **Ponto final do banco de dados de origem**: escolha **dms-mysql-source**.
   + **Ponto final do banco de dados de destino**: escolha **dms-postgresql-target**.
   + **Tipo de migração**: escolha **Migrar dados existentes e replicar as alterações em andamento**.

1. Escolha a guia **Configurações da tarefa**. Defina as seguintes configurações:
   + **Modo de preparação da tabela de destino**: **Não executar nenhuma ação**
   + **Interromper a tarefa após a conclusão da carga máxima**: **Não interromper**

1. Escolha a guia **Mapeamentos de tabela** e expanda a guia **Regras de seleção**. Escolha **Adicionar nova regra de seleção**. Defina as seguintes configurações:
   + **Esquema**: **Insira um esquema**
   + **Nome do esquema**: **dms\$1sample**

1. Escolha a guia **Configuração de inicialização da tarefa de migração**. Selecione **Iniciar com avaliações de pré-migração (recomendado)** para executar avaliações antes de iniciar a tarefa. Como alternativa, você pode escolher **Iniciar automaticamente ao criar** para iniciar a migração imediatamente ou **Executar avaliações somente** para avaliar sem iniciar a tarefa.  
![\[Criação de uma tarefa de migração\]](http://docs.aws.amazon.com/pt_br/dms/latest/userguide/images/datarep-create-task-21.png)

1. Escolha **Criar tarefa**.

AWS DMS em seguida, cria a tarefa de migração e a inicia. A replicação inicial do banco de dados demora cerca de 10 minutos. Execute a próxima etapa do tutorial antes que o AWS DMS conclua a migração dos dados.

## Etapa 4: Testar a replicação
<a name="CHAP_GettingStarted.Replication.Monitoring"></a>

Nesta seção, você insere os dados no banco de dados de origem durante e depois da replicação inicial e consulta os dados inseridos no banco de dados de destino.

**Como testar a replicação**

1. Verifique se a tarefa de migração de banco de dados mostra o status **Em execução**, mas se a replicação inicial do banco de dados, iniciada na etapa anterior, não está concluída.

1. Conecte-se ao cliente Amazon EC2 e inicie o cliente MySQL com o comando a seguir. Forneça o endpoint de banco de dados MySQL.

   ```
   mysql -h dms-mysql.abcdefg12345.us-west-2.rds.amazonaws.com -P 3306 -u admin -pchangeit dms_sample
   ```

1. Execute o comando a seguir para inserir um registro no banco de dados de origem.

   ```
   MySQL [dms_sample]> insert person (full_name, last_name, first_name) VALUES ('Test User1', 'User1', 'Test');
   Query OK, 1 row affected (0.00 sec)
   ```

1. Saia do cliente MySQL.

   ```
   MySQL [dms_sample]> exit
   Bye
   ```

1. Antes da conclusão da replicação, consulte o banco de dados de destino para obter o novo registro. 

   Na instância do Amazon EC2, conecte-se ao banco de dados de destino utilizando o comando a seguir, fornecendo o endpoint do banco de dados de destino.

   ```
   psql \
      --host=dms-postgresql.abcdefg12345.us-west-2.rds.amazonaws.com \
      --port=5432 \
      --username=postgres \
      --password \
      --dbname=dms_sample
   ```

   Quando solicitado, forneça a senha (**changeit**).

1. Antes da conclusão da replicação, consulte o banco de dados de destino para obter o novo registro. 

   ```
   dms_sample=> select * from dms_sample.person where first_name = 'Test';
    id | full_name | last_name | first_name
   ----+-----------+-----------+------------
   (0 rows)
   ```

1. Enquanto a tarefa de migração estiver em execução, é possível monitorar o andamento da migração do banco de dados à medida que acontece:
   + No painel de navegação do console do DMS, escolha **Tarefas de migração do banco de dados**.
   + Escolha **dms-task**.
   + Escolha **Estatísticas da tabela**.

   Para obter mais informações sobre o monitoramento, consulte [Monitorando AWS tarefas do DMS](CHAP_Monitoring.md).

1. Depois que a replicação for concluída, consulte novamente o banco de dados de destino para obter o novo registro. AWS DMS migra o novo registro após a conclusão da replicação inicial.

   ```
   dms_sample=> select * from dms_sample.person where first_name = 'Test';
      id    | full_name  | last_name | first_name
   ---------+------------+-----------+------------
    7077784 | Test User1 | User1     | Test
   (1 row)
   ```

1. Saia do cliente psql.

   ```
   dms_sample=> quit
   ```

1. Repita a etapa 1 para conectar-se novamente ao banco de dados de origem.

1. Insira outro registro na tabela `person`.

   ```
   MySQL [dms_sample]> insert person (full_name, last_name, first_name) VALUES ('Test User2', 'User2', 'Test');
   Query OK, 1 row affected (0.00 sec)
   ```

1. Repita as etapas 3 e 4 para desconectar-se do banco de dados de destino.

1. Consulte o banco de dados de destino novamente para obter os dados replicados.

   ```
   dms_sample=> select * from dms_sample.person where first_name = 'Test';
      id    | full_name  | last_name | first_name
   ---------+------------+-----------+------------
    7077784 | Test User1 | User1     | Test
    7077785 | Test User2 | User2     | Test
   (2 rows)
   ```

## Etapa 5: limpar AWS DMS os recursos
<a name="CHAP_GettingStarted.Replication.Deleting"></a>

Depois de concluir o tutorial de conceitos básicos, é possível excluir os recursos criados. Você pode usar o AWS console para removê-los. Exclua as tarefas de migração antes de excluir a instância de replicação e os endpoints.

**Como excluir uma tarefa de migração utilizando o console**

1. No painel de navegação do AWS DMS console, escolha **Tarefas de migração de banco de dados**.

1. Escolha **dms-task**.

1. Selecione **Ações**, **Excluir**. 

**Como excluir uma instância de replicação utilizando o console**

1. No painel de navegação AWS DMS do console, escolha **Replication instances.**

1. Escolha **DMS-instance**.

1. Selecione **Ações**, **Excluir**. 

AWS DMS exclui a instância de replicação e a remove da página Instâncias de **replicação.**

**Como remover os endpoints utilizando o console**

1. No painel de navegação AWS DMS do console, escolha **Endpoints**.

1. Selecione **dms-mysql-source**.

1. Selecione **Ações**, **Excluir**.

Depois de excluir seus AWS DMS recursos, certifique-se também de excluir os seguintes recursos. Para obter ajuda com a exclusão de recursos em outros serviços, consulte a documentação de cada serviço.
+ Os bancos de dados RDS.
+ Os grupos de parâmetros do banco de dados RDS.
+ Os grupos de sub-redes do RDS.
+ Todos CloudWatch os registros da Amazon que foram criados junto com seus bancos de dados e instância de replicação.
+ Os grupos de segurança criados para a Amazon VPC e o cliente do Amazon EC2. Remova a regra de entrada de **Padrão** para os grupos de segurança **launch-wizard-1**, o que é necessário para que seja possível excluí-los.
+ O cliente Amazon EC2.
+ A Amazon VPC.
+ O par de chaves do Amazon EC2 do cliente do Amazon EC2.