Instalar os componentes do SSMA no SQL Server (OracleToSQL)

Artigo
09/06/2023

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

Pacote de extensão do SSMA para Oracle

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

Além disso, na migração de dados para o SQL Server, o SSMA criará trabalhos do SQL Server Agent quando o mecanismo de migração de dados do lado do servidor for usado para migrar os dados.

Pré-requisitos

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

Instância do SQL Server instalada.
Microsoft Windows Installer 3.1 ou uma versão posterior.
Microsoft .NET Framework versão 4.7.2 ou uma versão posterior. Você pode obtê-lo no .NET Framework Developer Center.
Provedor OLE DB para Oracle (se estiver usando OLE DB) e conectividade com o banco de dados do Oracle que deseja migrar. Os provedores podem ser instalados a partir da mídia do produto Oracle ou do site da Oracle.
O serviço do SQL Server Browser deve estar em execução durante a instalação. Ele é usado para preencher uma lista das instâncias do SQL Server no assistente de instalação. Você pode desabilitar o serviço do SQL Server Browser após a instalação.

Nota

Se o serviço do SQL Server Browser estiver em execução e ainda assim não for exibida uma lista de instâncias em Configuração, deverá a porta UDP 1434 deverá ser desbloqueada. Você pode usar o firewall do Windows para desbloquear temporariamente a porta ou pode desabilitar o firewall temporariamente. Talvez seja necessário desabilitar temporariamente qualquer software antivírus que possa estar em execução. Certifique-se de ativar os firewalls e o software antivírus após a instalação.

Instalar o pacote de extensão

O pacote de extensão pode ser instalado em qualquer momento antes da migração de dados para o SQL Server.

Importante

Para instalar o pacote de extensão, é necessário ser membro da função de servidor sysadmin na instância do SQL Server.

Para instalar o pacote de extensão:

Copie SSMAforOracleExtensionPack_n.msi (em que n é o número de build) para o computador que estiver executando o SQL Server.
Clique duas vezes em SSMAforOracleExtensionPack_n.msi.
Na página de Boas-vindas, clique em Avançar.
Na página Contrato de Licença de Usuário Final, leia o contrato de licença. Se você aceitar o contrato de licença, selecione a opção Aceito o contrato de licença e clique em Avançar.
Na página Escolher o Tipo de Configuração, selecione Típica.
Na página Pronto para Instalar, selecione Instalar.
Na página Instalação Concluída, clique em Concluir.

Uma nova caixa de diálogo será exibida. Selecione o tipo de pacote de extensão.
Selecione o tipo de instalação desejado e e clique em Avançar.

Importante

A opção remota só deve ser usada na instalação do pacote de extensão no SQL Server em execução no Linux ou no direcionamento para a Instância Gerenciada de SQL do Azure. O pacote de extensão sempre dever ser instalado localmente nas instalações do SQL Server em execução no Windows. O Banco de Dados SQL do Azure e o Azure Synapse Analytics não são compatíveis com o pacote de extensão.

Caso esteja instalando o pacote de extensão em uma instância local do SQL Server, a página seguinte permitirá que você escolha uma instância local do SQL Server para a qual migrará os esquemas do Oracle. Escolha uma instância na lista suspensa e selecione Avançar.

A instância padrão tem o mesmo nome do computador. As instâncias nomeadas serão seguidas por uma barra invertida e o nome da instância.
Na página de conexão, selecione o método de autenticação e em seguida selecione Avançar.

A Autenticação do Windows usará suas credenciais do Windows para tentar entrar na instância do SQL Server. Se você selecionar a Autenticação do Servidor, deverá inserir nome e senha de login do SQL Server.
A próxima etapa requer a definição da senha de uma chave mestra que será usada para criptografar quaisquer 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 clique em Avançar.
Na próxima página, selecione Instalar Banco de Dados de Utilitárion e Instalar Bibliotecas de Pacotes de Extensão, sendo n o número de versão, e clique em Avançar.

O banco de dadossysdb será criado com as tabelas. Os procedimentos armazenados necessários para a migração de dados (usando o mecanismo de migração de dados do lado do servidor) serão criados nesse banco de dados.
Quando a instalação for concluída, será exibido um prompt 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, Sair.
No SQL Server Management Studio ou usando o utilitário sqlcmd, execute o seguinte script para habilitar o CLR:
```
sp_configure 'clr enabled', 1
GO
RECONFIGURE
GO
```
Se o CLR não for habilitado, será exibido o seguinte erro quando o SSMA se conectar ao SQL Server:

O SSMA não pôde recuperar as informações de versão do assembly do pacote de extensão. Reinstale o pacote de extensão no servidor de banco de dados.

Objetos de banco de dados do SQL Server

Depois de instalar o pacote de extensão, será exibida uma tabelassma_oracle.bcp_migration_packages no banco de dados sysdb.

Toda vez que forem migrados dados para o SQL Server, o SSMA criará um trabalho do SQL Server Agent. Esses trabalhos serão nomeados como ssma_oracle data migration package {GUID} e ficarão visíveis nó do SQL Server Agent do SQL Server Management Studio, na pasta Trabalhos.

Além disso, os seguintes procedimentos armazenados estendidos serão adicionados ao banco de dados mestre:

xp_ora2ms_exec2
xp_ora2ms_exec2_ex
xp_ora2ms_versioninfo2

Confira também

Como instalar o SSMA para um cliente Oracle
Migrar bancos de dados do Oracle para o SQL Server

Partilhar via