Comenzar con la integración de Git

En este artículo se describen las siguientes tareas básicas en la herramienta de integración de Git de Microsoft Fabric:

• Conexión a un repositorio de Git
• Confirmar cambios
• Actualización desde Git
• Desconectar de Git

Se recomienda leer la introducción a la integración de Git antes de comenzar.

Requisitos previos

Para integrar Git con el área de trabajo de Microsoft Fabric, debe configurar los siguientes requisitos previos tanto para Fabric como para Git.

Requisitos previos de Fabric

Para acceder a la característica de integración de Git, necesita una capacidad de Fabric. Se requiere una capacidad de Fabric para usar todos los elementos de Fabric admitidos. Si aún no tiene una, regístrese para obtener una evaluación gratuita. Los clientes que ya tienen una capacidad de Power BI Premium pueden usar esa capacidad, pero tenga en cuenta que determinadas SKU de Power BI solo admiten elementos de Power BI.

Además, los siguientes conmutadores de inquilino deben habilitarse desde el portal de administración:

• Los usuarios pueden crear elementos de Fabric
• Los usuarios pueden sincronizar elementos del área de trabajo con sus repositorios de Git
• Cree áreas de trabajo (solo si desea bifurcarse en una nueva área de trabajo).
• Los usuarios pueden sincronizar elementos del área de trabajo con repositorios de GitHub: solo para usuarios de GitHub

Estos interruptores se pueden habilitar por el administrador de inquilinos, el administrador de capacidad o el administrador del área de trabajo, en función de la configuración de la organización.

Requisitos previos de Git

La integración de Git se admite actualmente para Azure DevOps y GitHub. Para usar la integración de Git con el área de trabajo de Fabric, necesita lo siguiente en Azure DevOps o GitHub:

Limitaciones de Azure DevOps

• Una cuenta de Azure activa registrada en el mismo usuario que usa el área de trabajo de Fabric. Cree una cuenta gratuita.

Limitaciones de GitHub

• Una cuenta de GitHub activa. Cree una cuenta de GitHub.

• Uno de los siguientes tokens de acceso personal:

  • Un token específico (recomendado) con permiso de lectura y escritura de contenido en los permisos del repositorio:

    

    Para usar este token con GitHub Enterprise, siga estas instrucciones.

  • Un token clásico de GitHub creado con ámbitos de repositorio habilitados:

    

Conectar un área de trabajo a un repositorio de Git

Conexión a un repositorio de Git

Solo un administrador del área de trabajo puede conectar un área de trabajo a un repositorio, pero una vez conectado, cualquier usuario con permiso puede trabajar en el área de trabajo. Si no es administrador, pida al administrador ayuda con la conexión. Para conectar un área de trabajo a un repositorio de Azure o de GitHub, siga estos pasos:

1. Inicie sesión en Fabric y vaya al área de trabajo con la que quiere conectarse.

2. Vaya a Configuración del área de trabajo.

   

3. Seleccione Integración de Git.

4. Seleccione a su proveedor de Git. Actualmente se admiten Azure DevOps y GitHub.

Azure DevOps Connect

Si selecciona Azure DevOps, seleccione Conectar para iniciar sesión automáticamente en la cuenta de Azure Repos registrada en el usuario de Microsoft Entra que inició sesión en Fabric.

GitHub Connect

Si selecciona GitHub, debe iniciar sesión en su cuenta de GitHub.
Seleccione Agregar cuenta si es la primera vez que inicia sesión en Fabric, o seleccione una de las cuentas indicadas. Después de iniciar sesión, seleccione Conectar para permitir que Fabric acceda a su cuenta de GitHub.

Si es la primera vez que se conecta, debe autorizar al usuario de GitHub. Proporcione la siguiente información:

• Nombre para mostrar : debe ser único para cada usuario de GitHub.
• Token de acceso personal - su token de acceso personal clásico o específico
• Dirección URL del repositorio (opcional): si no escribe una dirección URL, puede conectarse a cualquier repositorio al que tenga acceso. Si introduce una dirección URL, solo puede conectarse a este repositorio.

Conexión a un área de trabajo

Si el área de trabajo ya está conectada a GitHub, siga las instrucciones para Conectarse a un área de trabajo compartida.

Conexión de rama de Azure DevOps

1. En el menú desplegable, especifique los detalles siguientes sobre la rama a la que desea conectarse:

   • Organización
   • Proyecto
   • Repositorio de Git.
   • Rama (seleccione una rama existente con el menú desplegable o seleccione + Nueva rama para crear una nueva rama. Solo puede conectarse a una rama a la vez).
   • Carpeta (escriba el nombre de una carpeta existente o escriba un nombre para crear una carpeta nueva. Si deja el nombre de la carpeta en blanco, el contenido se crea en la carpeta raíz. Solo puede conectarse a una carpeta a la vez).

Conexión de rama de GitHub

1. En el menú desplegable, especifique los detalles siguientes sobre la rama a la que desea conectarse:

   • Dirección URL del repositorio. Si se ha conectado a GitHub mediante un token con ámbito, la dirección URL se rellena automáticamente y solo puede conectarse a ese repositorio.
   • Rama (seleccione una rama existente con el menú desplegable o seleccione + Nueva rama para crear una nueva rama. Solo puede conectarse a una rama a la vez).
   • Carpeta (escriba el nombre de una carpeta existente o escriba un nombre para crear una carpeta nueva. Si deja el nombre de la carpeta en blanco, el contenido se crea en la carpeta raíz. Solo puede conectarse a una carpeta a la vez).

Seleccione Conectar y sincronizar.

Durante la sincronización inicial, si el área de trabajo o la rama de Git están vacíos, el contenido se copia de la ubicación no vacía a la vacía. Si tanto el área de trabajo como la rama de Git tienen contenido, se le preguntará en qué dirección debe ir la sincronización. Para obtener más información sobre esta sincronización inicial, consulte Conexión y sincronización.

Después de conectarse, el área de trabajo muestra información sobre el control de código fuente que permite al usuario ver la rama conectada, el estado de cada elemento de la rama y la hora de la última sincronización.

Para mantener el área de trabajo sincronizada con la rama de Git, confirme los cambios que realice en el área de trabajo en la rama de Git y actualice el área de trabajo cada vez que cualquier usuario cree nuevas confirmaciones en la rama de Git.

Confirmación de cambios en Git

Una vez que se conecte correctamente a una carpeta de Git, edite el área de trabajo como de costumbre. Los cambios que guarde solo se guardarán en el área de trabajo. Cuando esté listo, puede confirmar los cambios en la rama de Git, o bien deshacer los cambios y revertir al estado anterior.

Más información sobre confirmaciones.

Confirmar en Git

Para confirmar los cambios en la rama de Git, siga estos pasos:

1. Vaya al área de trabajo.

2. Seleccione el icono Control de código fuente . Este icono muestra el número de cambios no confirmados.

3. Seleccione los cambios en el panel Control de código fuente . Aparece una lista con todos los elementos que ha cambiado y un icono que indica si el elemento es nuevo , modificado , conflictoeliminado .

4. Seleccione los elementos que desea realizar. Para seleccionar todos los elementos, active la casilla superior.

5. Agregue un comentario en el cuadro. Si no agrega un comentario, se agrega automáticamente un mensaje predeterminado.

6. Seleccione Confirmar.

   

Una vez confirmados los cambios, los elementos confirmados se quitan de la lista y el área de trabajo apunta a la nueva confirmación con la que se sincroniza.

Una vez completada correctamente la confirmación, el estado de los elementos seleccionados cambia de No confirmado a Sincronizado.

Deshacer cambio guardado

Después de guardar los cambios en el área de trabajo, si decide que no desea confirmar esos cambios en Git, puede deshacer los cambios y revertir esos elementos a su estado anterior. Para deshacer los cambios, siga estos pasos:

1. Vaya al área de trabajo.

2. Seleccione el botón Control de código fuente . Este botón también muestra el número de cambios pendientes de confirmación.

3. Seleccione Cambios en el panel Control de código fuente . Aparece una lista con todos los elementos que cambió y un icono que indica si el elemento modificado es nuevo , modificado , conflictoeliminado .

4. Seleccione los cambios que desea deshacer.

5. Seleccione Deshacer.

   

6. Seleccione Deshacer de nuevo para confirmarlo.

   

Los elementos seleccionados en tu área de trabajo volverán a su estado anterior cuando se haya sincronizado por última vez.

Importante

Si elimina un elemento y, a continuación, deshace los cambios, el elemento se crea de nuevo y algunos de los metadatos podrían perderse. Por ejemplo, las etiquetas de confidencialidad no se mantienen y deben restablecerse, y el propietario del elemento pasa a ser el usuario actual.

Actualización del área de trabajo desde Git

Cada vez que alguien confirma un nuevo cambio en la rama de Git conectada, aparece una notificación en el área de trabajo correspondiente. Utilice el panel Control de código fuente para extraer los cambios, combinaciones o reversiones más recientes en el área de trabajo y actualizar los elementos activos. Los cambios en las carpetas también se actualizan. Obtenga más información sobre la actualización.

Para actualizar un área de trabajo, siga estos pasos:

1. Vaya al área de trabajo.
2. Seleccione el icono Control de código fuente .
3. Seleccione Actualizaciones en el panel Control de código fuente. Aparece una lista con todos los elementos que se cambiaron en la rama desde la última actualización.
4. Seleccione Actualizar todo.

Una vez que se actualiza correctamente, se quita la lista de elementos y el área de trabajo apunta al nuevo área de trabajo a la que está sincronizada.

Una vez completada correctamente la actualización, el estado de los elementos cambia a Sincronizado.

Desconexión de un área de trabajo de Git

Solo un administrador del área de trabajo puede desconectar un área de trabajo de un repositorio de Git. Si no es administrador, pida a su administrador ayuda con la desconexión. Si es administrador y quiere desconectar el repositorio, siga estos pasos:

1. Vaya a Configuración del área de trabajo.
2. Selecciona integración de Git
3. Seleccione Desconectar área de trabajo.
4. Seleccione Desconectar de nuevo para confirmarlo.

Permisos

Las acciones que puede realizar en un área de trabajo dependen de los permisos que tenga tanto en el área de trabajo como en el repositorio de Git. Para obtener una explicación más detallada de los permisos, consulte Permisos.

Consideraciones y limitaciones

Limitaciones generales de integración de Git

• El método de autenticación de Fabric debe ser al menos tan seguro como el método de autenticación para Git. Por ejemplo, si Git requiere autenticación multifactor, Fabric también necesita autenticación multifactor.
• Los conjuntos de datos de Power BI conectados a Analysis Services no se admiten en este momento.
• Si usa una identidad de área de trabajo en un artefacto y la confirma en Git, solo se puede actualizar (volver a un área de trabajo de tejido) en un área de trabajo conectada a la misma identidad. Tenga cuidado, ya que esto también afecta a características como la ramificación.
• No se admiten submódulos.
• No se admiten las nubes soberanas.

Limitaciones de Azure DevOps

• La cuenta de Azure DevOps debe registrarse en el mismo usuario que usa el área de trabajo de Fabric.
• Azure DevOps no se admite si la Habilitar validación de la política de acceso condicional de IP está habilitada.
• Si el área de trabajo y el repositorio de Git se encuentran en dos regiones geográficas diferentes, el administrador de inquilinos deberá habilitar las exportaciones entre áreas geográficas.
• Si la organización configuró el acceso condicional, asegúrese de que el servicio Power BI tiene las mismas condiciones establecidas para que la autenticación funcione según lo previsto.
• El tamaño de una confirmación está limitado a 125 MB.

Limitaciones de GitHub

• Solo se admiten versiones en la nube de GitHub. No se admite el entorno local.
• GitHub no puede aplicar validaciones entre regiones geográficas.
• El tamaño combinado total de los archivos que se van a confirmar a la vez está limitado a 50 MB. Por tanto, si tiene varios elementos que se van a confirmar, es posible que a veces sea necesario separarlos en confirmaciones independientes. Para obtener más información sobre cómo confirmar archivos, consulte nuestra guía de solución de problemas.

Limitaciones de GitHub Enterprise

No se admiten algunas versiones y configuraciones de GitHub Enterprise. Por ejemplo:

• GitHub Enterprise Cloud con residencia de datos (ghe.com)
• No se admite GitHub Enterprise Server con un dominio personalizado, aunque la instancia sea accesible públicamente.
• Github Enterprise Server hospedado en una red privada
• Lista de direcciones IP permitidas

Limitaciones del área de trabajo

• Solo el administrador del área de trabajo puede administrar las conexiones al repositorio de Git , como conectarse, desconectar o agregar una rama.
  Una vez conectado, cualquier persona con permiso puede trabajar en el área de trabajo.
• Las áreas de trabajo con aplicaciones de plantilla instaladas no se pueden conectar a Git.
• MyWorkspace no se puede conectar a un proveedor de Git.

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.
• La estructura de carpetas se mantiene hasta 10 niveles de profundidad.
• No se recomienda descargar un informe o un conjunto de datos como .pbix desde el servicio después de implementarlos con la integración de Git, ya que los resultados no son confiables. Se recomienda usar PowerBI Desktop para descargar informes o conjuntos de datos como .pbix.
• Si el nombre mostrado del elemento tiene alguna de estas características, se cambia el nombre de la carpeta Git al ID lógico (GUID) y tipo:
  • Tiene más de 256 caracteres
  • Termina con un . o un espacio
  • Contiene caracteres prohibidos, según se describe en las limitaciones del nombre de directorio
• Al conectar un área de trabajo que tiene carpetas a Git, debe confirmar los cambios en el repositorio de Git si esa estructura de carpetas es diferente.

Limitaciones del nombre del directorio

• El nombre del directorio que se conecta al repositorio de Git tiene las siguientes restricciones de nomenclatura:

  • El nombre del directorio no puede comenzar ni terminar con un espacio o una pestaña.
  • El nombre del directorio no puede contener ninguno de los siguientes caracteres: "/:<>\*?|

• La carpeta item (la carpeta que contiene los archivos de elementos) no puede contener ninguno de los siguientes caracteres: ":?<>\*|. Si cambias el nombre de la carpeta por algo que incluya uno de estos caracteres, Git no podrá conectarse o sincronizarse con el área de trabajo y se producirá un error.

Limitaciones de ramificación

• La bifurcación requiere permisos enumerados en la tabla de permisos.
• Debe haber una capacidad disponible para esta acción.
• El área de trabajo y las limitaciones de nomenclatura de rama se aplican al bifurcarse a una nueva área de trabajo.
• Solo los elementos compatibles con Git están disponibles en el nuevo área de trabajo.
• La lista de ramas relacionadas solo muestra ramas y áreas de trabajo que tiene permiso para ver.
• La integración de Git debe estar habilitada.
• Al bifurcar, se crea una nueva rama y no se copia la configuración de la rama original. Ajuste cualquier configuración o definiciones para asegurarse de que el nuevo cumple las directivas de la organización.
• Al ramificarse en un área de trabajo existente:
  • El área de trabajo de destino debe admitir una conexión de Git.
  • El usuario debe ser un administrador del área de trabajo de destino.
  • El área de trabajo de destino debe tener capacidad.
  • El área de trabajo no puede tener aplicaciones de plantilla.
• Tenga en cuenta que, cuando se bifurca en un área de trabajo, los elementos que no se guardan en Git se pueden perder. Se recomienda hacer "commit" de los elementos que quiera conservar antes de la bifurcación.

Limitaciones de sincronización y confirmación

• 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 al administrador ayuda.
• Funciona con elementos limitados. Si hay elementos no compatibles en la carpeta, se omiten.
• No se permiten duplicaciones de nombres. Incluso si Power BI permite la duplicación de nombres, fallan las acciones de actualización, confirmación o deshacer.
• B2B no está soportado.
• La resolución de conflictos se realiza parcialmente en Git.
• Durante el proceso Commit to Git, el servicio Fabric elimina los archivos dentro de la carpeta de elemento que no forman parte de la definición de elemento. Los archivos no relacionados que no están en una carpeta de elementos no se eliminan.
• Después de confirmar los cambios, es posible que observe algunos cambios inesperados en el elemento que usted no hizo. Estos cambios son semánticamente insignificantes y pueden ocurrir por varias razones. Por ejemplo:
  • Cambiar manualmente el archivo de definición de elemento. Estos cambios son válidos, pero pueden ser diferentes de si se realizan a través de los editores. Por ejemplo, si cambia el nombre de una columna de modelo semántico en Git e importa este cambio en el área de trabajo, la próxima vez que confirme los cambios en el modelo semántico, el archivo bim se registrará como modificado y la columna modificada insertada en la parte posterior de la columns matriz. Esto se debe a que el motor de AS que genera los archivos bim inserta columnas cuyo nombre ha cambiado al final de la matriz. Este cambio no afecta a la forma en que funciona el elemento.
  • Confirmar un archivo que usa saltos de línea CRLF. El servicio usa saltos de línea LF (avance de línea). Si tenía archivos de elementos en el repositorio de Git con saltos de línea CRLF, al confirmar desde el servicio, estos archivos se cambian a LF. Por ejemplo, si abre un informe en el escritorio, guarde el archivo de proyecto (.pbip) y cárguelo en Git mediante CRLF.
• 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.

Contenido relacionado

• Descripción del proceso de integración de Git
• Administración de ramas de Git
• Procedimientos recomendados de integración de Git