Compartilhar via


Trabalhando com projetos SSMA (MySQLToSQL)

Para migrar bancos de dados MySQL para SQL Server ou Azure SQL, primeiro você deve criar um projeto do SQL Server Migration Assistant (SSMA). O projeto é um arquivo que contém as seguintes informações:

  • Metadados sobre os bancos de dados MySQL que você deseja migrar para o SQL Server ou o SQL do Azure.

  • Metadados sobre a instância de destino do SQL Server ou do SQL do Azure que recebem os objetos e dados migrados.

  • Informações de conexão SQL Server ou Azure SQL.

  • Configurações do projeto.

Quando você abre um projeto, ele é desconectado do MySQL e do SQL Server ou do SQL do Azure. Isso permite que você trabalhe offline. Para obter mais informações sobre como se reconectar ao SQL Server, consulte Conectar-se ao SQL Server

Examinar as configurações de projeto padrão

O SSMA contém várias configurações para converter e carregar banco de dados, migrar dados e sincronizar o SSMA com o MySQL e o SQL Server ou o SQL do Azure. As configurações padrão são apropriadas para muitos usuários. No entanto, antes de criar um novo projeto SSMA, você deve examinar as configurações. Se necessário, você pode alterar as configurações padrão para todos os seus novos projetos.

  1. Selecione Configurações de Projeto Padrão no menu Ferramentas .

  2. Selecione o tipo de projeto na lista suspensa Versão de Destino de Migração para o qual as configurações devem ser exibidas/alteradas e, em seguida, selecione a guia Geral.

  3. No painel esquerdo, selecione Conversão.

  4. No painel direito, examine e altere as configurações conforme necessário. Para obter mais informações sobre essas configurações, consulte Configurações do Projeto (Conversão).

  5. Repita as etapas 1 a 3 para as páginas Migração, Sincronização, SQL do Azure, GUI e Mapeamento de Tipos.

Observação

As configurações do SQL do Azure são exibidas somente quando você seleciona a Migração para o SQL do Azure durante a criação de um projeto.

Criar novos projetos

Para migrar dados de bancos de dados MySQL para SQL Server ou SQL do Azure, você deve criar um projeto.

  1. Selecione Novo Projeto no menu Arquivo . A caixa de diálogo Novo Projeto é exibida. No menu Arquivo, selecione Novo Projeto. A caixa de diálogo Novo Projeto é exibida.

  2. Na caixa Nome , insira um nome para o projeto.

  3. Na caixa Localização , insira ou selecione uma pasta para o projeto.

  4. Na lista suspensa Migração para, selecione a versão do SQL Server de destino que será usada para a migração. As opções disponíveis são:

    • SQL Server 2016 (13.x)
    • SQL Server 2017 (14.x)
    • SQL Server 2019 (15.x)
    • SQL Server 2022 (16.x)
    • SQL Server 2025 (17.x)
    • Banco de Dados SQL do Azure
    • Instância Gerenciada de SQL do Azure

E, em seguida, selecione OK.

O SSMA cria o arquivo de projeto.

Personalizar as configurações do projeto

Além de definir as configurações de projeto padrão que se aplicam a todos os novos projetos do SSMA, você também pode personalizar as configurações de cada projeto. Para obter mais informações, consulte Como definir opções de projeto.

Ao personalizar mapeamentos de tipo de dados entre os bancos de dados de origem e de destino, você pode definir mapeamentos no nível do projeto, do banco de dados ou do objeto. Para obter mais informações, consulte Mapeamento de tipos de dados do MySQL e do SQL Server.

Salvar projetos

O recurso Salvar Projetos permite que o usuário salve essencialmente as configurações do projeto e, opcionalmente, os metadados do banco de dados no arquivo de projeto do SSMA.

  1. No menu Arquivo , selecione Salvar Projeto.

    Se os bancos de dados dentro do projeto tiverem sido alterados ou não tiverem sido convertidos, o SSMA solicitará que você carregue e salve metadados. Carregar e salvar metadados permite que você trabalhe offline. Ele também permite que você envie um arquivo de projeto completo para outras pessoas, como a equipe de suporte técnico. Se for solicitado que você salve metadados, faça o seguinte:

  2. Para cada banco de dados que mostra um status de Metadados ausentes, marque a caixa de seleção ao lado do nome do banco de dados. Salvar metadados pode levar vários minutos. Se você não quiser salvar metadados neste momento, não marque nenhuma caixa de seleção.

  3. Clique em Salvar.

O SSMA analisa os esquemas do MySQL e salva os metadados no arquivo de projeto.

Abrir projetos

Quando você abre um projeto, ele é desconectado do MySQL e do SQL Server ou do SQL do Azure. Isso permite que você trabalhe offline. Para atualizar metadados, carregue objetos de banco de dados no SQL Server ou no SQL do Azure. Para migrar dados, você deve se reconectar ao SQL Server ou ao SQL do Azure.

  1. Utilize um dos seguintes procedimentos:

    1. No menu Arquivo , aponte para Projetos Recentes.

    2. Selecione o projeto que você deseja abrir.

    3. No menu Arquivo, selecione Abrir Projeto, localize o arquivo de .m2ssproj projeto, selecione o arquivo e, em seguida, selecione Abrir.

  2. Para se reconectar ao MySQL, no menu Arquivo , selecione Reconectar ao MySQL.

  3. Para se reconectar ao SQL Server, no menu Arquivo , selecione Reconectar ao SQL Server.

  4. Para se reconectar ao SQL do Azure, no menu Arquivo , selecione Reconectar ao SQL do Azure.