Creación y administración de cuadernos de Microsoft Fabric en Visual Studio Code

La extensión Fabric Data Engineering Visual Studio (VS) Code es totalmente compatible con las operaciones de creación, lectura, actualización y eliminación de cuadernos (CRUD) en Fabric. La extensión también admite la sincronización entre áreas de trabajo locales y remotas; al sincronizar los cambios, puede solucionar los conflictos o diferencias entre el área de trabajo local y remota.

Con esta extensión, también puede ejecutar cuadernos en el proceso remoto de Apache Spark para Fabric.

Abra un cuaderno con la extensión Ingeniería de datos.

Al hacer clic en el botón Abrir en VS Code de la página de creación de cuadernos en el portal de Fabric, puede abrir directamente el mismo cuaderno con la extensión VS Code de ingeniería de datos para Fabric. Después de activar la extensión en VS Code y abrir el cuaderno una vez, el área de trabajo debe conectarse automáticamente al cuaderno.

Visualización de la lista de cuadernos

El nodo de árbol del cuaderno muestra todos los elementos del cuaderno del área de trabajo actual. En función de los cambios en VS Code, la lista muestra distintos colores y caracteres para indicar el estado más reciente, como se muestra en la siguiente imagen.

• Valor predeterminado: el texto blanco y ningún carácter a la derecha del nombre del cuaderno indica el estado predeterminado o inicializado. El cuaderno existe en el área de trabajo remota y no está descargado en tu VS Code local.
• Modificado: el carácter M situado a la derecha del nombre y el texto amarillo indica que descargó y editó el cuaderno localmente en VS Code y aún no publicó esos cambios pendientes en el área de trabajo remota.
• Local: el carácter L y el texto verde indican que el cuaderno se ha descargado y el contenido es el mismo que el área de trabajo remota.
• Conflicto: el carácter C y el texto rojo indican que existen conflictos entre la versión local y la versión del área de trabajo remota.

Creación de un cuaderno

1. En el Explorador de VS Code, mantenga el puntero sobre la barra de herramientas del cuaderno. Aparecerá la opción Crear cuaderno.

   

2. Seleccione Crear cuaderno y escriba un nombre y una descripción. Se crea un nuevo cuaderno en el área de trabajo remota y aparece en la lista de cuadernos con el estado predeterminado.

Descarga de un cuaderno

Para poder editar el contenido del cuaderno, debe descargar el cuaderno en VS Code.

1. En la lista de cuadernos de VS Code, mantenga el puntero sobre el nombre del cuaderno. La opción Descargar aparece junto al nombre del cuaderno.

   

2. Seleccione Descargar y guarde el cuaderno en el directorio de trabajo local.

Apertura de un cuaderno

1. En el Explorador de VS Code, mantenga el puntero sobre el nombre de un cuaderno descargado. Aparecen varias opciones junto al cuaderno, incluida la opción Abrir carpeta de cuaderno.

   

2. Seleccione Abrir carpeta de cuaderno y el cuaderno se abrirá en la pantalla del Editor de VS Code.

Eliminación de un cuaderno

Para eliminar un cuaderno:

1. En el Explorador de VS Code, pase el ratón por encima del nombre del cuaderno que desea eliminar; aparecerán opciones a la derecha del nombre, incluida la opción Borrar cuaderno.

   

2. Seleccione la opción Eliminar cuaderno. Cuando se le solicite, elija eliminar solo la copia local o las copias del área de trabajo local y remota.

Publicación de cambios locales en el área de trabajo remota

Para insertar los cambios locales en el área de trabajo remota:

1. En el Explorador de VS Code, pase el ratón por encima del nombre del cuaderno que desee publicar en el área de trabajo remota; a la derecha del nombre aparecerán las opciones, incluida la opción Publicar.

   

2. Seleccione Publicar. La versión del área de trabajo remota se actualiza con los cambios locales de VS Code.

   • Si la actualización local crea conflictos de combinación, se le pedirá que las resuelva antes de que pase la combinación.

3. Si otra persona tiene el mismo cuaderno abierto en el portal de Fabric, se le notificará que acepte o rechace los cambios locales de VS Code, como se muestra en la imagen siguiente.

   

   • Aceptar: el cambio de VS Code se guarda correctamente en el área de trabajo.
   • Rechazar: se omite el cambio de VS Code.

Extraer cambios del área de trabajo remota

Para actualizar la versión local con la versión más reciente del área de trabajo, extraiga la versión remota:

1. En el Explorador de VS Code, pase el ratón por encima del nombre del cuaderno que desea actualizar; aparecerán opciones a la derecha del nombre, incluida la opción Actualizar cuaderno.

   

2. Seleccione la opción Actualizar cuaderno. VS Code extrae la versión más reciente del área de trabajo remota y abre el editor de diferencias de VS Code para que pueda comparar los dos archivos de cuaderno. La pantalla lateral izquierda se encuentra en el área de trabajo, y la pantalla del lado derecho procede de la versión local:

   

3. Actualice la celda de código/markdown de la izquierda para abordar el problema.

4. Después de solucionar todos los conflictos, seleccione la opción Combinar en la esquina superior derecha del editor de diferencias para confirmar que la combinación está completa. (Hasta que seleccione Combinar, el cuaderno permanece en modo de Conflicto).

   

Ejecución o depuración de un cuaderno en un proceso remoto de Spark

Al seleccionar el kernel synapse-spark-kernel enviado con esta extensión, puede ejecutar la celda de código sobre el proceso remoto de Spark. Una vez seleccionado este kernel, la extensión intercepta todas las llamadas API de PySpark durante el tiempo de ejecución y las traduce a la llamada http correspondiente al proceso remoto de Spark. El código de Python todavía se ejecuta en el entorno local.

Contenido relacionado

• Creación y administración de definiciones de trabajos de Apache Spark en Visual Studio Code
• Exploración de los almacenes de lagos de datos de Microsoft Fabric en Visual Studio Code