Instalación de componentes de SSMA en SQL Server (OracleToSQL)

Además de instalar SQL Server Migration Assistant (SSMA), también debe instalar componentes en el equipo que ejecuta SQL Server. Estos componentes incluyen el paquete de extensiones SSMA, que admite la migración de datos y los proveedores de Oracle para habilitar la conectividad de servidor a servidor.

Paquete de extensiones de SSMA para Oracle

El paquete de extensiones SSMA implementa procedimientos almacenados extendidos y agrega la sysdb base de datos a la instancia especificada de SQL Server. Los procedimientos almacenados extendidos proporcionan funcionalidad necesaria para emular las características y el comportamiento de Oracle, mientras que la sysdb base de datos contiene las tablas y los procedimientos almacenados necesarios para migrar los datos.

Además, al migrar datos a SQL Server, SSMA crea trabajos del Agente SQL Server cuando se usa el motor de migración de datos del lado servidor para migrar los datos.

Prerrequisitos

Antes de instalar los componentes del servidor SSMA para Oracle en SQL Server, asegúrese de que el sistema cumple los siguientes requisitos:

• Windows 11 y versiones posteriores, o Windows Server 2022 y versiones posteriores.

• .NET Framework versión 4.7.2 o una versión posterior. Descargue .NET Framework.

• Se instala una instancia de SQL Server.

• Proveedor OLE DB para Oracle (si usa OLE DB) y conectividad a la base de datos de Oracle que desea migrar. Puede instalar proveedores desde medios de productos de Oracle o desde el sitio web de Oracle.

  Importante

  Los procedimientos almacenados extendidos del paquete de extensiones SSMA no son compatibles con intercalaciones de servidor UTF-8 (por ejemplo, Latin1_General_100_CI_AI_SC_UTF8). Las funciones generadas por SSMA declaran parámetros de salida como varchar(max), que el controlador ODBC interno se asigna a los tipos de LOB heredados. En los servidores que usan un cotejamiento UTF-8, la base de datos master también usa UTF-8, lo que provoca que falle la llamada de loopback desde los procedimientos almacenados extendidos. Con ODBC Driver 17, este fallo produce resultados incorrectos sin avisar. Con ODBC Driver 18, aparece el error: Cannot convert to text/ntext or collate to 'Latin1_General_100_CI_AI_SC_UTF8'. Si el servidor usa una intercalación UTF-8, no confíe en los procedimientos almacenados extendidos del paquete de extensiones SSMA.

• El servicio SQL Server Browser debe ejecutarse durante la instalación. El servicio rellena una lista de las instancias de SQL Server en el Asistente para instalación. Puede deshabilitar el servicio SQL Server Browser después de la instalación.

  Si el servicio SQL Server Browser se está ejecutando, pero todavía no ve una lista de instancias en el programa de instalación, debe desbloquear el puerto UDP 1434. Puedes usar Firewall de Windows para desbloquear temporalmente el puerto o deshabilitar temporalmente firewall de Windows. También es posible que tenga que deshabilitar temporalmente el software antivirus. Asegúrese de habilitar firewalls y software antivirus después de la instalación.

Instalar el paquete de extensión

Puede instalar el paquete de extensiones en cualquier momento antes de migrar datos a SQL Server.

Para instalar el paquete de extensiones:

1. Copie SSMAforOracleExtensionPack_<n>.msi (donde <n> es el número de compilación) en el equipo que ejecuta SQL Server.

2. Haga doble clic en msi para ejecutarlo.

3. En la página principal, seleccione Siguiente.

4. En la página Acuerdo de licencia de usuario final, lea el contrato de licencia. Si está de acuerdo, seleccione Acepto el contrato y, a continuación, seleccione Siguiente.

5. En la página Elegir tipo de instalación , seleccione Típico.

6. En la página Preparado para instalar , seleccione Instalar.

7. En la página Completado el primer paso de instalación , seleccione Siguiente.

   Aparece un cuadro de diálogo nuevo. Seleccione el tipo de paquete de extensión.

8. Seleccione el tipo de instalación deseado y, a continuación, seleccione Siguiente.

   Importante

   Use la opción remota solo al instalar el paquete de extensiones en SQL Server que se ejecute en Linux o cuando el destino sea Azure SQL Managed Instance. Instale siempre el paquete de extensiones localmente para las instalaciones de SQL Server que se ejecutan en Windows. Azure SQL Database y Azure Synapse Analytics no admiten el paquete de extensiones.

   Si instala el paquete de extensiones en una instancia de SQL Server local, puede elegir una instancia local de SQL Server a la que migre esquemas de Oracle. Elija una instancia en la lista desplegable y, a continuación, seleccione Siguiente.

   La instancia predeterminada tiene el mismo nombre que el equipo. Las instancias con nombre van seguidas de una barra diagonal inversa y el nombre de la instancia.

9. En la página de conexión, seleccione el método de autenticación y, a continuación, seleccione Siguiente.

   La autenticación de Windows usa las credenciales de Windows para intentar iniciar sesión en la instancia de SQL Server. Si selecciona Autenticación de servidor, debe escribir un nombre de inicio de sesión y una contraseña de SQL Server.

10. El siguiente paso requiere que establezca la contraseña de una clave maestra que cifre los datos confidenciales almacenados en la base de datos del paquete de extensiones durante la migración de datos del lado servidor. Proporcione una contraseña segura y seleccione Siguiente.

11. En la página siguiente, seleccione Instalar bibliotecas de Utilities Database n e Install Extension Pack, donde n es el número de versión y, a continuación, seleccione Siguiente.

    La sysdb base de datos se crea con las tablas y los procedimientos almacenados necesarios para la migración de datos se crean en esta base de datos (mediante el motor de migración de datos del lado servidor).

12. Una vez completada la instalación, aparece un mensaje que pregunta si desea instalar Utilities Database en otra instancia de SQL Server. Seleccione Sí y, a continuación, seleccione Siguiente. Para salir del asistente, seleccione No y, a continuación, seleccione Salir.

13. En SQL Server Management Studio o mediante la sqlcmd utilidad , ejecute el siguiente script para habilitar CLR:

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

    Si CLR no está habilitado, recibirá el siguiente error cuando SSMA se conecta a SQL Server:

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

Objetos de base de datos de SQL Server

Después de instalar el paquete de extensiones, la ssma_oracle.bcp_migration_packages tabla aparece en la sysdb base de datos.

Cada vez que migre datos a SQL Server, SSMA crea un trabajo de Agente de SQL Server. Estos trabajos se denominan ssma_oracle data migration package {GUID}y puede verlos en el nodo Agente SQL Server de SQL Server Management Studio en la carpeta Trabajos.

Los siguientes procedimientos almacenados extendidos se agregan a la master base de datos:

• xp_ora2ms_exec2
• xp_ora2ms_exec2_ex
• xp_ora2ms_versioninfo2

Contenido relacionado

• Instalación de SSMA para el cliente de Oracle
• Migración de bases de datos de Oracle a SQL Server
• Intercalación y compatibilidad con Unicode