Implementación y control de código fuente de funciones de datos de usuario

En este artículo se explica cómo funcionan las canalizaciones de integración e implementación de Git para funciones de datos de usuario en Microsoft Fabric. Con la integración de Git, puede mantener el área de trabajo de Fabric sincronizada con una rama de repositorio, lo que le permite controlar las versiones de las funciones de datos de usuario, colaborar mediante ramas y solicitudes de incorporación de cambios y trabajar con el código en las herramientas de Git preferidas, como Azure DevOps.

Obtenga más información sobre el proceso de integración de Git con el área de trabajo de Microsoft Fabric en Conceptos básicos de la integración de Git.

Configuración de una conexión

Desde la configuración del área de trabajo, puede configurar fácilmente una conexión al repositorio para confirmar y sincronizar los cambios. Para configurar la conexión, consulte Introducción a la integración de Git. Una vez conectados, los elementos, incluyendo las funciones de datos de usuario, aparecerán en el panel Control de código fuente.

Después de confirmar correctamente los elementos de las funciones de datos de usuario en el repositorio de Git, verá las carpetas de funciones de datos de usuario en el repositorio. Ya podrá ejecutar operaciones futuras, como la creación de una solicitud de incorporación de cambios.

Representación de funciones de datos de usuario en Git

En la imagen siguiente se muestra un ejemplo de la estructura de archivos de cada elemento de funciones de datos de usuario del repositorio.

La estructura de carpetas incluye los siguientes elementos:

• .platform: el archivo .platform contiene los atributos siguientes:

  

  • versión: número de versión de los archivos del sistema. Este número se usa para habilitar la compatibilidad con versiones anteriores. El número de versión del elemento podría ser diferente.
  • logicalId: un identificador entre áreas de trabajo generado automáticamente que representa un elemento y su representación de control de código fuente.
  • tipo: UserDataFunction es el tipo para definir un elemento de funciones de datos de usuario.
  • displayName: representa el nombre del elemento. Cuando se cambia el nombre del elemento de funciones de datos de usuario, se actualiza este displayName.

• definitions.json: este archivo comparte todas las definiciones de elementos de funciones de datos de usuario, como conexiones, bibliotecas, etc. como una representación de las propiedades de elemento de funciones de datos de usuario.

  

• function-app.py: este archivo es el código de las funciones. Los cambios de código que realice en el elemento de funciones de datos de usuario se sincronizan en el repositorio con este archivo. Es posible realizar varias operaciones de Git para administrar el ciclo de desarrollo de código.

  

• recursos: la carpeta contiene un archivo functions.json con todos los metadatos, como conexiones, bibliotecas y funciones dentro de este elemento. NO ACTUALICE ESTE ARCHIVO manualmente. functions.json permite a Fabric crear o volver a crear el elemento de funciones de datos de usuario en un área de trabajo.

  

Para obtener más información sobre la integración de Git, incluidos los detalles sobre la estructura de carpetas y los archivos del sistema, consulte Formato de código fuente de integración de Git.

Funciones de datos de usuario en canalizaciones de implementación

Puede usar canalizaciones de implementación para implementar las funciones de datos de usuario en distintos entornos, como desarrollo, prueba y producción. Las canalizaciones de implementación le ayudan a simplificar el proceso de desarrollo, garantizar la calidad y la coherencia y reducir los errores manuales con operaciones ligeras y de poco código.

Nota:

Todas las conexiones y bibliotecas se agregan a los nuevos elementos de funciones de datos de usuario creados en otros entornos.

Para implementar las funciones de datos de usuario mediante una canalización de implementación:

1. Cree una nueva canalización de implementación o abra una canalización de implementación existente. Consulte Introducción a las canalizaciones de implementación para obtener más información.

2. Asigne áreas de trabajo a distintas fases según los objetivos de implementación.

3. Seleccione, vea y compare elementos, incluyendo los elementos de funciones de datos de usuario entre distintas fases.

4. Seleccione Implementar para implementar el elemento de funciones de datos de usuario en el entorno de prueba. Agregue una nota para proporcionar detalles sobre los cambios de esta implementación. Del mismo modo, es posible insertar cambios en las fases de desarrollo, prueba y producción.

5. Supervise el estado de implementación del historial de implementación.

Contenido relacionado

• Introducción a la integración de Git de Microsoft Fabric
• Introducción a las canalizaciones de implementación