Migrar o PolarDB-X 2.0 para o Message Queue for Apache Kafka - Data Transmission Service: Central de Documentação do Alibaba Cloud

Saiba como usar o Data Transmission Service (DTS) para migrar dados de uma instância do PolarDB-X para o Message Queue for Apache Kafka e escalar o processamento de mensagens.

Pré-requisitos

Para começar, crie uma instância de origem do PolarDB-X 2.0.
Em seguida, crie um tópico na instância de destino do Message Queue for Apache Kafka para receber os dados migrados. Para obter detalhes, consulte Step 1: Create a topic.
As instâncias de origem e de destino devem usar versões de banco de dados compatíveis. Para mais informações, consulte Database versions.
O espaço de armazenamento da instância de destino do Message Queue for Apache Kafka deve ser maior que o utilizado pela instância do PolarDB-X 2.0.

Limitações

Nota

O DTS não migra chaves estrangeiras. Como resultado, operações em cascata, como a exclusão em cascata no banco de dados de origem, não são replicadas no banco de dados de destino.

Tipo	Descrição
Limitações do banco de dados de origem	O servidor que hospeda o banco de dados de origem deve ter largura de banda de saída suficiente. A largura de banda insuficiente retarda a migração de dados. Não há suporte para instâncias somente leitura do PolarDB-X 2.0 Enterprise Edition como banco de dados de origem. As tabelas a serem migradas devem ter uma PRIMARY KEY ou uma restrição UNIQUE, e os campos da chave ou restrição devem ser exclusivos. Caso contrário, podem ocorrer dados duplicados no banco de dados de destino. Se você migrar objetos no nível de tabela e precisar editá-los (por exemplo, mapeando nomes de colunas), uma única tarefa de migração de dados suportará no máximo 1.000 tabelas. Se exceder esse limite, o envio da tarefa falhará. Nesse caso, divida as tabelas em várias tarefas de migração de dados ou configure uma tarefa para migrar o banco de dados inteiro. Para a migração incremental de dados, o banco de dados de origem deve atender aos seguintes requisitos de log binário: Ative o recurso de log binário e defina o parâmetro `binlog_row_image` como `full`. Caso contrário, a pré-verificação falhará e não será possível iniciar a tarefa de migração de dados. Para tarefas de migração incremental de dados, o DTS exige que os logs binários do banco de dados de origem sejam retidos por pelo menos 24 horas. Para tarefas que incluem migração completa e incremental, os logs binários devem ser retidos por pelo menos 7 dias. É possível alterar o período de retenção para 24 horas após a conclusão da migração completa. Se os logs binários não forem retidos pelo período necessário, o DTS poderá não conseguir obtê-los, o que pode causar falhas na tarefa ou até mesmo inconsistência e perda de dados. O SLA do DTS não cobre problemas causados por um período de retenção de log binário insuficiente. Se o nome de uma tabela na instância do PolarDB-X 2.0 contiver letras maiúsculas, haverá suporte apenas para a migração de schema dessa tabela. Limitações operacionais do banco de dados de origem: Durante a migração de schema e a migração completa de dados, não execute operações DDL que alterem o schema do banco de dados ou da tabela. Caso contrário, a tarefa de migração de dados falhará. Nota Durante a migração completa de dados, o DTS consulta o banco de dados de origem. Essa ação aplica um bloqueio de metadados, que pode impedir operações DDL no banco de dados de origem. Se for necessário alterar o tipo de rede da instância do PolarDB-X 2.0 durante a migração, atualize as informações de conexão de rede da tarefa após a conclusão da alteração. Se executar apenas a migração completa, não grave novos dados no banco de dados de origem durante o processo. Caso contrário, os dados ficarão inconsistentes entre os bancos de dados de origem e de destino. Para manter a consistência dos dados em tempo real, selecione a migração de schema, a migração completa e a migração incremental. Não há suporte para a migração de grupos de tabelas (TABLEGROUP) e bancos de dados ou tabelas com o atributo Locality. Não há suporte para a migração de tabelas cujos nomes são palavras reservadas, como `select`. Em uma instância do PolarDB-X 2.0, não há suporte para a sincronização de partições de banco de dados no modo DRDS. Durante a execução de uma tarefa de migração do DTS, não há suporte para a alteração do tipo de uma tabela de broadcast na instância de origem do PolarDB-X 2.0 (por exemplo, alterar uma tabela de broadcast para uma tabela regular ou fragmentada). Para alterar o tipo de tabela, primeiro pare a tarefa de migração e, em seguida, reconfigure-a após a conclusão da alteração.
Outras limitações	Não é possível migrar os seguintes objetos de banco de dados: índices, partições, visualizações, procedimentos, funções, gatilhos e chaves estrangeiras (FK). Avalie o desempenho dos bancos de dados de origem e de destino antes de iniciar a migração. Recomendamos executar a migração de dados em horários de menor pico, pois o DTS consome recursos de leitura e gravação em ambos os bancos de dados durante a migração completa, o que aumenta a carga do banco de dados. Durante a migração completa, operações INSERT simultâneas podem causar fragmentação de tabelas no banco de dados de destino. Como resultado, as tabelas no banco de dados de destino podem ocupar mais espaço de armazenamento do que as do banco de dados de origem. O DTS tenta recuperar tarefas com falha por até sete dias. Antes de alternar suas cargas de trabalho para o banco de dados de destino, encerre ou libere a tarefa, ou revogue as permissões de gravação da conta do DTS no banco de dados de destino usando o comando `REVOKE`. Isso impede que o DTS sobrescreva dados no banco de dados de destino caso a tarefa seja recuperada automaticamente. Se dimensionar a instância de destino do Message Queue for Apache Kafka (scale out ou scale in) durante a migração de dados, reinicie a instância do DTS. Se uma tarefa falhar, a equipe de suporte do DTS tentará restaurá-la em até oito horas. Durante a restauração, a equipe pode reiniciar a tarefa ou ajustar seus parâmetros. Nota Apenas os parâmetros da tarefa do DTS são modificados, e não os parâmetros do banco de dados. Os parâmetros que podem ser ajustados incluem aqueles listados em Modify instance parameters.
Precauções	O DTS atualiza periodicamente a tabela `dts_health_check`.`ha_health_check` no banco de dados de origem para avançar a posição do log binário.

Faturamento

Tipo de migração	Taxa de configuração da instância	Taxa de tráfego de Internet
Migração de schema e migração completa de dados	Gratuito.	Quando o parâmetro Access Method do banco de dados de destino é definido como Public IP Address, há cobrança pelo tráfego de Internet. Para mais informações, consulte Billing overview.
Migração incremental de dados	Cobrado. Para mais informações, consulte Billing overview.

Tipos de migração

Migração de schema

O DTS migra as definições de schema dos objetos de migração do banco de dados de origem para o banco de dados de destino.
Migração completa

O DTS migra todos os dados históricos dos objetos de migração especificados do banco de dados de origem para o banco de dados de destino.
Migração incremental

Após a conclusão da migração completa, o DTS migra as atualizações incrementais de dados do banco de dados de origem para o de destino. A migração incremental permite migrar dados de forma contínua, sem interromper as aplicações autogerenciadas.

Operações SQL para migração incremental

Tipo de operação	Instrução SQL
DML	`INSERT`, `UPDATE` e `DELETE`
DDL	`CREATE TABLE`, `ALTER TABLE`, `DROP TABLE`, `RENAME TABLE` e `TRUNCATE TABLE` Importante Uma operação RENAME TABLE pode causar inconsistência de dados. Por exemplo, se selecionar apenas uma tabela como objeto de migração e renomeá-la na instância de origem durante a migração, os dados dessa tabela não serão migrados para o banco de dados de destino. Para evitar esse problema, selecione o banco de dados inteiro ao qual a tabela pertence como objeto de migração ao configurar a tarefa. Certifique-se de que os bancos de dados aos quais a tabela pertence antes e depois da operação RENAME TABLE estejam incluídos nos objetos de migração. `CREATE FUNCTION`, `DROP FUNCTION`, `CREATE TRIGGER` e `DROP TRIGGER` `CREATE INDEX` e `DROP INDEX` Nota Se o banco de dados de origem for uma instância do PolarDB-X 2.0 Enterprise Edition, as operações `CREATE FUNCTION` e `CREATE INDEX` não serão migradas.

Permissões da conta do banco de dados

Banco de dados	Migração de schema	Migração completa	Migração incremental
Instância do PolarDB-X	Permissão SELECT	Permissão SELECT	Permissões REPLICATION SLAVE e REPLICATION CLIENT, e permissão SELECT nos objetos a serem migrados. Nota Para obter informações sobre como conceder permissões, consulte Account permission issues during data synchronization.

Para iniciar, acesse a página da lista de tarefas de migração da região de destino usando um dos seguintes métodos.
Pelo console do DTS
1. Faça login no console do Data Transmission Service (DTS).
2. No painel de navegação à esquerda, clique em Data Migration.
3. No canto superior esquerdo da página, selecione a região onde a instância de migração está localizada.
Pelo console do DMS

Nota
As operações reais podem variar com base no modo e no layout do console do DMS. Para mais informações, consulte Simple mode console e Customize the layout and style of the DMS console.
1. Faça login no console do Data Management (DMS).
2. Na barra de menu superior, escolha Data + AI > Data Transmission (DTS) > Data Migration.
3. À direita de Data Migration Tasks, selecione a região onde a instância de migração está localizada.
Clique em Create Task para acessar a página de configuração da tarefa.

Configure os bancos de dados de origem e de destino.

Aviso

Após selecionar as instâncias de origem e de destino, recomendamos ler atentamente as limitações exibidas na parte superior da página. Caso contrário, a tarefa pode falhar ou podem ocorrer inconsistências de dados.

Categoria	Parâmetro	Descrição
N/D	Task Name	O DTS gera automaticamente um nome para a tarefa. Recomendamos especificar um nome descritivo para facilitar a identificação. O nome não precisa ser exclusivo.
Source Database	Select Existing Connection	Para usar uma instância de banco de dados que foi added to the system (criada ou salva), selecione a instância desejada na lista suspensa. As informações do banco de dados abaixo serão configuradas automaticamente. Nota No console do DMS, este parâmetro é nomeado Select a DMS database instance.. Se não registrou a instância do banco de dados no sistema ou não precisa usar uma instância registrada, configure manualmente as informações do banco de dados abaixo.
	Database Type	Selecione PolarDB-X 2.0.
	Connection Type	Selecione Alibaba Cloud Instance.
	Instance Region	Selecione a região onde a instância de origem do PolarDB-X 2.0 está localizada.
	Replicate Data Across Alibaba Cloud Accounts	Este exemplo demonstra a migração dentro da mesma conta da Alibaba Cloud. Selecione No.
	Instance ID	Selecione o ID da instância de origem do PolarDB-X 2.0.
	Database Account	Agora, insira a conta do banco de dados para a instância de origem do PolarDB-X 2.0. Para obter informações sobre as permissões necessárias, consulte Permissions required for database accounts.
	Database Password	Em seguida, insira a senha correspondente à conta do banco de dados.
Destination Database	Select Existing Connection	Para usar uma instância de banco de dados que foi added to the system (criada ou salva), selecione a instância desejada na lista suspensa. As informações do banco de dados abaixo serão configuradas automaticamente. Nota No console do DMS, este parâmetro é nomeado Select a DMS database instance.. Se não registrou a instância do banco de dados no sistema ou não precisa usar uma instância registrada, configure manualmente as informações do banco de dados abaixo.
	Database Type	Selecione Kafka.
	Connection Type	Selecione Express Connect, VPN Gateway, or Smart Access Gateway. Nota Nesta etapa, a instância do Message Queue for Apache Kafka é configurada como um banco de dados Kafka autogerenciado.
	Instance Region	Selecione a região onde a instância Kafka de destino está localizada.
	Connected VPC	Selecione o ID da VPC à qual a instância Kafka de destino pertence. É possível encontrar o ID da VPC na página Basic Information da instância Kafka.
	Domain Name or IP	Por favor, insira um endereço IP do Default Endpoint da instância Kafka. Nota É possível obter o endereço IP na seção Default Endpoint, na página Basic Information da instância Kafka.
	Port	A porta de serviço da instância Kafka. Padrão: 9092.
	Database Account	Aqui, insira a conta do banco de dados para a instância Kafka de destino. Nota Se a instância Kafka for uma VPC instance, não será necessário configurar as definições de Database Account e Database Password.
	Database Password	Logo após, insira a senha correspondente à conta do banco de dados.
	Kafka Version	Selecione a versão que corresponde à sua instância Kafka.
	Connection Method	Selecione Non-encrypted ou SCRAM-SHA-256 com base nos seus requisitos de negócios e de segurança.
	Topic	Selecione o tópico para receber os dados.
	Use Kafka Schema Registry	O Kafka Schema Registry é uma camada de service de metadados que fornece uma interface RESTful para armazenar e recuperar schemas Avro. No: Não usar o Kafka Schema Registry. Yes: Usar o Kafka Schema Registry. Por favor, insira a URL ou o endereço IP do schema Avro registrado no Kafka Schema Registry.

Após concluir a configuração, clique em Test Connectivity and Proceed na parte inferior da página.
Nota
- Certifique-se de que o segmento de endereços IP do serviço DTS seja adicionado automática ou manualmente às configurações de segurança dos bancos de dados de origem e de destino para permitir o acesso dos servidores do DTS. Para mais informações, consulte Add DTS server IP addresses to a whitelist.
- Se o banco de dados de origem ou de destino for autogerenciado (o Access Method não é Alibaba Cloud Instance), clique também em Test Connectivity na caixa de diálogo CIDR Blocks of DTS Servers que aparece.

Configure os objetos da tarefa.

Na página Configure Objects, configure os objetos que deseja migrar.

Parâmetro	Descrição
Migration Types	Se precisar executar apenas uma migração completa, selecione Schema Migration e Full Data Migration. Para executar uma migração sem tempo de inatividade, selecione Schema Migration, Full Data Migration e Incremental Data Migration. Nota Se não selecionar Schema Migration, garanta que exista um banco de dados e tabelas para receber os dados no banco de dados de destino. Também é possível usar o recurso de mapeamento de nomes de objetos na caixa Selected Objects, conforme necessário. Se não selecionar Incremental Data Migration, não grave novos dados na instância de origem durante a migração de dados para garantir a consistência dos dados.
Processing Mode for Existing Destination Tables	Precheck and Report Errors: Verifica se existem tabelas com os mesmos nomes no banco de dados de destino. Se não existirem, a pré-verificação é aprovada. Se existirem, um erro será relatado durante a pré-verificação e a tarefa de migração de dados não será iniciada. Nota Se uma tabela no banco de dados de destino tiver o mesmo nome, mas não puder ser facilmente excluída ou renomeada, altere o nome da tabela no banco de dados de destino. Para mais informações, consulte Object name mapping. Ignore Errors and Proceed: Ignora a verificação de tabelas com os mesmos nomes. Aviso Selecionar Ignore Errors and Proceed pode causar inconsistência de dados e riscos aos negócios. Por exemplo: Se os schemas das tabelas forem consistentes e um registro no banco de dados de destino tiver o mesmo valor de chave primária que um registro no banco de dados de origem: Durante a migração completa, o DTS mantém o registro no banco de dados de destino. O registro do banco de dados de origem não é migrado. Durante a migração incremental, o DTS não mantém o registro no banco de dados de destino. O registro do banco de dados de origem sobrescreve o registro no banco de dados de destino. Se os schemas das tabelas forem inconsistentes, apenas algumas colunas de dados poderão ser migradas, ou a migração poderá falhar. Prossiga com cautela.
Data Format in Kafka	Selecione o formato de armazenamento para os dados migrados para a instância Kafka. Se selecionar DTS Avro, analise os dados com base na definição de schema do DTS Avro. Para mais informações, consulte DTS Avro schema definition e DTS Avro deserialization example. Se selecionar Canal JSON, consulte Canal JSON format para obter descrições e exemplos de parâmetros.
Kafka Data Compression Format	Selecione um formato de compactação para mensagens do Kafka com base em seus requisitos. LZ4 (padrão): baixa taxa de compactação, alta velocidade de compactação. GZIP: alta taxa de compactação, baixa velocidade de compactação. Nota Alto consumo de cpu. Snappy: taxa de compactação média, velocidade de compactação média.
Policy for Shipping Data to Kafka Partitions	Selecione uma policy com base nos seus requisitos de negócios. Importante Se o banco de dados de origem for uma instância do PolarDB-X 1.0, não há suporte para esse recurso.
Message acknowledgement mechanism	Selecione um message acknowledgment mechanism com base nos seus requisitos de negócios.
Capitalization of Object Names in Destination Instance	Configure a política de diferenciação de maiúsculas e minúsculas para os nomes de schemas, tabelas e colunas na instância de destino. Por padrão, DTS default policy está selecionado. Também é possível selecionar outras opções para garantir que a grafia dos nomes dos objetos seja consistente com o banco de dados de origem ou de destino. Para mais informações, consulte Case sensitivity of object names in the destination instance.
Source Objects	Selecione um ou mais objetos na seção Source Objects. Clique no ícone e adicione os objetos à seção Selected Objects. Nota A granularidade para selecionar objetos de migração é schema, tabela e coluna. Se selecionar apenas tabelas ou colunas como objetos de migração, outros objetos, como visualizações, gatilhos e procedimentos armazenados, não serão migrados para o banco de dados de destino.
Selected Objects	Nenhuma configuração adicional é necessária para este exemplo. Use o recurso de mapeamento para definir o nome do tópico, o número de partições, a chave de partição e outras informações para a tabela de origem na instância Kafka de destino. Para mais informações, consulte Map information. Nota Se usar o recurso de mapeamento de nomes de objetos, outros objetos que dependem do objeto mapeado podem falhar ao serem migrados. Para selecionar operações SQL para migração incremental de dados, clique com o botão direito em um objeto na caixa Selected Objects e selecione as operações SQL desejadas na caixa de diálogo que aparece.

Clique em Next: Advanced Settings para configurar parâmetros avançados.

Parâmetro	Descrição
Dedicated Cluster for Task Scheduling	Por padrão, o DTS agenda tarefas em um cluster compartilhado. Não é necessário selecionar um. Se desejar tarefas mais estáveis, adquira um dedicated cluster para executar tarefas de migração do DTS.
Retry Time for Failed Connections	Após o início da tarefa de migração, se a conexão com o banco de dados de origem ou de destino falhar, o DTS relatará um erro e começará imediatamente a tentar reconectar. A duração padrão de nova tentativa é de 720 minutos. Personalize o tempo de nova tentativa para um valor de 10 a 1440 minutos. Recomendamos definir a duração para mais de 30 minutos. Se o DTS se reconectar aos bancos de dados de origem e de destino dentro da duração especificada, a tarefa de migração será retomada automaticamente. Caso contrário, a tarefa falhará. Nota Para várias instâncias do DTS que compartilham a mesma origem ou destino, o tempo de nova tentativa de rede é determinado pela configuração da última tarefa criada. Como há cobrança pela tarefa durante o período de nova tentativa de conexão, recomendamos personalizar o tempo de nova tentativa com base nas necessidades do seu negócio, ou liberar a instância do DTS o mais rápido possível após a liberação das instâncias de banco de dados de origem e de destino.
Retry Time for Other Issues	Após o início da tarefa de migração, se ocorrer um problema que não seja de conectividade, como uma exceção de execução DDL ou DML, no banco de dados de origem ou de destino, o DTS relatará um erro e começará imediatamente a tentar repetir a operação. A duração padrão de nova tentativa é de 10 minutos. Personalize o tempo de nova tentativa para um valor de 1 a 1440 minutos. Recomendamos definir a duração para mais de 10 minutos. Se as operações relacionadas forem bem-sucedidas dentro da duração de nova tentativa especificada, a tarefa de migração será retomada automaticamente. Caso contrário, a tarefa falhará. Importante O valor de Retry Time for Other Issues deve ser menor que o valor de Retry Time for Failed Connections.
Enable Throttling for Full Data Migration	Durante a migração completa, o DTS consome recursos de leitura e gravação nos bancos de dados de origem e de destino, o que pode aumentar a carga do banco de dados. Se necessário, ative o limitador para a tarefa de migração completa. Defina Queries per second (QPS) to the source database, RPS of Full Data Migration e Data migration speed for full migration (MB/s) para reduzir a carga no banco de dados de destino. Nota Este item de configuração está disponível apenas se selecionar Full Data Migration em Migration Types. Também é possível adjust the full migration speed após a instância de migração estar em execução.
Enable Throttling for Incremental Data Migration	Se necessário, opte por definir limites de velocidade para a tarefa de migração incremental. Defina RPS of Incremental Data Migration e Data migration speed for incremental migration (MB/s) para reduzir a carga no banco de dados de destino. Nota Este item de configuração está disponível apenas se selecionar Incremental Data Migration em Migration Types. Também é possível adjust the incremental migration speed após a instância de migração estar em execução.
Environment Tag	Selecione tags de ambiente para identificar a instância com base em suas necessidades. Nenhuma seleção é necessária para este exemplo.
Configure ETL	Primeiro, escolha se deseja ativar o recurso de extração, transformação e carga (ETL). Para mais informações, consulte What is ETL? Valores válidos: Yes: Ativa o recurso ETL. Aqui, insira instruções de processamento de dados no editor de código. Para mais informações, consulte Configure ETL in a data migration or data synchronization task. No: Desativa o recurso ETL.
Whether to delete SQL operations on heartbeat tables of forward and reverse tasks	Aqui, escolha se deseja gravar informações SQL de heartbeat no banco de dados de origem quando a instância do DTS estiver em execução. Yes: As informações SQL de heartbeat não são gravadas no banco de dados de origem. Isso pode fazer com que a instância do DTS relate um atraso. No: Grava informações SQL de heartbeat no banco de dados de origem. Isso pode interferir em recursos como backup físico e clonagem do banco de dados de origem.
Monitoring and Alerting	Defina alertas e receba notificações de alerta com base nas necessidades do seu negócio. No: Não define um alerta. Yes: Configure alertas definindo um alert threshold e um alert notifications. Se uma migração falhar ou a latência exceder o limiar, o sistema enviará uma notificação de alerta.

Por fim, salve a tarefa e execute uma pré-verificação.
- Para visualizar os parâmetros de configuração desta instância ao chamar a operação da API, passe o ponteiro sobre o botão Next: Save Task Settings and Precheck e clique em Preview OpenAPI parameters na dica que aparece.
- Se não precisar visualizar ou já tiver terminado de visualizar os parâmetros da API, clique em Next: Save Task Settings and Precheck na parte inferior da página.
Nota
- Antes do início da tarefa de migração, o DTS executa uma pré-verificação. A tarefa só é iniciada após ser aprovada na pré-verificação.
- Se a pré-verificação falhar, clique em View Details ao lado do item de verificação com falha, corrija o problema com base na instrução e, em seguida, execute a pré-verificação novamente.
- Se um aviso for relatado durante a pré-verificação:
  
  Para itens de verificação que não podem ser ignorados, clique em View Details ao lado do item com falha, corrija o problema com base na instrução e, em seguida, execute a pré-verificação novamente.
  
  Para itens de verificação que podem ser ignorados, clique em Confirm Alert Details, confirme os detalhes, Ignore, OK e Precheck Again para pular o item de alerta e executar a pré-verificação novamente. Se optar por ignorar um aviso, isso pode causar problemas como inconsistência de dados e apresentar riscos ao seu negócio.

Adquira a instância.

Quando a Success Rate for de 100%, clique em Next: Purchase Instance.

Na página Purchase, selecione a especificação do link para a instância de migração de dados. Para mais informações, consulte a tabela a seguir.

Categoria	Parâmetro	Descrição
New Instance Class	Resource Group Settings	Selecione o grupo de recursos ao qual a instância pertence. O valor padrão é o grupo de recursos padrão. Para mais informações, consulte What is resource management?
New Instance Class	Instance Class	O DTS fornece especificações de migração com diferentes níveis de desempenho. A especificação do link afeta a velocidade da migração. Selecione uma especificação com base no seu cenário de negócios. Para mais informações, consulte Data migration link specifications.

Após concluir a configuração, leia e selecione Data Transmission Service (Pay-as-you-go) Service Terms.
Clique em Buy and Start. Na caixa de diálogo OK que aparece, clique em OK.

Agora, visualize o progresso da tarefa de migração na página de lista Data Migration Tasks.
Nota
- Se a tarefa de migração não incluir migração incremental, ela será interrompida automaticamente após a conclusão da migração completa. Após a interrupção da tarefa, seu Status muda para Completed.
- Se a tarefa de migração incluir migração incremental, ela não será interrompida automaticamente. A tarefa de migração incremental continua em execução. Enquanto a tarefa de migração incremental estiver em execução, o Status da tarefa será Running.

Configurações de mapeamento

Na área Selected Objects, passe o mouse sobre o nome do tópico de destino.
Clique em Edit.

Na caixa de diálogo Edit Table, configure as definições de mapeamento.