Este documento descreve como usar a ferramenta de migração do Spanner (SMT, na sigla em inglês) para migrar seu esquema do MySQL para o Spanner. O SMT pode ler seu esquema do MySQL e convertê-lo para o esquema do Spanner, remover índices duplicados e oferecer sugestões de otimização de esquema.
Antes de começar
Verifique se você instalou e configurou o SMT. Para mais informações, consulte Configurar a ferramenta de migração do Spanner.
Configurar esquema
Depois de conectar o banco de dados de origem e o Spanner com o SMT, a ferramenta lê o esquema do MySQL e o converte para o esquema do Spanner. A ferramenta não converte procedimentos armazenados ou gatilhos.
Para conferir um relatório sobre a conversão do esquema, acesse a página Configurar esquema na UI da Web e clique em Ver avaliação.
Esse relatório fornece uma avaliação geral da conversão de esquema, além de informações detalhadas sobre a conversão no nível da tabela e da coluna, sugestões e avisos, e lista os elementos do esquema que não puderam ser convertidos.
Modificar esquema
Na página Configurar esquema, é possível conferir o esquema do banco de dados MySQL de origem e o rascunho do esquema do Spanner. Você também pode modificar o esquema convertido para atender aos requisitos da sua organização.
É possível selecionar tabelas ou índices, além de visualizar e gerenciar o esquema deles.
Tabelas
Selecione uma tabela que você quer modificar na guia Rascunho do Spanner na UI da Web. É possível soltar ou restaurar tabelas nessa guia. Para cada tabela selecionada, é possível conferir a seguinte lista de guias:
- Colunas
- Chave primária
- Chave externa
- Verificar restrições
- SQL
Coluna
A guia Coluna fornece informações sobre as colunas na tabela selecionada. É possível editar as colunas das seguintes maneiras:
- Modificar o nome de uma coluna
- Excluir uma coluna
- Mudar o tipo de dados da coluna
- Adicionar IDs gerados automaticamente
- Modificar o valor padrão
- Modificar a propriedade nula
Além de editar as colunas atuais no rascunho do Spanner, você também pode adicionar novas colunas à tabela selecionada.
Chave primária
É possível ver e editar a chave primária da tabela na guia Chave primária das seguintes maneiras:
- Adicionar ou remover uma coluna de uma chave primária
- Mudar a ordem das colunas em uma chave primária
Também é possível usar colunas geradas automaticamente para chaves primárias. Você pode escolher uma das seguintes opções para criar colunas geradas automaticamente.
- Função UUID:
gera um UUID v4 como parte da expressão
defaultda chave primária da tabela. - Função de reversão de bits: mapeia chaves de números inteiros atuais como uma sequência invertida de bits.
Chave externa
É possível ver e editar a chave externa da tabela na guia Chave estrangeira das seguintes maneiras:
- Mudar o nome da restrição chave externa
- Remova a chave externa se quiser usar uma tabela intercalada.
- Converter uma tabela intercalada de volta para uma chave externa
Verificar restrições
É possível ver e editar as restrições de verificação da tabela usando a guia Restrições de verificação das seguintes maneiras:
- Mudar o nome ou a condição da restrição de verificação
- Remover a restrição de verificação
SQL
É possível conferir a linguagem de definição de dados do Spanner no dialeto GoogleSQL na guia SQL.
Índices
Selecione um índice que você quer modificar na guia Rascunho do Spanner na UI da Web. É possível editar o índice das seguintes maneiras:
- Remover ou restaurar o índice
- Adicionar um índice secundário
- Confira a DDL do Spanner na guia SQL.
Preparar a migração
Depois de configurar o esquema, baixe-o como um arquivo de texto e use a DDL para criar o esquema na instância de destino do Spanner.
Para fazer o download do esquema, acesse a página Preparar migração na UI da Web e faça o seguinte:
- No menu suspenso Modo de migração, selecione Esquema.
- Clique em Download para baixar a DDL do esquema como um arquivo de texto.