Control de código fuente del almacén (versión preliminar)

En este artículo se explica cómo funcionan las canalizaciones de integración e implementación de Git para almacenes en Microsoft Fabric. Obtenga información sobre cómo configurar una conexión al repositorio, administrar los almacenes e implementarlos en distintos entornos. El control de código fuente para Fabric Warehouse es actualmente una característica en versión preliminar.

Puede usar Integración de Git y Canalizaciones de implementación para escenarios diferentes:

• Use proyectos de Base de datos Git y SQL para administrar el cambio incremental, la colaboración en equipo, el historial de confirmaciones en objetos de base de datos individuales.
• Use canalizaciones de implementación para promover cambios de código en diferentes entornos de preproducción y producción.

Integración de Git

La integración de Git en Microsoft Fabric permite a los desarrolladores integrar sus procesos de desarrollo, herramientas y procedimientos recomendados directamente en la plataforma Fabric. Permite a los desarrolladores que desarrollan en Fabric:

• Hacer copias de seguridad y versiones de su trabajo
• Revertir a las fases anteriores según sea necesario
• Colaborar con otros usuarios o trabajar solos con ramas de Git
• Utilizar las funcionalidades de las herramientas de control de código fuente conocidas para administrar elementos de Fabric

Para obtener más información sobre el proceso de integración de Git, consulte:

• Integración de Git de Fabric
• Conceptos básicos en la integración de Git
• Introducción a la integración de Git (versión preliminar)

Configuración de una conexión al control de código fuente

Desde la página Configuración del área de trabajo, puede configurar fácilmente una conexión al repositorio para confirmar y sincronizar los cambios.

1. Para configurar la conexión, consulte Introducción a la integración de Git. Siga las instrucciones para Conectarse a un repositorio de Git a Azure DevOps o GitHub como proveedor de Git.
2. Una vez conectados, los elementos, incluidos los almacenes, aparecen en el panel Control de código fuente.
3. Después de conectar correctamente las instancias de almacenamiento al repositorio de Git, verá la estructura de carpetas de almacenamiento en el repositorio. Ahora puede ejecutar operaciones futuras, como crear una solicitud de incorporación de cambios.

Proyectos de base de datos para un almacenamiento en Git

La imagen siguiente es un ejemplo de la estructura de archivos de cada elemento de almacenamiento del repositorio:

Al confirmar el elemento de almacenamiento en el repositorio de Git, el almacenamiento se convierte en un formato de código fuente, como un proyecto de base de datos SQL. Un proyecto SQL es una representación local de objetos SQL que contiene el esquema de una base de datos única, como tablas, procedimientos almacenados o funciones. La estructura de carpetas de los objetos de base de datos se organiza mediante Tipo de esquema o objeto. Cada objeto del almacenamiento se representa con un archivo .sql que contiene su definición de lenguaje de definición de datos (DDL). Los datos de tabla de almacenamiento y las Características de seguridad de SQL no se incluyen en el proyecto de la base de datos SQL.

Las consultas compartidas también se confirman en el repositorio y heredan el nombre que se guardan como.

Descarga del proyecto de base de datos SQL de un almacenamiento en Fabric

Con la Extensión SQL Database Projects disponible dentro de Azure Data Studio y Visual Studio Code, puede administrar un esquema de almacenamiento y controlar los cambios de objetos de almacenamiento como otros proyectos de base de datos SQL.

Para descargar una copia local del esquema del almacenamiento, seleccione Descargar proyecto de base de datos SQL en la cinta de opciones.

Copia local de un proyecto de base de datos que contiene la definición del esquema de almacenamiento. El proyecto de base de datos se puede usar para:

• Vuelva a crear el esquema de almacenamiento en otro almacén.
• Desarrolle aún más el esquema de almacenamiento en herramientas de cliente, como Azure Data Studio o Visual Studio Code.

Publicación del proyecto de base de datos SQL en un nuevo almacenamiento

Para publicar el esquema de almacenamiento en un nuevo almacén:

1. Cree un almacén en el área de trabajo de Fabric.
2. En la página de inicio del nuevo almacenamiento, en Compilar un almacén, seleccione Proyecto de base de datos SQL.
3. Seleccione el archivo .zip que se descargó del almacén existente.
4. El esquema de almacenamiento se publica en el nuevo almacén.

Canalizaciones de implementación

También puede usar canalizaciones de implementación para implementar el código de almacenamiento en distintos entornos, como desarrollo, prueba y producción. Las canalizaciones de implementación no exponen un proyecto de base de datos.

Siga estos pasos para completar la implementación del almacenamiento mediante la canalización de implementación.

1. Cree una nueva canalización de implementación o abra una canalización de implementación existente. Para obtener más información, consulte Introducción a las canalizaciones de implementación.
2. Asigne áreas de trabajo a distintas fases según los objetivos de implementación.
3. Seleccione, vea y compare elementos, incluidos los almacenes entre distintas fases, como se muestra en el ejemplo siguiente.
4. Seleccione Implementar para implementar los almacenes en las fases de Desarrollo, Prueba, y fases de Producción.

Para obtener más información sobre el proceso de canalizaciones de implementación de Fabric, consulte Introducción a las canalizaciones de implementación de Fabric.

Limitaciones en el control de código fuente

• Las características de Seguridad de SQL deben exportarse o migrarse mediante un enfoque basado en scripts. Considere la posibilidad de usar un script posterior a la implementación en un proyecto de base de datos SQL, que puede configurar abriendo el proyecto con laExtensión SQL Database Projects disponible dentro de Azure Data Studio.

Limitaciones de la integración de Git

• Actualmente, si usa ALTER TABLE para agregar una restricción o una columna en el proyecto de base de datos, la tabla se quitará y se volverá a crear al implementar, lo que provocará la pérdida de datos. Tenga en cuenta la siguiente solución alternativa para conservar la definición y los datos de la tabla:
  • Cree una nueva copia de la tabla en el almacenamiento mediante CREATE TABLE y INSERT, CREATE TABLE AS SELECT, o Clonar tabla.
  • Modifique la nueva definición de tabla con nuevas restricciones o columnas, según sea necesario, mediante ALTER TABLE.
  • Elimine la tabla anterior.
  • Cambie el nombre de la nueva tabla al nombre de la tabla anterior mediante sp_rename.
  • Modifique la definición de la tabla antigua en el proyecto de base de datos SQL de coincidencia exacta de la misma manera. El proyecto de base de datos SQL del almacenamiento en el control de código fuente y el almacenamiento activo ahora deben coincidir.
• Actualmente, no cree una instancia de Dataflow Gen2 con un destino de salida al almacenamiento. Confirmar y actualizar desde Git sería bloqueado por un nuevo elemento denominado DataflowsStagingWarehouse que aparece en el repositorio.
• El punto de conexión de análisis SQL no se admite con la integración de Git.

Limitaciones de las canalizaciones de implementación

• Actualmente, si usa ALTER TABLE para agregar una restricción o una columna en el proyecto de base de datos, la tabla se quitará y se volverá a crear al implementar, lo que provocará la pérdida de datos.
• Actualmente, no cree una instancia de Dataflow Gen2 con un destino de salida al almacenamiento. La implementación se bloquearía mediante un nuevo elemento denominado DataflowsStagingWarehouse que aparece en la canalización de implementación.
• El punto de conexión de análisis SQL no se admite en canalizaciones de implementación.

Contenido relacionado

• Introducción a la integración de Git (versión preliminar)
• Conceptos básicos en la integración de Git
• ¿Qué es la administración del ciclo de vida en Microsoft Fabric?
• Tutorial: Configuración de dbt para el almacén de datos de Fabric