Instalar componentes do SSMA no SQL Server (OracleToSQL)

Além de instalar o SSMA (Assistente de Migração do SQL Server), você também deve instalar componentes no computador que executa SQL Server. Esses componentes incluem o pacote de extensão SSMA, que dá suporte à migração de dados, e provedores Oracle para habilitar a conectividade servidor a servidor.

Pacote de extensões do SSMA para Oracle

O pacote de extensões SSMA implanta procedimentos armazenados estendidos e adiciona o sysdb banco de dados à instância especificada de SQL Server. Os procedimentos armazenados estendidos fornecem a funcionalidade necessária para emular recursos e comportamento do Oracle, enquanto o sysdb banco de dados contém as tabelas e os procedimentos armazenados necessários para migrar os dados.

Além disso, quando você migra dados para o SQL Server, o SSMA cria trabalhos do SQL Server Agent quando o mecanismo de migração de dados do lado do servidor é usado para migrar os dados.

Pré-requisitos

Antes de instalar os componentes do servidor SSMA para Oracle no SQL Server, verifique se o sistema atende aos seguintes requisitos:

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

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

• Uma instância de SQL Server é instalada.

• O provedor OLE DB para Oracle (se estiver usando o OLE DB) e a conectividade com o banco de dados Oracle que você deseja migrar. Você pode instalar provedores a partir da mídia de produtos da Oracle ou do site da Oracle.

  Importante

  Os procedimentos armazenados estendidos do pacote de extensão SSMA não são compatíveis com ordenações de servidor UTF-8 (por exemplo, Latin1_General_100_CI_AI_SC_UTF8). As funções geradas pelo SSMA declaram parâmetros de saída como varchar(max), que o driver ODBC interno mapeia para tipos LOB herdados. Em servidores que usam uma ordenação UTF-8, o banco de dados master também usa UTF-8, o que faz com que a chamada de loopback dos procedimentos armazenados estendidos tenha falha. Com o Driver ODBC 17, essa falha produz resultados silenciosamente incorretos. Com o Driver ODBC 18, você recebe o erro: Cannot convert to text/ntext or collate to 'Latin1_General_100_CI_AI_SC_UTF8'. Se o servidor usa uma ordenação UTF-8, não confie nos procedimentos armazenados estendidos do pacote de extensões do SSMA.

• O serviço SQL Server Browser deve estar em execução durante a instalação. O serviço preenche uma lista das instâncias de SQL Server no assistente de Instalação. Você pode desabilitar o serviço SQL Server Browser após a instalação.

  Se o serviço do SQL Server Browser estiver em execução, mas ainda assim não for exibida uma lista de instâncias na Instalação, a porta UDP 1434 deverá ser desbloqueada. Você pode usar o Firewall do Windows para desbloquear temporariamente a porta ou desabilitar temporariamente o Firewall do Windows. Talvez você também precise desabilitar temporariamente o software antivírus. Habilite firewalls e software antivírus após a instalação.

Instalar o pacote de extensão

Você pode instalar o pacote de extensão a qualquer momento antes de migrar dados para SQL Server.

Para instalar o pacote de extensão:

1. Copie SSMAforOracleExtensionPack_<n>.msi (onde <n> está o número de build) para o computador em execução SQL Server.

2. Clique duas vezes no MSI para executá-lo.

3. Na página Boas-vindas , selecione Avançar.

4. Na página Contrato de Licença de Usuário Final, leia o acordo de licença. Se você concordar, selecione Aceito o contrato e selecione Avançar.

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

6. Na página Pronto para Instalar, selecione Instalar.

7. Na página Concluir a Primeira Etapa de Instalação , selecione Avançar.

   Uma nova caixa de diálogo é exibida. Selecione o tipo de pacote de extensão.

8. Selecione o tipo de instalação desejado e selecione Avançar.

   Importante

   Use a opção remota apenas ao instalar o pacote de extensões no SQL Server em execução no Linux ou ao ter como destino a Instância Gerenciada de SQL do Azure. Sempre instale o pacote de extensão localmente para instalações SQL Server em execução no Windows. Banco de Dados SQL do Azure e Azure Synapse Analytics não dão suporte ao pacote de extensões.

   Se você instalar o pacote de extensão em uma instância de SQL Server local, poderá escolher uma instância local de SQL Server para a qual migrar esquemas Oracle. Escolha uma instância na lista suspensa e selecione Avançar.

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

9. Na página de conexão, selecione o método de autenticação e selecione Avançar.

   A Autenticação do Windows usa suas credenciais do Windows para tentar entrar na instância do SQL Server. Se você selecionar a Autenticação do Servidor, deverá inserir um nome de logon e uma senha do SQL Server.

10. A próxima etapa exige que você defina a senha para uma chave mestra que criptografa todos os dados confidenciais armazenados no banco de dados do pacote de extensão durante a migração de dados do lado do servidor. Forneça uma senha forte e selecione Avançar.

11. Na próxima página, selecione Instalar o Banco de Dados utilitários n e instalar bibliotecas do Pacote de Extensões, em que n é o número da versão e selecione Avançar.

    O sysdb banco de dados é criado com as tabelas e os procedimentos armazenados necessários para a migração de dados são criados neste banco de dados (usando o mecanismo de migração de dados do lado do servidor).

12. Quando a instalação for concluída, um prompt será exibido perguntando se você deseja instalar o Banco de Dados de Utilitários em outra instância do SQL Server. Selecione Sim e, em seguida, selecione Avançar. Para sair do assistente, selecione Não e, em seguida, selecione Sair.

13. No SQL Server Management Studio ou usando o sqlcmd utilitário, execute o seguinte script para habilitar o CLR:

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

    Se o CLR não estiver habilitado, você receberá o seguinte erro quando o SSMA se conectar ao SQL Server:

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

Objetos de banco de dados do SQL Server

Depois de instalar o pacote de extensão, a ssma_oracle.bcp_migration_packages tabela será exibida no sysdb banco de dados.

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

Os seguintes procedimentos armazenados estendidos são adicionados ao banco de dados master:

• xp_ora2ms_exec2
• xp_ora2ms_exec2_ex
• xp_ora2ms_versioninfo2

Conteúdo relacionado

• Instalar o SSMA para o cliente Oracle
• Migrar bancos de dados Oracle para SQL Server
• Suporte a ordenações e Unicode