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
• Confirmación de cambios
• Actualización desde Git
• Desconexión de Git

Se recomienda leer la información general de 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 de las siguientes opciones:

• Licencia de Power BI Premium. Una licencia de Power BI Premium solo admite todos los elementos de Power BI.
• Capacidad de Fabric. Se requiere una capacidad de Fabric para usar todos los elementos de Fabric admitidos. Si aún no tiene ninguna, suscríbase para obtener una evaluación gratuita.

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 los elementos del área de trabajo con sus repositorios de Git
• Solo para usuarios de GitHub: los usuarios pueden sincronizar elementos del área de trabajo con repositorios de GitHub

Estos conmutadores se pueden habilitar mediante 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. Crear una cuenta gratuita.
• Acceso a un repositorio existente.

Limitaciones de GitHub

• Una cuenta de GitHub activa. Creación de 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.

  • Cree un token clásico de GitHub con ámbitos de repo 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 persona con permisos 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.

Conectar con Azure DevOps

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 ha iniciado 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 introduce 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:

   Nota:

   Solo puede conectar un área de trabajo a una rama y una carpeta cada vez.

   • Organización
   • Proyecto
   • Repositorio 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 (introduzca 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 creará en la carpeta raíz. Solo puede conectarse a una carpeta cada vez).

Conexión de rama de GitHub

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

   Nota:

   Solo puede conectar un área de trabajo a una rama y una carpeta cada vez.

   • 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 (introduzca 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 creará en la carpeta raíz. Solo puede conectarse a una carpeta cada 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 realizados en el área de trabajo en la rama de Git y actualice el área de trabajo cada vez que alguien 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 la pestaña 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 está nuevo, modificado, en conflictoo eliminado.

4. Seleccione los elementos que desea confirmar. 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 apuntará 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 Cambios pendientes de confirmación 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 al 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 la pestaña 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 modificado está nuevo, modificado, en conflictoo eliminado.

4. Seleccione los cambios que desea deshacer.

5. Seleccione Deshacer.

   

6. Seleccione Deshacer de nuevo para confirmarlo.

   

Los elementos seleccionados del área de trabajo se revierten a como estaban cuando el área de trabajo se sincronizó 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 se establece en 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. 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 la pestaña Actualizaciones del 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 apuntará a la nueva confirmación 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. Seleccione Integración de Git
3. Seleccione Desconectar área de trabajo
4. Seleccione Desconectar de nuevo para confirmar.

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 en 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.
• Las áreas de trabajo con aplicaciones de plantilla instaladas no se pueden conectar a Git.
• 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.
• 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 su organización configuró acceso condicional, asegúrese de que el servicio Power BI tenga 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

• 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 configuraciones de GitHub Enterprise. Por ejemplo:

• Lista de direcciones IP permitidas
• Redes privadas
• Dominios personalizados

Limitaciones del área de trabajo

• Solo el administrador del área de trabajo puede administrar las conexiones al repo de Git, como conectar, desconectar o agregar una rama.
  Una vez conectado, cualquier persona con permiso puede trabajar en el área de trabajo.
• La estructura de carpetas del área de trabajo no se refleja en el repositorio de Git. Los elementos del área de trabajo de las carpetas se exportan al directorio raíz.

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.
• La carpeta Git usa el identificador lógico (GUID) como prefijo antes del tipo si el nombre para mostrar del elemento:
  • Tiene más de 256 caracteres
  • Termina con . o un espacio
  • Contiene cualquiera de los caracteres siguientes: "/:<>\*?|

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 cambia el nombre de la carpeta a algo que incluye uno de estos caracteres, Git no se puede conectar ni sincronizar con el área de trabajo y se produce un error.

Limitaciones de ramificación

• La ramificación requiere permisos que se muestran en la tabla de permisos.
• Debe haber una capacidad disponible para esta acción.
• Todas las limitaciones de nomenclatura de rama y área de trabajo y se aplican al ramificar hacia una nueva área de trabajo.
• Al ramificar, se crea una nueva área de trabajo y no se copia la configuración del área de trabajo original. Ajuste la configuración o las definiciones para garantizar que la nueva área de trabajo cumple las directivas de la organización.
• Solo los elementos compatibles con Git están disponibles en la nueva á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.

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 ayuda al administrador .
• 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, 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.
• Durante el proceso Confirmar en Git, el servicio Fabric elimina los archivos dentro de la carpeta de elementos 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 la columna de un 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 será 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 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 para la integración de Git