Integración de Git para el desarrollo de almacén de Fabric

Se aplica a: ✅ Almacén en Microsoft Fabric

Este artículo explica las ventajas de desarrollar y desplegar Fabric Data Warehouse con la integración integrada de Git de Fabric.

Al utilizar la integración de Git en Fabric, los equipos pueden aplicar prácticas modernas de control de versiones al desarrollo de almacén. Los desarrolladores pueden aislar cambios en ramas, seguir la evolución del esquema mediante commits, colaborar mediante pull requests y sincronizar actualizaciones entre repositorios Git y espacios de trabajo de Fabric.

Entre los escenarios típicos se incluyen:

• Desarrollo de cambios de esquema de forma segura en ramas y espacios de trabajo
• Versionado de objetos de almacén en Git
• Colaborar entre múltiples ramas y espacios de trabajo
• Promoción de cambios validados entre sucursales
• Mantener los elementos del espacio de trabajo (almacén y otros) alineados con la fuente de verdad de Git

Para mantener la consistencia, trazabilidad y fiabilidad a lo largo de los ciclos de vida del desarrollo del almacén, necesitas entender estos flujos de trabajo.

Cuando conectas un espacio de trabajo Fabric Data Warehouse a Git, haces commit de definiciones de almacén como proyecto de base de datos. Este proyecto se convierte en la representación autorizada del esquema del almacén en el control de versiones y sirve como base para las actividades de desarrollo continuas. En el explorador de control de versiones, el esquema aparece como archivos individuales .sql .

Utilizando Fabric integración Git y Fabric Data Warehouse, puedes:

• Desarrolla Fabric Data Warehouse con integración Git.
• Despliega Fabric Data Warehouse usando pipelines de despliegue.
• Despliega y despliega continuamente utilizando el portal Fabric, Git, tu propio IDE o entorno local de desarrollo, pipelines de despliegue Fabric o sistemas externos de integración continua/despliegue continuo (CI/CD), incluyendo pipelines en Azure DevOps Services o GitHub.

Comparación

Durante este proceso de sincronización, Fabric utiliza despliegue de esquema incremental basado en DacFx para aplicar cambios. Este enfoque aplica solo las diferencias de esquema relevantes al almacén, en lugar de actualizar toda la definición del almacén.

La extracción incremental ayuda a reducir la pérdida innecesaria de cambios en el control de versiones, mantener diferencias de esquema más limpias entre ramas y apoyar flujos de trabajo eficientes de ramificación y fusión. Dado que el proceso de extracción es consciente del esquema, también permite una comparación y validación fiable entre el estado del espacio de trabajo y las definiciones rastreadas por Git.

Estandarizar cómo se extraen y almacenan los esquemas de almacén mejora la consistencia entre entornos de desarrollo. Las definiciones de esquemas permanecen estables entre ramas, las diferencias reflejan con mayor precisión los cambios intencionados en el desarrollo, y el control de versiones se convierte en una base fiable para el despliegue, la colaboración y la gestión del ciclo de vida.

El XMLA.json archivo en sí se excluye durante los flujos de trabajo de integración de Git. Fabric excluye este archivo de los commits y actualizaciones para que los metadatos semánticos model por defecto no se almacenen accidentalmente en Git. Al sincronizar un espacio de trabajo desde Git, se XMLA.json ignora, lo que ayuda a evitar conflictos, sobrescrituras no intencionadas y ruido durante el cambio de saltos o actualizaciones desde Git.

Limitaciones en el control de código fuente

Las funciones de seguridad de SQL, como los permisos, requieren un enfoque separado de exportación y migración.

• Actualmente, las dependencias entre conceptos entre almacenes y endpoints de analítica SQL no están soportadas en los flujos de trabajo de desarrollo. Como resultado, los escenarios que dependen de cambios coordinados entre estos elementos pueden no funcionar de forma fiable.

• Actualmente, los commits selectivos a nivel de almacén no están soportados. Los cambios se comprometen a nivel de elemento del almacén en lugar de a niveles más finos y granulares de objetos.

• El soporte para control de versiones para endpoints de analítica SQL no está disponible actualmente. Esta limitación puede limitar la gestión del ciclo de vida de extremo a extremo cuando las soluciones abarcan tanto almacenes como endpoints de análisis SQL.

Limitaciones de la integración de Git

• Cuando dos o más elementos de almacén se referencian entre sí, forman una dependencia cíclica. El sistema detecta esta referencia circular durante operaciones de ramificación o sincronización de Git-to-workspace, causando que estas operaciones fallen. Evita dependencias cíclicas entre elementos.
• Actualmente, no cree un flujo de datos Gen2 con un destino de salida al almacenamiento. Un nuevo elemento denominado DataflowsStagingWarehouse aparece en el repositorio y bloquea la confirmación y actualización desde Git.
• Las dependencias entre elementos, la secuenciación de elementos y las brechas de sincronización entre el punto de acceso de análisis de SQL y el almacén de datos afectan a los flujos de trabajo de "ramificación a un área de trabajo nueva o existente" y "cambiar a una rama diferente" durante el desarrollo y la integración continua.
• Si un objeto hace referencia a otro objeto en el mismo almacén usando nombres de tres partes (database.schema.object), el commit o actualización desde Git puede fallar. Para más información y una solución alternativa, consulta Referencias a los propios objetos del almacén usando un nombre de tres partes.
• Si cambias una columna que ha IDENTITY sido definida, hacer commit o actualizar desde Git puede fallar hasta que IDENTITY_INSERT esté habilitada para la tabla.
• Si el repositorio contiene un .sqlproj archivo que pina una versión antigua Microsoft.Build.Sql del SDK, el commit o actualización desde Git puede fallar porque el SDK antiguo no reconoce la sintaxis del almacén más reciente, como IDENTITY columnas y CLUSTER BY. Para más información y una solución alternativa, consulta .sqlproj desactualizado en el repositorio Git.
• Si un objeto hace referencia a dos o más tablas en otro almacén sin calificar para alias en cada columna, el commit o actualización desde Git puede fallar. Para más información y una solución alternativa, véase Columnas no calificadas en objetos que hacen referencia a dos o más tablas en otro almacén.
• Si tus scripts hacen referencia a dos o más objetos diferentes en el mismo esquema de otro almacén y deletrean el nombre del esquema con mayúsculas inconsistentes, el commit o actualización desde Git puede fallar. Para más información y una solución alternativa, véase Capitalización inconsistente de nombres de esquemas.
• Errores ambiguos en columnas cuya lista de candidatos contiene un :: separador pueden ocurrir al hacer commit o actualizar desde Git, incluso cuando no hay ambigüedad genuina. Para más información y soluciones alternativas, véase Errores ambiguos en columna con objetos candidatos duplicados.

Escenarios no soportados

Los siguientes procesos de flujo de trabajo de CI/CD no se admiten oficialmente cuando los almacenes de datos en distintos espacios de trabajo tienen intercalaciones diferentes. Aunque estas operaciones se realicen correctamente sin errores, pueden producir errores de metadatos.

En todos estos escenarios, si se produce un error de coincidencia de intercalación, use el script Python scripts/dw-collation-error-update-tmsl/pbi_interactive.py en el repositorio de GitHub del cuadro de herramientas de Fabric para actualizar la intercalación del conjunto de datos (TMSL) de manera que coincida con la intercalación del almacén.

Paso siguiente

Contenido relacionado

• Comience con la integración de Git
• Solución de problemas con la integración de Git para el desarrollo de Fabric warehouse