Migración con un archivo DACPAC

Se aplica a: ✅ Almacén en Microsoft Fabric

Fabric Migration Assistant es una experiencia de migración que puede usar para copiar grupos de SQL dedicados en Azure Synapse Analytics, bases de datos de SQL Server y bases de datos de otras plataformas del motor de base de datos de SQL sin problemas en Fabric Data Warehouse.

En esta guía se describen los pasos para migrar desde un grupo de SQL dedicado de Azure Synapse Analytics al almacenamiento de Fabric mediante un archivo DACPAC.

Prerrequisitos

Antes de comenzar, asegúrese de que tiene listos los siguientes elementos:

• 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.
• Archivo DACPAC extraído del grupo de SQL dedicado de Azure Synapse Analytics. Un archivo de DACPAC (paquete de aplicación de capa de datos) se compila a partir de proyectos de base de datos SQL y contiene los metadatos de los objetos de base de datos, incluido el esquema de tablas, las vistas, los procedimientos almacenados, las funciones, etc.
  • Para crear una DAC en Visual Studio 2022 con SQL Server Data Tools, consulte la sección sobre cómo extraer una aplicación de capa de datos (DAC) de un grupo de SQL dedicado de Azure Synapse en Visual Studio 2022.
  • También puede usar proyectos de base de datos de estilo SDK con VS Code o la utilidad de línea de comandos SqlPackage.

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 el inquilino o la capacidad están fuera de Ee. UU. o Francia, Copilot está deshabilitado de forma predeterminada, a menos que el administrador de inquilinos de Fabric permita que los datos enviados a Azure OpenAI se puedan procesar fuera de la región geográfica de la capacidad, los límites de cumplimiento o la configuración del inquilino de la instancia de nube nacional en el portal de administración de Fabric.
• 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ú Migrar al origen de Fabric , en Migrar a un almacenamiento, seleccione el icono del sistema de origen.

   • Si va a migrar desde un grupo de SQL dedicado de Azure Synapse Analytics, seleccione el icono grupo de SQL dedicado de Azure Synapse Analytics .
   • Si va a migrar desde cualquier otra base de datos T-SQL, como una base de datos en SQL Server, Azure SQL Database o Instancia administrada de Azure SQL, seleccione el icono base de datos de SQL Server .

   

3. En la página Elegir el método , seleccione Cargar un archivo con los metadatos de origen y seleccione Siguiente.

4. Seleccione Elegir archivo y cargue el archivo de DACPAC del almacenamiento de datos de origen. Cuando finalice la carga, seleccione Siguiente.

   

5. En la página Establecer el destino , escriba el nombre del nuevo área de trabajo de Fabric y el nuevo elemento de almacenamiento al que desea migrar. Seleccione Siguiente.

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

   

   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.

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

   

8. 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 realizados en el portal en los objetos .

9. Seleccione cualquier objeto para ver los ajustes realizados por Migration Assistant durante la migración.

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

    

11. Opcionalmente, seleccione el menú Exportar para descargar un resumen de migración como un archivo de Excel o un CSV.

    • El archivo de Excel descargado es un libro totalmente estructurado con dos hojas de cálculo: Objetos migrados y objetos para corregir. Es compatible con MIP y se alinea con las etiquetas de confidencialidad de su organización.
    • El CSV es ligero y fácil de usar.

    

    Cada archivo exportado proporciona una vista estructurada y completa de los resultados de la migración, entre las que se incluyen:

    Nombre del campo	Descripción	Valores de ejemplo
    Nombre de objeto	Nombre del objeto SQL
    Tipo de objeto	Tipos de objeto SQL	Tabla, vista, procedimiento almacenado, función
    Estado	Estado de traducción	Ajustado: Se aplican actualizaciones compatibles con Fabric Data Warehouse No ajustado: no hay ningún cambio en el script original
    Detalles	Lista de ajustes aplicados o mensajes de error
    Tipo de error	Tipo de error de traducción	Mensaje de traducción, Error de traducción, Error al aplicar la traducción

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 pudo traducir los metadatos de T-SQL a los que se admiten en un almacenamiento de Fabric o el código traducido no se pudo aplicar a T-SQL.

Corrija estos scripts mediante 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.

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. Seleccione el botón Usar un trabajo de copia.

3. Escriba un nombre para el nuevo trabajo y, a continuación, seleccione Crear.

4. En la página Conectar al origen de datos, escriba las credenciales de conexión del grupo SQL dedicado de Azure Synapse Analytics (SQL DW) de origen. 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.

   

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.

   • Por ejemplo, en los grupos de SQL dedicados de Azure Synapse Analytics, puede encontrar información de sesión, incluida la aplicación de origen, quién está conectada, desde dónde procede la conexión y si usa la autenticación de Microsoft Entra o SQL:

   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
• Actualización de las canalizaciones de Azure Data Factory a Fabric