Implementación y control de código fuente de cuaderno

En este artículo se explica cómo funcionan las canalizaciones de implementación e integración de Git para cuadernos en Microsoft Fabric. Obtenga información sobre cómo configurar una conexión al repositorio, administrar los cuadernos e implementarlos en distintos entornos.

Integración de cuaderno de Git

Los cuadernos de Fabric ofrecen integración de Git para el control de código fuente con Azure DevOps. Con la integración de Git, puede realizar copias de seguridad y editar el cuaderno, revertir a las fases anteriores según sea necesario, colaborar o trabajar solo con ramas de Git y administrar el ciclo de vida del contenido del cuaderno completamente dentro de Fabric.

Importante

Esta característica se encuentra en versión preliminar.

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, incluidos los cuadernos, aparecen en el panel Control de código fuente.

Después de confirmar correctamente las instancias del cuaderno en el repositorio de Git, verá la estructura de carpetas del cuaderno en el repositorio.

Ahora puede ejecutar operaciones futuras, como Creación de solicitud de incorporación de cambios.

Representación del cuaderno en Git

La siguiente imagen es un ejemplo de la estructura de archivos de cada elemento de cuaderno del repositorio:

Al confirmar el elemento de cuaderno en el repositorio de Git, el código del cuaderno se convierte en un formato de código fuente, en lugar de un archivo .ipynb estándar. Por ejemplo, un cuaderno de PySpark se convierte en un archivo notebook-content.py. Este enfoque permite realizar revisiones de código más sencillas mediante características de diferencias integradas.

En el archivo de origen de contenido del elemento, se conservan y distinguen los metadatos (incluido el almacén de lago predeterminado y el entorno adjunto), las celdas de Markdown y las celdas de código. Este enfoque admite una recuperación precisa cuando se vuelve a sincronizar con un área de trabajo de Fabric.

La salida de la celda del cuaderno no se incluye al sincronizar con Git.

Nota:

• Actualmente, los archivos de los recursos de Notebook no se confirman en el repositorio. La confirmación de estos archivos se admite en una próxima versión.
• El entorno adjunto persiste en un cuaderno cuando se sincroniza desde el repositorio a un área de trabajo de Fabric. Actualmente, no se admiten entornos de referencia entre áreas de trabajo. Debe asociar manualmente a un nuevo entorno o configuración predeterminada del área de trabajo en para ejecutar el cuaderno.
• El identificador predeterminado del almacén de lago se conserva en el cuaderno cuando se sincroniza desde el repositorio a un área de trabajo de Fabric. Si confirma un cuaderno con el almacén de lago predeterminado, debe hacer referencia manualmente a un elemento del almacén de lago recién creado. Para más información, consulte Integración del almacén de lago de Git.

Cuaderno en canalizaciones de implementación

También puede usar la canalización de implementación para implementar el código del cuaderno en distintos entornos, como desarrollo, prueba y producción. Esta característica puede permitirle simplificar el proceso de desarrollo, garantizar la calidad y la coherencia, y reducir los errores manuales con operaciones ligeras de código bajo. También puede usar reglas de implementación para personalizar el comportamiento de los cuadernos cuando se implementan, como cambiar la instancia predeterminada del almacén de lago de un cuaderno.

Importante

Esta característica se encuentra en versión preliminar.

Siga estos pasos para completar la implementación del cuaderno mediante la canalización de implementación.

1. Cree una nueva canalización de implementación o abra una canalización de implementación existente. (Para obtener más información, consulte Introducción a las canalizaciones de implementación).

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

3. Seleccione, vea y compare elementos, incluidos los cuadernos entre distintas fases, como se muestra en el siguiente ejemplo.

   

4. Seleccione Implementar para implementar los cuadernos en las fases desarrollo, prueba y producción.

5. (Opcional). Puede seleccionar Reglas de implementación para crear reglas de implementación para un proceso de implementación. La entrada de reglas de implementación está en la fase de destino de un proceso de implementación.

   

   Fabric admite la parametrización del almacén de lago predeterminado para cada instancia de cuaderno al implementar con reglas de implementación. Hay tres opciones disponibles para especificar el almacén de lago predeterminado de destino: igual que con el almacén de lago de origen, N/Ay otro almacén de lago.

   

   Puede lograr el aislamiento de datos protegido mediante la configuración de esta regla. El almacén de lago predeterminado del cuaderno se reemplaza por el que especificó como destino durante la implementación.

   Nota:

   Cuando decide adoptar otras casas de lago en el entorno de destino, el identificador de Lakehouse es un elemento que debe tener. Puede encontrar el identificador de una instancia de almacén de lago desde el vínculo URL del almacén de lago.

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

Contenido relacionado

• Administración y ejecución de cuadernos de Fabric con API públicas
• Introducción a la integración de Git
• Introducción a las canalizaciones de implementación