Migra subiendo un archivo con la Fabric Migration Assistant

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

El Fabric Migration Assistant ofrece una experiencia guiada para migrar metadatos y datos de origen a Fabric Data Warehouse. Esta guía explica cómo migrar metadatos de:

• Azure Synapse Analytics o SQL Server mediante un archivo DACPAC
• Teradata mediante un archivo .zip con archivos .sql y/o .bteq

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.
• Un archivo de metadatos fuente en uno de estos formatos:
  • Un archivo DACPAC extraído de Azure Synapse Analytics o SQL Server. Un DACPAC contiene metadatos para objetos de base de datos, incluyendo tablas, vistas, procedimientos almacenados y funciones.
    • Para crear un DACPAC desde Azure Synapse Analytics, consulta Extraer una aplicación Data-tier (DAC) de un pool SQL dedicado de Azure Synapse en Visual Studio 2022.
    • También puedes usar el Asistente de Generar Scripts en SQL Server Management Studio (SSMS),proyectos de bases de datos estilo SDK con Visual Studio Code, o la utilidad de línea de comandos SqlPackage.
  • Un archivo ZIP de archivos .sql y/o .bteq de Teradata que contiene las definiciones de objetos y las dependencias para la migración.

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

• El administrador debe habilitar el interruptor de inquilino antes de comenzar a utilizar Copilot. Para obtener más información, consulte Configuración de inquilinos de Copilot.
• La capacidad de F2 o P1 debe estar en una de las regiones que se enumeran en Disponibilidad de la región de Fabric.
• Si su tenant o capacidad están fuera de Estados Unidos o Francia, Copilot está deshabilitado de forma predeterminada, a menos que el administrador del tenant de Fabric habilite la configuración del tenant Los datos enviados a Azure OpenAI pueden procesarse fuera de la región geográfica, el límite de cumplimiento o la instancia de nube nacional de su capacidad en Catálogo de OneLake>>>Configuración del tenant.
• Copilot en Microsoft Fabric no se admite en las SKU de la evaluación gratuita. En este momento solo se admiten SKU de pago (F2 o superior, o P1 o superior).
• Para obtener más información, consulte Introducción a Copilot en Fabric y Power BI.

Copiar metadatos

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

   

2. En el menú de origen Migrar a Fabric, debajo de Migrar a un almacén, selecciona el mosaico 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.
   • Para Teradata, selecciona Teradata (Vista previa).

   

3. Si aparece la página Elegir tu método , selecciona Subir un archivo con los metadatos de origen y luego selecciona Siguiente.

   

4. En Establecer el código fuente, selecciona Elegir archivo, selecciona el archivo fuente y luego selecciona Siguiente.

   

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

   

6. En la página de Establecer el destino, proporciona el nombre del espacio de trabajo de Fabric y el nuevo elemento del almacén al que quieres migrar. Seleccione Siguiente.

7. Revise las entradas y seleccione Migrar. Migration Assistant crea un nuevo elemento de almacenamiento e inicia la migración de metadatos.

   Nota:

   Cuando se usa el Asistente de Migración, el nuevo almacén de datos tiene una intercalación insensible a mayúsculas, independientemente de la configuración de intercalación predeterminada del almacén.

   

   Durante este paso, Migration Assistant traduce los metadatos de T-SQL a la sintaxis de T-SQL admitida en Fabric Data Warehouse. Una vez finalizada la migración de metadatos, se abre 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.

   

9. Seleccione Mostrar objetos migrados para expandir la sección y ver una lista de objetos que ha migrado correctamente al almacenamiento de Fabric.

   

   La columna Estado indica si migration Assistant ajusta los metadatos del objeto durante la traducción a 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 que el Migration Assistant realizó en los objetos.

10. Seleccione cualquier objeto para ver los ajustes realizados por Migration Assistant 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.

    

Corrección de problemas mediante Migration Assistant

Es posible que algunos metadatos del objeto de base de datos no se migren. Normalmente, este fallo ocurre porque el Migration Assistant no pudo traducir los metadatos de T-SQL a los soportados en Fabric Data Warehouse o el código traducido no se aplicó 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.

   

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 en ella, como comentarios automáticos agregados al código T-SQL.

3. Revise los comentarios al principio del script para ver los ajustes realizados 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.

   

6. Seleccione Ejecutar para validar y crear el objeto.

7. Se abre el siguiente script para 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 nuevos datos de origen, selecciona solo los objetos que necesitas y elige cómo manejar los objetos que ya existen en el destino. Por ejemplo, migrar un grupo de esquemas, validar el resultado y luego volver 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 de opciones y luego selecciona Obtener más objetos.

     

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

     

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

   

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.

     

   • 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.

     

   • 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.

     

   • 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.

   

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. Expanda 2. Resuelva conflictos y arregle objetos.

   

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

   

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.

   

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 la 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.

   

   Si seleccionas Cambiar nombre de entrada, introduce el esquema y el nombre del objeto, y luego selecciona Renombrar.

   

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

   

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

   Warning

   Para una tabla, Conservar la 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 perdidos.

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

   

7. Cuando el script se ejecuta correctamente, Migration Assistant marca el conflicto como 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 Conservar existente o Conservar entrante.

   

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 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 de Conectar a la fuente de datos , proporciona las credenciales de conexión para tu sistema fuente. Seleccione Siguiente.

5. En la página Elegir datos , selecciona las tablas que quieres migrar. Seleccione Siguiente.

   

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. Seleccione el botón de retroceso en la parte superior para volver a la vista de nivel superior del Asistente de migración.

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 instancia de SQL Server, puede usar vistas de administració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:
     1. Utilice la API REST List Connections para buscar conexiones a su antiguo origen de datos, la piscina SQL dedicada de Azure Synapse Analytics.
     2. Actualice las conexiones al nuevo almacenamiento mediante la página Administrar conexiones y puertas de enlace en Configuración.

5. Cuando termine, compruebe el paso Volver a enrutar las conexiones en Migration Assistant.

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

Contenido relacionado

• Asistente de Migración de Fabric para Almacén de Datos
• Introducción a la migración de Microsoft Fabric