Compartir a través de

¿Qué es la integración de Git de Microsoft Fabric?

En este artículo se explica a los desarrolladores cómo integrar el control de versiones de Git con la herramienta de administración del ciclo de vida de las aplicaciones (ALM) de Microsoft Fabric.

Nota:

Algunos de los elementos para la integración de Git están en versión preliminar. Para obtener más información, consulte la lista de elementos admitidos.

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 de 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

La integración con el control de código fuente está a nivel de espacio de trabajo. Los desarrolladores pueden crear versiones de los elementos que desarrollan dentro de un área de trabajo en un único proceso, con visibilidad completa a todos sus elementos. La estructura del área de trabajo, incluidas las subcarpetas, se conserva en el repositorio de Git.

Consulte la lista de elementos admitidos.

Información sobre privacidad

Antes de habilitar la integración de Git, asegúrese de revisar las siguientes declaraciones de privacidad:

Proveedores de Git compatibles

Se admiten los siguientes proveedores de Git:

Elementos admitidos

Actualmente, los siguientes elementos admiten la integración de Git:

Si el área de trabajo o el directorio de Git tiene elementos no admitidos, podrá seguir conectándose, pero se ignorarán los elementos no admitidos. No se guardan ni sincronizan, pero tampoco se eliminan. Aparecen en el panel Control de código fuente, pero no puede confirmarlos ni actualizarlos.

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 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 para mostrar del elemento tiene cualquiera de estas características, se cambia el nombre de la carpeta Git al identificador lógico (Guid) y el tipo:
    • Tiene más de 256 caracteres
    • Termina con . 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 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 en la expansión

  • La bifurcación requiere permisos enumerados en la tabla de permisos.
  • Debe haber una capacidad disponible para esta acción.
  • Todas las área de trabajo y las limitaciones de nomenclatura de rama se aplican al ramificarse 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 expande a un área de trabajo, los elementos que no se hayan guardado en Git se pueden perder. Se recomienda confirmar los elementos que quiera conservar antes de crear una nueva rama.

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 está soportado.
  • La resolución de conflictos se realiza parcialmente en Git.
  • Durante el proceso Commit to Git (Confirmar en Git), el servicio Fabric elimina los archivos dentro de la carpeta del elemento que no forman parte de la definición del 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