Migrar con conexión directa al sistema fuente

Esto se aplica a:✅ Almacén en Microsoft Fabric

El Fabric Migration Assistant para Data Warehouse es una herramienta de migración para copiar sin problemas grupos de SQL dedicados de Azure Synapse Analytics, SQL Server y otras plataformas de bases de datos SQL a Microsoft Fabric Data Warehouse.

En esta guía se describen los pasos para migrar a un almacén de Fabric desde un grupo de SQL dedicado de Azure Synapse Analytics o una base de datos de SQL Server mediante la conexión al sistema de origen.

Prerrequisitos

Antes de comenzar, asegúrese de que dispone de lo siguiente:

  • Un área de trabajo de Fabric con una capacidad activa o una capacidad de prueba.
  • Cree un área de trabajo o seleccione un área de trabajo existente a la que quiera migrar. El Asistente de Migración crea un nuevo almacén para ti.
  • Recopila la información de conexión de tu sistema de origen, incluyendo el nombre del servidor, el nombre de la base de datos y el método de autenticación.

Para usar las características de migración asistida por IA de Migration Assistant para corregir problemas de migración, debe activar Copilot:

Copiar metadatos

  1. En tu espacio de trabajo de Fabric, selecciona el botón Migrar en el menú de acciones del elemento.

    Recorte de pantalla del botón Migrar del portal de Fabric en la presentación de acciones del elemento.

  2. En el menú Migrar al origen de Fabric , en Migrar a un almacenamiento, seleccione el icono del sistema de origen. Para Azure Synapse Analytics, selecciona Azure Synapse Analytics dedicated SQL pool. Para SQL Server, Azure SQL Database o Azure SQL Managed Instance, selecciona Base de datos de SQL Server.

    Captura de pantalla del portal Fabric de las casillas del sistema de origen.

  3. En la página Elige tu método , selecciona Conectar directamente al sistema de origen y luego selecciona Siguiente.

    Captura de pantalla del portal Fabric del método de entrada para migrar y conectarse al sistema de origen.

  4. En Establecer el código-fuente, proporciona el nombre del servidor, el nombre de la base de datos y los detalles de autenticación, y luego selecciona Siguiente.

  5. En la página Elegir objetos para migrar , selecciona objetos para migrar.

    Captura de pantalla del portal de Fabric, mostrando el paso de selección de objetos.

  6. En la página Establecer el destino, selecciona el espacio de trabajo Fabric, introduce un nombre para el nuevo almacén y luego selecciona Siguiente.

  7. Revise las entradas y seleccione Migrar. El Migration Assistant crea un nuevo artículo de almacén y comienza la migración de metadatos.

    Nota:

    Cuando se usa Migration Assistant, el nuevo almacén tiene intercalación que no distingue mayúsculas de minúsculas, independientemente de la configuración de intercalación de almacenamiento predeterminada.

    Captura de pantalla del portal Fabric de la página de Reseñas del Migration Assistant. La fuente es tu base de datos y el Destino es un nuevo elemento de almacén llamado AdventureWorks.

    Durante este paso, Migration Assistant traduce los metadatos de T-SQL a la sintaxis de T-SQL admitida en Fabric Data Warehouse. Cuando termina la migración de metadatos, se abre el Migration Assistant. Puede acceder al Asistente de Migración en cualquier momento mediante el botón Migración de la pestaña Inicio de la cinta de opciones del almacén.

  8. Revise el resumen de la migración de metadatos en Migration Assistant. Verá el recuento de objetos migrados y los objetos que deben corregirse para poder migrarlos.

    Captura de pantalla del resumen de migración de metadatos de Migration Assistant en el portal de Fabric. La opción Mostrar objetos migrados está resaltada.

  9. Selecciona Mostrar objetos migrados para ampliar la sección y ver una lista de objetos que el Migration Assistant ha migrado con éxito a tu almacén de Fabric.

    Captura de pantalla del resumen de migración de metadatos de Migration Assistant y la lista de objetos migrados en el portal de Fabric.

    La columna Estado indica si los metadatos del objeto fueron ajustados durante la traducción para ser soportados en Fabric Data Warehouse. Por ejemplo, es posible que vea que determinados tipos de datos de columna o construcciones de lenguaje T-SQL se convierten automáticamente en los que se admiten en Fabric. La columna Detalles muestra la información sobre los ajustes realizados en los objetos.

  10. Seleccione cualquier objeto para ver los ajustes realizados durante la migración.

  11. Abra el resumen de migración de metadatos en la vista de pantalla completa para mejorar la legibilidad. Aplicar filtros para ver tipos de objetos específicos.

    Captura de pantalla de la vista completa del resumen de migración de metadatos de Migration Assistant de los objetos migrados.

Corrección de problemas mediante Migration Assistant

Es posible que algunos metadatos del objeto de base de datos no se migren. Normalmente, este error se produce porque Migration Assistant no puede traducir los metadatos de T-SQL a los que se admiten en un almacenamiento de Fabric o el código traducido no se puede aplicar a T-SQL.

Vamos a corregir estos scripts con ayuda de Migration Assistant.

  1. Seleccione el paso Solucionar problemas en Migration Assistant para ver los scripts que no se pudieron migrar.

    Recorte de pantalla de la lista Solucionar problemas de Migration Assistant en el portal de Fabric.

  2. Seleccione un objeto de base de datos que no se ha podido migrar. Se abre una nueva consulta en Consultas compartidas en Explorer. Esta nueva consulta muestra la definición de metadatos y los ajustes realizados por Migration Assistant como comentarios automáticos agregados al código T-SQL.

  3. Revise los comentarios al principio del script para ver los ajustes realizados por migration Assistant en el script.

  4. Revise y corrija los scripts rotos mediante la información de error y la documentación.

  5. Para usar Copilot para la asistencia con tecnología de IA para corregir los errores, seleccione Corregir errores de consulta en la sección Acción sugerida. Copilot actualiza el script con sugerencias. Pueden ocurrir errores ya que Copilot usa IA, por lo que debe comprobar las sugerencias de código y realizar los ajustes que necesite.

    Captura de pantalla del portal de Fabric del editor de consultas que muestra las consultas de T-SQL que no se pudieron migrar y los comentarios y correcciones sugeridos por Copilot.

  6. Seleccione Ejecutar para validar y crear el objeto.

  7. Se abre el siguiente script que se va a corregir.

  8. Continúe para corregir el resto de los scripts. Puede optar por omitir la corrección de scripts que no necesite durante este paso.

  9. Cuando todos los metadatos deseados estén listos para la migración, seleccione el botón Atrás en el panel Corregir problemas para devolver la vista de nivel superior de Migration Assistant. Compruebe el 2. Corrija los problemas en el paso del Asistente de Migración.

Consigue más objetos para migrar

Utiliza la migración incremental para añadir o actualizar objetos en un almacén de Fabric existente. Proporciona una nueva entrada de origen, selecciona solo los objetos que necesitas y elige cómo manejar los objetos que ya existen en el destino. Por ejemplo, migre un grupo de esquemas, valide el resultado y luego vuelva más tarde para migrar más objetos o definiciones actualizadas.

  1. Inicia la migración incremental desde cualquiera de las siguientes ubicaciones:

    • Abre el almacén, selecciona la pestaña Migración en la cinta y luego selecciona Obtener más objetos.

      Captura de pantalla de

    • En el resumen de migración, expande Copiar metadatos y luego selecciona Obtener más objetos.

      Captura de pantalla de Más objetos en la página Copiar metadatos completada.

  2. Selecciona la fuente, elige un método de entrada y continúa con el paso Elige más objetos para migrar .

    Captura de pantalla de la página Elegir más objetos para migrar del Migration Assistant.

  3. En Elegir más objetos para migrar, selecciona los objetos a migrar:

    • Utiliza el filtro para ver todos los objetos fuente, objetos con conflictos de nombres o objetos sin conflictos de nombre.

      Captura de pantalla del filtro de conflicto de nombres en la página Elegir más objetos para migrar.

    • Los objetos cuyos nombres ya existen en el almacén muestran un icono de advertencia. Si seleccionas uno de estos objetos, resuelves el conflicto de nombres más adelante en la migración.

      Captura de pantalla del icono de advertencia y la descripción emergente de un objeto cuyo nombre ya existe en el almacén.

    • Por defecto, Migration Assistant incluye dependencias directas cuando seleccionas un objeto. Selecciona el nombre de un objeto para ver sus dependencias directas en el panel derecho.

      Captura de pantalla de las dependencias directas de un objeto seleccionado.

    • Si un objeto en el archivo de entrada no tiene nombre de esquema, Migration Assistant asigna el objeto al esquema por defectodbo.

  4. En Revisar, verifica el origen, el destino y el resumen de migración de objetos.

    Captura de pantalla del resumen de la migración de origen, destino y objetos en la página Revisar.

  5. Seleccione Migrar. Migration Assistant traduce los objetos seleccionados y crea objetos que no tienen conflictos de nombre. Los objetos con conflictos de nombres permanecen pendientes hasta que resuelves cada conflicto.

Resolver conflictos y arreglar objetos

Cuando actualizas un almacén existente mediante migración incremental, la resolución de conflictos te permite elegir qué definición de objeto conservar.

  1. En el resumen de Migration Assistant, revisa el recuento de Conflictos para resolver. Expandir 2. Resuelve conflictos y corrige objetos.

    Captura de pantalla del recuento de conflictos para resolver y del paso de resolver conflictos y arreglar objetos.

  2. En la pestaña Conflictos , revisa los objetos que tienen conflictos de nombre.

    Captura de pantalla de los objetos en la pestaña de Conflictos.

  3. Selecciona un objeto para comparar sus definiciones SQL. La definición existente aparece a la izquierda, y la definición traducida entrante aparece a la derecha.

    Captura de pantalla que compara las definiciones SQL existentes y nuevas de un objeto.

  4. Elige una de las siguientes acciones para el objeto:

    • Mantener existente: Conserva la definición de objeto existente y descarta la definición traducida que llega.
    • Conservar entrante: Sustituye la definición existente del objeto por la definición traducida entrante. Cuando se le solicite, confirme la acción.
    • Renombrar incoming: Crea el objeto entrante con un nombre diferente y conserva el objeto existente.

    Captura de pantalla de las acciones Conservar entrante, Conservar existente y Cambiar nombre entrante para un objeto.

    Si seleccionas Cambiar nombre al entrante, introduce el esquema y el nombre del objeto, y luego selecciona Renombrar.

    Captura de pantalla del diálogo de Renombrar objeto migrado.

  5. Opcional: Edita el guion entrante antes de quedártelo. Para descartar tus ediciones y restaurar el guion traducido, selecciona Restablecer entrante.

    Captura de pantalla de Reset incoming encima de una definición SQL entrante editada.

  6. Para aplicar la definición entrante, selecciona Conservar la entrante (sobrescribir existente). Si has editado el script entrante, selecciona Sobrescribir existente en su lugar.

    Warning

    Para una tabla, Conservar entrante elimina y vuelve a crear la tabla existente. Si la tabla contiene datos, esta acción provoca la pérdida de datos y debes cargar los datos de nuevo. Si Migration Assistant no puede aplicar el script entrante, restaura la definición anterior del objeto, pero no recupera los datos eliminados.

    En el caso de una tabla, selecciona Reemplazar tabla para confirmar la acción.

    Captura de pantalla del diálogo de confirmación para reemplazar una tabla existente.

  7. Cuando el script se ejecuta correctamente, Migration Assistant marca el conflicto como resuelto.

    Captura de pantalla que muestra que el conflicto de un objeto está resuelto.

  8. Repite estos pasos para cada objeto con un conflicto de nombre. Para aplicar la misma acción a varios objetos, selecciona los objetos y luego selecciona Mantener lo existente o Mantener lo entrante.

    Captura de pantalla de las acciones masivas de Conservar entrantes y Mantener existentes.

  9. Confirma que cada objeto procesado correctamente está marcado como resuelto. Si un objeto necesita más cambios, revisa la información en el panel derecho.

Copia de datos mediante Migration Assistant

Copiar datos le ayuda a migrar los datos usados por los objetos que migra. Puede usar un trabajo de copia de Fabric Data Factory para hacerlo manualmente o seguir estos pasos para la integración del trabajo de copia en Migration Assistant.

  1. Seleccione el paso Copiar datos en Migration Assistant.

  2. Selecciona Usar una tarea de copia.

  3. Asigne un nombre al nuevo trabajo y seleccione Crear.

  4. En la página Conectar a la fuente de datos , proporciona las credenciales de Conexión para la fuente. Seleccione Siguiente.

  5. En la página Elegir datos, seleccione las tablas que desea migrar. Los metadatos del objeto ya deben existir en el almacenamiento de destino. Seleccione Siguiente.

    Captura de pantalla del portal Fabric del panel Elegir datos, con algunas tablas seleccionadas.

  6. En la página Elegir destino de datos, elija el nuevo elemento de almacenamiento de Fabric en el catálogo de OneLake. Seleccione Siguiente.

  7. En la página Asignar al destino, configure las asignaciones de columnas de cada tabla. Seleccione Siguiente.

  8. En la página Modo de trabajo de copia, elija el modo de copia. Elija una única copia de datos completa (recomendada para la migración) o una copia incremental continua. Seleccione Siguiente.

  9. Revise el resumen del trabajo. Seleccione Guardar + Ejecutar.

  10. Cuando finalice el trabajo de copia, compruebe el Paso 3: Copiar datos en el Asistente de Migración. Selecciona el botón de retroceso para volver a la vista superior del Migration Assistant.

Volver a enrutar las conexiones

En el paso final, vuelva a conectar las plataformas de carga y de informes de datos para que sus conexiones apunten a su nuevo almacén de Fabric.

  1. Identifique las conexiones en el almacén de origen existente.

    • En una base de datos SQL en cualquier instancia de Microsoft SQL, puedes usar vistas de gestión dinámica, por ejemplo:
    SELECT 
        s.program_name
    , s.login_name
    , c.client_net_address
    FROM sys.dm_exec_sessions AS s 
    INNER JOIN sys.dm_exec_connections AS c 
    ON s.session_id = c.session_id
    WHERE s.session_id >= 50 --retrieve only user spids
    and s.session_id <> @@SPID; --ignore myself
    
    • En los pools SQL dedicados de Azure Synapse Analytics, puedes encontrar información de sesión, incluyendo la aplicación fuente, el usuario conectado, el origen de la conexión y el método de autenticación:
    SELECT DISTINCT CASE 
             WHEN len(tt) = 0
                 THEN app_name
             ELSE tt
             END AS application_name
         ,login_name
         ,ip_address
    FROM (
         SELECT DISTINCT app_name
             ,substring(client_id, 0, CHARINDEX(':', ISNULL(client_id, '0.0.0.0:123'))) AS ip_address
             ,login_name
             ,isnull(substring(app_name, 0, CHARINDEX('-', ISNULL(app_name, '-'))), 'h') AS tt
         FROM sys.dm_pdw_exec_sessions
         ) AS a;
    
  2. Actualice las conexiones a las plataformas de informes para que apunten al almacén de Fabric.

  3. Pruebe el almacenamiento de Fabric con algunos informes antes de volver a enrutar. Realice pruebas de comparación y validación de datos en las plataformas de informes.

  4. Actualice las conexiones de las plataformas de carga de datos (ETL/ELT) para que apunten directamente al almacén de datos de Fabric.

    • Para pipelines de Power BI/Fabric:
      • Utilice la API REST List Connections para buscar conexiones a su antiguo origen de datos, la piscina SQL dedicada de Azure Synapse Analytics.
      • Actualiza las conexiones al nuevo Fabric Data Warehouse usando la experiencia de Gestionar conexiones y pasarelas en el equipo de Configuración.
  5. Cuando esté terminado, comprueba el paso de Redirigir conexiones en el Migration Assistant.

¡Felicidades! Ya está listo para empezar a usar el almacén.

Captura de pantalla de Fabric Portal Migration Assistant en la que se muestran los cuatro pasos de trabajo completados y un elemento emergente de felicitaciones.