Compartir a través de

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

  • Artículo

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 tamaños 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

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 son compatibles los siguientes elementos:

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 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 GitHub Enterprise

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

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.

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 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 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 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 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 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 las áreas de trabajo y de las ramas se aplican cuando se ramifica hacia una nueva área de trabajo.
  • 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.
  • 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 confirmación 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 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 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 tuvieras archivos 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