Actualizar la versión de archivo del sistema de un almacén en un espacio de trabajo integrado de Git en Fabric

Se aplica a: ✅ Almacén en Microsoft Fabric

Este artículo describe cómo actualizar los elementos del almacén a la última versión de archivo del sistema en un espacio de trabajo integrado de Git con Fabric.

Importante

Esta característica se encuentra en versión preliminar.

Microsoft Fabric actualiza periódicamente la definición subyacente de los tipos de artículos, incluido el almacén. Cuando esta definición cambia, el config.version valor en el archivo del .platform elemento se desplaza, por ejemplo, de 1.0 a 2.0. Para evitar romper los cambios existentes en tu almacén, Fabric no aplica esta actualización automáticamente. En su lugar, Fabric muestra un aviso de disponibilidad de actualización del sistema en el control de versiones y te permite elegir cuándo aplicar la actualización para un tipo específico de artículo, como almacén.

Captura de pantalla del portal Fabric del banner de actualización disponible del sistema en el panel de control de versiones.

Prerequisites

Identifica que hay una actualización de archivo del sistema disponible

El config.version valor y la $schema URL contienen la versión actual del archivo del sistema para un almacén.

  1. Ve a tu espacio de trabajo conectado a Git y selecciona Control de versiones.

  2. Si hay una actualización del sistema disponible para el tipo de artículo del almacén, Fabric muestra un banner de actualización disponible del sistema en la parte superior del panel de control de versiones.

    También puedes confirmar la versión actual del archivo del sistema para un almacén inspeccionando la config.version propiedad en el archivo del .platform artículo en tu repositorio Git. Por ejemplo, el siguiente .platform archivo para un almacén llamado dw muestra una versión de archivo de sistema de 2.0:

    {
        "$schema": "https://developer.microsoft.com/json-schemas/fabric/gitIntegration/platformProperties/2.0.0/schema.json",
        "metadata": {
            "type": "Warehouse",
            "displayName": "dw"
        },
        "config": {
            "version": "2.0",
            "logicalId": "5e477a9e-0e1a-bf9b-4eb8-33420d62f352"
        }
    }
    

Para más información sobre el .platform archivo, consulte Archivos del sistema generados automáticamente.

Confirma los cambios existentes antes de aplicar actualizaciones de archivos del sistema

Antes de seleccionar Aplicar actualizaciones del sistema, compromete cualquier cambio pendiente en tu espacio de trabajo.

Si aplicas actualizaciones del sistema y haces commit de tus propios cambios en el almacén, se vuelve más difícil separar los dos conjuntos de cambios más adelante. Si haces primero el commit de tus cambios existentes, la actualización del archivo del sistema aparece como un commit aislado propio. Esta separación facilita revisar y, si es necesario, revertir la actualización del sistema sin afectar tus propios cambios.

  1. Ve a Control de versiones en el espacio de trabajo de Fabric.
  2. Revisa los cambios pendientes en la lista de Cambios .
  3. Selecciona los elementos que quieres comprometer, añade un mensaje de commit y confirma los cambios en el repositorio Git.

Para más información sobre cómo hacer commit de cambios, consulta Hacer cambios y actualizar el almacén de commits en Git.

Aplicar actualizaciones del sistema

Después de hacer la confirmación de tus cambios existentes, aplica la actualización del sistema.

  1. En control de versiones, selecciona Aplicar actualizaciones del sistema.

    Captura de pantalla del portal de Fabric mostrando la notificación de progreso de Aplicar actualizaciones del sistema.

  2. Fabric aplica la actualización del sistema a cada almacén de ese tipo de artículo en el espacio de trabajo. Si tienes varios almacenes, todos se actualizan al mismo tiempo. No puedes seleccionar almacenes individuales para actualizar.

  3. Espera a que se complete la notificación de Solicitud de actualizaciones del sistema .

Revisa y confirma la actualización del sistema

Cuando termine de aplicarse la actualización del sistema, revisa las diferencias antes de comprometerlas.

  1. En control de versiones, ve a la lista de Cambios. Cada almacén actualizado aparece como un cambio pendiente.

  2. Selecciona un almacén y luego selecciona Revisar y hacer commit de cambios para comparar la última definición de artículo con tu versión actual. Puedes comparar el .sqlproj archivo y otros archivos del sistema para ver exactamente qué ha cambiado, como una versión actualizada Sdk .

    Captura de pantalla del portal de Fabric de la revisión y confirma el diálogo de cambios comparando la versión actual del espacio de trabajo con la última versión sincronizada.

  3. Después de confirmar que los cambios son esperados, selecciona los elementos del almacén, añade un mensaje de commit y selecciona Commit para confirmar la actualización del sistema en el repositorio Git.

Si tienes varios almacenes en el espacio de trabajo, todos muestran la misma actualización del sistema. Revisa y compromete cada almacén de la misma manera, ya sea individualmente o en conjunto, para asegurarte de que cada almacén se actualiza a la última versión.

Historial de actualizaciones del sistema de almacén

Para un historial y las notas de versión del archivo del sistema, consulte Notas de versión para Fabric Data Warehouse archivo del sistema.