Instalar componentes SSMA no SQL Server (OracleToSQL)

Para além de instalar o Assistente de Migração do SQL Server (SSMA), deve também instalar componentes no computador que executa o SQL Server. Estes componentes incluem o pacote de extensões SSMA, que suporta migração de dados, e provedores Oracle para permitir a conectividade servidor para servidor.

SSMA para pacote de extensão Oracle

O pacote de extensões SSMA implementa procedimentos armazenados estendidos e adiciona a base de sysdb dados à instância especificada do SQL Server. Os procedimentos armazenados estendidos fornecem funcionalidades necessárias para emular funcionalidades e comportamentos do Oracle, enquanto a base de sysdb dados contém as tabelas e procedimentos armazenados necessários para migrar os dados.

Além disso, quando migra dados para o SQL Server, o SSMA cria tarefas do SQL Server Agent quando é utilizado o motor de migração de dados do lado do servidor para migrar os dados.

Pré-requisitos

Antes de instalar o SSMA para componentes de servidor Oracle no SQL Server, certifique-se de que o sistema cumpre os seguintes requisitos:

• Windows 11 e versões posteriores, ou Windows Server 2022 e versões posteriores.

• O .NET Framework versão 4.7.2 ou uma versão posterior. Descarregue o .NET Framework.

• Está instalada uma instância do SQL Server.

• O fornecedor OLE DB para Oracle (se estiver a usar OLE DB), e a conectividade à base de dados Oracle que pretende migrar. Pode instalar fornecedores a partir da mídia do produto Oracle ou do site Web da Oracle.

  Importante

  Os procedimentos armazenados estendidos do pacote de extensão SSMA não são compatíveis com colações de servidores UTF-8 (por exemplo, Latin1_General_100_CI_AI_SC_UTF8). As funções geradas pelo SSMA declaram os parâmetros de saída como varchar(max), que o controlador ODBC interno mapeia para tipos LOB legados. Em servidores que utilizam uma colação UTF-8, a master base de dados também utiliza UTF-8, o que faz com que a chamada de loopback dos procedimentos armazenados estendidos falhe. Com o Driver ODBC 17, esta falha produz resultados silenciosamente incorretos. Com o Driver ODBC 18, recebe o erro: Cannot convert to text/ntext or collate to 'Latin1_General_100_CI_AI_SC_UTF8'. Se o teu servidor usar uma colação UTF-8, não confies nos procedimentos armazenados estendidos do pacote de extensões SSMA.

• O serviço SQL Server Browser deve estar a correr durante a instalação. O serviço preenche uma lista das instâncias do SQL Server no assistente de Configuração. Pode desativar o serviço de navegador SQL Server após a instalação.

  Se o serviço SQL Server Browser estiver a funcionar, mas ainda não vê uma lista de instâncias na Configuração, deve desbloquear a porta UDP 1434. Podes usar o Windows Firewall para desbloquear temporariamente a porta, ou podes desativar temporariamente o Windows Firewall. Também pode ter de desativar temporariamente o software antivírus. Certifique-se de ativar firewalls e antivírus após a instalação.

Instale o pacote de extensão

Pode instalar o pacote de extensões a qualquer momento antes de migrar dados para o SQL Server.

Para instalar o pacote de extensões:

1. Copiar SSMAforOracleExtensionPack_<n>.msi (onde <n> está o número da compilação) para o computador a correr o SQL Server.

2. Clique duas vezes no MSI para o executar.

3. Na página Bem-vindo , selecione Avançar.

4. Na Página do Contrato de Licença do Utilizador Final, leia o contrato de licença. Se concordar, selecione Aceito o contratoe, em seguida, selecione Seguinte.

5. Na página Escolher Tipo de Configuração, selecione Típico.

6. Na página Pronto para Instalar, clique em Instalar.

7. Na página Completar o Primeiro Passo da Instalação , selecione Próximo.

   Aparece uma nova caixa de diálogo. Selecione o tipo de pacote de extensão.

8. Selecione o tipo de instalação desejado e depois selecione Próximo.

   Importante

   Utilize a opção remota apenas ao instalar o pacote de extensões no SQL Server em execução no Linux ou quando o destino for o Azure SQL Managed Instance. Instala sempre o pacote de extensões localmente para instalações do SQL Server a correr no Windows. Base de Dados SQL do Azure e Azure Synapse Analytics não suportam o pacote de extensões.

   Se instalar o pacote de extensões numa instância local do SQL Server, pode escolher uma instância local do SQL Server para a qual migrar os esquemas da Oracle. Escolha uma instância na lista pendente e, em seguida, selecione Seguinte.

   A instância padrão tem o mesmo nome do computador. As instâncias nomeadas são seguidas por uma barra diagonal e o nome da instância.

9. Na página da ligação, selecione o método de autenticação e depois selecione Próximo.

   A autenticação do Windows utiliza as suas credenciais do Windows para tentar iniciar sessão na instância do SQL Server. Se selecionar Autenticação do Servidor, deve inserir um nome de login e palavra-passe do SQL Server.

10. O passo seguinte exige que defina a palavra-passe de uma chave mestra que encripte quaisquer dados sensíveis armazenados na base de dados do pacote de extensões durante a migração de dados do lado do servidor. Forneça uma palavra-passe forte e selecione Próximo.

11. Na página seguinte, selecione Install Utilities Database n e Install Extension Pack libraries, onde n é o número da versão, e depois selecione Próximo.

    A sysdb base de dados é criada com as tabelas, e os procedimentos armazenados necessários para a migração de dados são criados nesta base de dados (usando o motor de migração de dados do lado do servidor).

12. Quando a instalação está concluída, aparece um aviso a perguntar se quer instalar a Utilities Database noutra instância do SQL Server. Selecione Sim, e depois selecione Próximo. Para sair do assistente, selecione Não e depois selecione Sair.

13. No SQL Server Management Studio ou usando a sqlcmd utilidade, execute o seguinte script para ativar o CLR:

    EXECUTE sp_configure 'clr enabled', 1;
    GO
    
    RECONFIGURE;
    GO
    

    Se o CLR não estiver ativado, recebe o seguinte erro quando o SSMA se liga ao SQL Server:

    SSMA could not retrieve the extension pack assembly version information. Reinstall the extension pack on the database server.
    

Objetos de base de dados SQL Server

Depois de instalar o pacote de extensões, a ssma_oracle.bcp_migration_packages tabela aparece na sysdb base de dados.

Sempre que migra dados para o SQL Server, o SSMA cria uma tarefa do SQL Server Agent. Estes trabalhos são chamados ssma_oracle data migration package {GUID}, e pode vê-los no nó SQL Server Agent do SQL Server Management Studio, na pasta Jobs.

Os seguintes procedimentos armazenados alargados são adicionados à base de dados master:

• xp_ora2ms_exec2
• xp_ora2ms_exec2_ex
• xp_ora2ms_versioninfo2

Conteúdo relacionado

• Instalar SSMA para o cliente Oracle
• Migrar Bases de Dados Oracle para SQL Server
• Suporte para ordenação e Unicode