Conceptos básicos en la integración de Git

En este artículo se explican los conceptos básicos de Git y el proceso de integración de Git con el área de trabajo de Microsoft Fabric.

Importante

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

Permisos

• Para usar la integración de Git, el administrador de la organización debe habilitarla.
• Si el área de trabajo y el repositorio están en dos regiones diferentes, el administrador de inquilinos debe habilitar la exportación entre regiones. Para obtener más información, consulte Usuarios pueden exportar elementos a repositorios de Git en otras ubicaciones geográficas.
• Las acciones que puede realizar en un área de trabajo dependen de los permisos que tenga tanto en el área de trabajo como en Azure DevOps.

Permisos de Azure DevOps

En la lista siguiente se muestra lo que pueden hacer los distintos roles de área de trabajo en función de sus permisos de Azure DevOps:

• Administración: puede realizar cualquier operación en el área de trabajo, limitado solo por su rol de Azure DevOps.
• Miembro o colaborador: una vez conectado a un área de trabajo, un miembro o colaborador puede confirmar y actualizar los cambios, en función de su rol de Azure DevOps. Para las acciones relacionadas con la conexión del área de trabajo (por ejemplo, conectar, desconectar o cambiar ramas), busque ayuda de un Administrador.
• Visor: no puede realizar ninguna acción. El visor no puede ver ninguna información relacionada con Git en el área de trabajo.

Permisos necesarios para las operaciones comunes

En la tabla siguiente se describen los permisos necesarios para realizar varias operaciones comunes:

operación	Rol de área de trabajo	Permisos de Git
Conectar el área de trabajo al repositorio de Git	Administración	Read=Allow
Sincronizar el área de trabajo con el repositorio de Git	Administración	Read=Allow
Desconectar el área de trabajo del repositorio de Git	Administración	No se necesitan permisos
Cambiar rama en el área de trabajo (o cualquier cambio en la configuración de conexión)	Administración	Read=Allow (en el repositorio/directorio/rama de destino)
Ver los detalles de la conexión de Git	Administrador, miembro, colaborador	Lectura o ninguno
Consultar el "estado de Git" del área de trabajo	Administrador, miembro, colaborador	Read=Allow
Actualización desde Git	Todo lo siguiente: Colaborador en el área de trabajo (permiso WRITE en todos los elementos) Propietario del elemento (si el modificador de inquilino bloquea las actualizaciones de nonowners) BUILD en dependencias externas (si procede)	Read=Allow
Confirmarcambios en el área de trabajo en Git	Todo lo siguiente: Colaborador en el área de trabajo (permiso WRITE en todos los elementos) Propietario del elemento (si el modificador de inquilino bloquea las actualizaciones de nonowners) BUILD en dependencias externas (si procede)	Read=Allow Contribute=Allow la directiva de rama debe permitir la confirmación directa
Crear una nueva rama de Git desde Fabric	Administración	Role=Write Create branch=Allow

Conectar y sincronizar

Solo un administrador del área de trabajo puede conectar un área de trabajo a Azure Repos, pero una vez conectado, cualquier persona con permisos puede trabajar en el área de trabajo. Si no es administrador, pida al administrador ayuda con la conexión.

Al conectar un área de trabajo a Git, Fabric se sincroniza entre las dos ubicaciones para que tengan el mismo contenido. Durante esta sincronización inicial, si el área de trabajo o la rama de Git está vacío mientras el otro tiene contenido, el contenido se copia de la ubicación no vacía en la vacía. Si tanto el área de trabajo como la rama de Git tienen contenido, deberá decidir en qué dirección debe ir la sincronización.

• Si confirma su área de trabajo en la rama de Git, todo el contenido compatible del área de trabajo se exporta a Git y sobrescribe el contenido actual de Git.
• Si actualiza el área de trabajo con el contenido de Git, el contenido del área de trabajo se sobrescribirá y perderá el contenido de su área de trabajo. Puesto que una rama de Git siempre se puede restaurar en una fase anterior mientras que un área de trabajo no puede, si elige esta opción, se le pedirá que confirme.

Si no selecciona qué contenidos desea sincronizar, no podrá seguir trabajando hasta que lo haga:

Estado de Git

Tras conectarse, el área de trabajo muestra una columna Estado de Git que indica el estado de sincronización de cada elemento del área de trabajo en relación con los elementos de la rama remota.

Cada elemento tiene uno de los siguientes estados:

• Sincronizado (el elemento es el mismo en el área de trabajo y la rama de Git)
• Conflicto (el elemento se cambió tanto en el área de trabajo como en la rama de Git)
• Elemento no compatible
• Cambios no confirmados en el área de trabajo
• Actualización necesaria desde Git
• El elemento es idéntico en ambos lugares, pero debe actualizarse a la última confirmación

Información de sincronización

Siempre que esté conectado, la siguiente información aparece en la parte inferior de la pantalla:

• Rama conectada
• Hora de la última sincronización
• Vínculo a la última confirmación con la que se sincroniza el área de trabajo

Confirmaciones y actualizaciones

Panel de control de código fuente

En la parte superior de la pantalla se encuentra el icono de control de código fuente. Muestra el número de elementos que son diferentes en el área de trabajo y la rama de Git. Cuando el área de trabajo se sincroniza con la rama de Git, el icono de control de código fuente muestra un 0.

Cuando se realizan cambios en el área de trabajo o en la rama de Git, el icono de control de código fuente muestra el número de elementos que son diferentes. Seleccione el icono de control de código fuente para abrir el panel Control de código fuente.

En el panel Control de origen, la pestaña Cambios muestra el número de elementos que se han modificado en el área de trabajo y que deben confirmarse en Git, y la pestaña Actualizaciones muestra el número de elementos que se han modificado en la rama de Git y que deben actualizarse en el área de trabajo.

En cada pestaña, los elementos modificados se muestran con un icono que indica el estado:

• new
• modified
• deleted
• conflict

Commit

• Cuando hay más de un elemento a confirmar, puede seleccionar qué elementos confirmar en la rama de Git.
• Si se realizaron actualizaciones en la rama de Git, las confirmaciones se deshabilitan hasta que actualice el área de trabajo.

Actualizar

• A diferencia de commit y undo, el comando Update siempre actualiza toda la rama y se sincroniza con el commit más reciente. No se pueden seleccionar elementos específicos para actualizar.
• Si se realizaron cambios en el área de trabajo y en la rama de Git en el mismo elemento, las actualizaciones se deshabilitan hasta que se resuelva el conflicto.

Obtenga más información sobre cómo confirmar y actualizar. Obtenga más información sobre el proceso de actualización y cómo resolver conflictos.

Consideraciones y limitaciones

Limitaciones generales

• La cuenta de Azure DevOps debe registrarse en el mismo usuario que usa el área de trabajo de Fabric.
• El método de autenticación en Power BI debe ser al menos tan seguro como el método de autenticación para Azure DevOps. Por ejemplo, si Azure DevOps requiere autenticación multifactor, Power BI también necesita autenticación multifactor.
• Por el momento, no se admiten las consultas directas ni los modelos compuestos en los conjuntos de datos de Power BI ni en Analysis Services.
• En este momento no se admiten los modelos semánticos de DirectLake.
• La actualización de un modelo semántico mediante la API de actualización mejorada provoca una diferencia de Git después de cada actualización.

Limitaciones del área de trabajo

Solo el administrador del área de trabajo puede administrar las conexiones a Azure Repo, como conectar, desconectar o agregar una rama. Una vez conectado, cualquier persona con permiso puede trabajar en el área de trabajo.

Limitaciones de rama y carpeta

• La longitud máxima del nombre de rama es de 244 caracteres.

• La longitud máxima de la ruta de acceso completa para los nombres de archivo es de 250 caracteres. Se produce un error en los nombres más largos.

• El tamaño máximo de archivo es de 25 MB.

• No puede descargar un informe o un conjunto de datos como .pbix desde el servicio después de implementarlos con Git Integration.

• Si el nombre para mostrar del elemento:

  • Tiene más de 256 caracteres
  • Termina con .’ o un espacio
  • Contiene cualquiera de los caracteres siguientes: ", /, :, <, >, \\, *, ?, |

  El identificador lógico (GUID) se agrega como prefijo antes del tipo, al asignar un nombre a la carpeta en Git.

Limitaciones de sincronización y confirmación

• El límite de tamaño de una confirmación es de 125 MB.
• Solo se puede sincronizar en una dirección a la vez. No se puede confirmar y actualizar al mismo tiempo.
• Las etiquetas de confidencialidad no se admiten y es posible que se deshabilite la exportación de elementos con etiquetas de confidencialidad. Para confirmar los elementos que tienen etiquetas de confidencialidad sin la etiqueta de confidencialidad, pida ayuda al administrador .
• Funciona con elementos limitados. Si hay elementos no compatibles en la carpeta, se omiten.
• No se permite duplicar nombres, incluso si Power BI lo permite, se produce un error en la acción de actualización, confirmación o deshacer.
• B2B no es compatible.
• La resolución de conflictos se realiza parcialmente en Git.

Contenido relacionado

• Administración de ramas
• Resolución de errores y conflictos