11 Blocs de notas

En este capítulo se proporciona información sobre el uso y la gestión de blocs de notas en el espacio de trabajo.

Temas:

Desarrollo de código en blocs de notas

Los ingenieros de datos y los científicos de datos pueden utilizar blocs de notas en su área de trabajo de Oracle AI Data Platform como una herramienta común para desarrollar código y explorar datos de forma interactiva.

El área de trabajo de Oracle AI Data Platform soporta actualmente lenguajes Python, SQL y Scala en blocs de notas. Los blocs de notas se pueden programar o configurar para ejecutarse como parte de un flujo de trabajo. Para ejecutar blocs de notas, debe asociar un cluster de recursos informáticos.

Tu área de trabajo de AI Data Platform incluye blocs de notas gestionados integrados para una experiencia de desarrollador intuitiva.

Puede utilizar el código de ejemplo en el repositorio de Git de muestras de Oracle AI Data Platform Workbench para ver ejemplos de código que puede utilizar con su bloc de notas.

Guardado automático

Los cuadernos se guardan automáticamente cada dos minutos.

Importación y exportación de blocs de notas

Actualmente, puede importar un archivo de bloc de notas (*.ipynb) desde la máquina local al espacio de trabajo.

La exportación de blocs de notas no está soportada actualmente.

Crear un bloc de notas

Puede crear un Notebook en cualquier espacio de trabajo en el que tenga permisos de administrador.

  1. En la página inicial, vaya al espacio de trabajo.
  2. Haga clic en Crear y haga clic en Libro de notas.
  3. Rellene el nombre y la descripciones y, a continuación, haga clic en Crear.

Asociación de un cluster existente a un bloc de notas

Los blocs de notas requieren un cluster conectado para proporcionar potencia de cálculo para el código desarrollado.

  1. En la página inicial, vaya al espacio de trabajo y abra el bloc de notas.
  2. Haga clic en Acciones y, a continuación, en Asociar un cluster existente.
  3. Haga clic en el cluster que desea utilizar de la lista.
    El bloc de notas mostrará Cluster: (ClusterName) running cuando se haya conectado correctamente. Esto puede tardar hasta varios minutos.

Creación de un cluster para un bloc de notas

Puede crear un nuevo cluster directamente desde la interfaz de bloc de notas y asociarlo inmediatamente.

Para obtener más información, consulte Acerca de los clusters de recursos informáticos.
  1. En la página inicial, vaya al espacio de trabajo y abra el bloc de notas.
  2. Haga clic en Acciones y, a continuación, en Crear cluster.
  3. Seleccione Versión de tiempo de ejecución.
  4. Seleccione las opciones de controlador para el cluster.
  5. Seleccione las opciones de trabajador para el cluster. Estas opciones se aplican a todos los trabajadores del cluster.
  6. Seleccione si el número de trabajadores es estático o se escala automáticamente.
    • Si es Importe estático, especifique el número de trabajadores.
    • Si es Escala automática, especifique el número mínimo y máximo de trabajadores a los que se puede escalar el cluster.
  7. En Duración de ejecución, seleccione si el cluster dejará de ejecutarse después de una duración definida de inactividad. Si se selecciona Timeout de inactividad, especifique el tiempo de inactividad, en minutos, antes de que se agote el tiempo de espera del cluster.
  8. Haga clic en Create.

Idioma por defecto

Puede utilizar blocs de notas para desarrollar y ejecutar código de Apache Spark en Python, SQL o Scala.

El lenguaje por defecto para los blocs de notas es Python. Puede cambiar el idioma por defecto para todo el bloc de notas o para celdas individuales a SQL, Scala, Markdown o texto sin formato. Puede combinar código Python, SQL y Scala en celdas diferentes dentro del mismo bloc de notas.

Los blocs de notas tienen resaltado de sintaxis para Python, SQL y Scala. Se crearán nuevas celdas de bloc de notas en función del idioma por defecto del bloc de notas.

Gestión de blocs de notas

Puede cambiar el nombre de los blocs de notas y suprimirlos. También puede clonar blocs de notas para copiar su contenido y trabajar con su código en un nuevo bloc de notas.

Cambie el nombre de los blocs de notas y suprímalos de su menú de acción en el espacio de trabajo. Para clonar el bloc de notas, ábralo y seleccione la opción Clonar en el menú Archivo.

Cambiar nombre de un bloc de notas

Si el nombre de su portátil ya no es útil o relevante, puede cambiarlo en cualquier momento.

  1. En la página inicial, vaya al espacio de trabajo.
  2. Junto al bloc de notas al que desea cambiar el nombre, haga clic en Acciones y, a continuación, en Cambiar nombre.
  3. Introduzca un nuevo nombre y haga clic en Guardar.
  4. Opcional: también puede cambiar el nombre de un bloc de notas abierto haciendo clic en el nombre e introduciendo uno nuevo.

Suprimir un bloc de notas

Puede suprimir blocs de notas para los que tenga permisos de administrador.

  1. Navegue hasta el espacio de trabajo.
  2. Junto al bloc de notas que desea suprimir, haga clic en Acciones y, a continuación, en Suprimir.
  3. Haga clic en Suprimir.

Clonar un bloc de notas

Puede clonar un bloc de notas existente para crear una copia del contenido de ese bloc de notas que puede modificar mientras conserva el original.

  1. Abra el bloc de nota que desea clonar.
  2. En la barra de herramientas del bloc de notas, haga clic en Archivo y, a continuación, en Clonar.
  3. Introduzca un nuevo nombre para el bloc de notas clonado.
  4. Haga clic en Examinar para seleccionar la carpeta del espacio de trabajo en la que guardar el bloc de notas clonado. Si no se selecciona ninguna carpeta, el bloc de notas clonado se crea en la misma carpeta que el bloc de notas que está clonando.
  5. Seleccione si desea incluir o excluir las salidas. Las salidas se incluyen de forma predeterminada. Borre la selección para excluir las salidas.
  6. Haga clic en Clonar. El bloc de notas clonado se crea en la carpeta de espacio de trabajo especificada.

Examinar recursos al editar bloc de notas

Cuando esté en un bloc de notas, puede examinar los objetos del catálogo o del espacio de trabajo del lado izquierdo sin salir del bloc de notas.

Si arrastra y suelta cualquier objeto del panel de la izquierda en el bloc de notas, el nombre del objeto o la ruta completa se copia y se pega en la celda del bloc de notas (según el contexto).


Un bloc de notas abierto con un objeto arrastrado y soltado en el bloc de notas

También dispone de opciones de botón y menú contextual para cada objeto de catálogo o espacio de trabajo en el panel de la izquierda. El menú contextual de la navegación izquierda tiene opciones para copiar el código de ejemplo, el nombre de copia o la ruta de acceso de copia, de modo que pueda pegarlo en la celda del bloc de notas.


Opciones del menú contextual que se muestran en el panel izquierdo de un bloc de notas

Ejecutar blocs de notas

Puede ejecutar código en blocs de notas de su propiedad o desde blocs de notas que se comparten con usted.

El código se puede ejecutar desde un bloc de notas mediante tres métodos: ejecución bajo demanda, ejecución manual puntual o creación de un trabajo de bloc de notas programado. Los trabajos que se ejecutan bajo demanda solo se ejecutan una vez.

Ejecución de comandos de terminal en un bloc de notas

Puede ejecutar comandos de terminal básicos o comandos de shell en un bloc de notas prefijando un '!'. Por ejemplo, puede utilizar el comando unzip para extraer de los archivos ZIP del espacio de trabajo.


Ejemplo del comando descomprimir en uso

También puede utilizar el módulo subprocess en Python para la ejecución de secuencias de comandos de shell.


Ejemplo del comando de subproceso en uso

También puede utilizar módulos Python nativos, como zipfile, para tareas como descomprimir archivos como alternativa a los comandos de shell.

Limitaciones

Actualmente, Oracle AI Data Platform Workbench no cuenta con soporte nativo para sistemas de instalación de pip, integración y despliegue continuos, Git o control de versiones.

Opciones de ejecución para celdas de bloc de notas

El menú Run (Ejecutar) de los blocs de notas proporciona opciones para ejecutar celdas en un bloc de notas.

<Introducir título de sección aquí>

Puede encontrar todas las opciones para ejecutar celdas en el bloc de notas desde el menú Ejecutar en la parte superior del bloc de notas.


Menú Run en un bloc de notas abierto y que muestra las opciones para ejecutar celdas en un bloc de notas

Tabla 11-1 Opciones de ejecución para celdas de bloc de notas

Opción Descripción
Ejecutar todo Ejecuta todas las celdas del bloc de notas de forma secuencial.
Ejecutar celdas seleccionadas Ejecuta las celdas seleccionadas actualmente.
Ejecutar todo lo anterior Ejecuta la celda seleccionada actualmente y todas las celdas que aparecen encima de la celda seleccionada actualmente en el bloc de notas.
Ejecutar todo a continuación Ejecuta la celda seleccionada actualmente y las celdas que aparecen debajo de la celda seleccionada actualmente en el bloc de notas.
Ejecutar el texto seleccionado Ejecuta el segmento de código seleccionado en una celda.
Ir a la última celda de ejecución Navega hasta la celda de ejecución más reciente del bloc de notas.
Borrar todas las salidas de celda Elimina las salidas de todas las celdas del bloc de notas.

Ejecutar código desde un bloc de notas

Puede elegir ejecutar todo el código desarrollado en un bloc de notas a la vez, o una celda a la vez.

Los métodos abreviados del teclado para ejecutar código en un bloc de notas son:
  • MacOS: Cmd + Return
  • Windows: Ctrl + Intro

Puede ejecutar el código en una sola celda haciendo clic en el botón Botón de reproducción de bloc de notas Reproducir o ejecutar todo el bloc de notas haciendo clic en Ejecutar todo.

  1. En la página de inicio, haga clic en Espacio de trabajo.
  2. Vaya a su bloc de notas.
  3. Haga clic en Ejecutar todo.
  4. Compruebe el estado de la ejecución del trabajo de bloc de notas haciendo clic en Flujo de trabajo y, a continuación, en Ejecuciones de trabajos.

Ejecutar código desde otro bloc de notas

Puede utilizar el comando %run magic en un bloc de notas para incluir código de otro bloc de notas.

En el siguiente ejemplo, puede incorporar código de un bloc de notas denominado notebook.ipynb a un bloc de notas caller-notebook.ipynb.
  1. Instale la biblioteca Python nbconvert.
  2. Utilice el comando %run en una celda, como en el siguiente ejemplo:
    %run /Workspace/folder1/called-notebook.ipynb

Después de seguir estos pasos, el bloc de notas denominado notebook.ipynb se ejecuta inmediatamente con el principal de usuario (es decir, caller-notebook.ipynb) y con el cluster asociado de caller-notebook.ipynb. Todas las funciones y variables definidas en llamado-notebook.ipynb están disponibles inmediatamente en el bloc de notas denominado caller-notebook.ipynb.

Compartir salida de bloc de notas con oidlUtils

Puede capturar y compartir la salida de contenido mediante las tareas de bloc de notas mediante las utilidades disponibles en oidlUtils.

oidlUtils es un conjunto de utilidades disponibles para todos los usuarios de Oracle AI Data Platform Workbench. Al compartir contenido entre blocs de notas, se puede llamar a oidlUtils para transferir argumentos a un bloc de notas y devolver la salida al bloc de notas del emisor de llamada, y se puede llamar en una tarea de trabajo de un bloc de notas para devolver la salida a la tarea principal, lo que significa que la tarea llama al bloc de notas. De esta forma, puede capturar y utilizar la salida estructurada devuelta por las tareas de bloc de notas.

Estos módulos oidlUtils están disponibles para su uso con blocs de notas:

Módulo Descripción Ejemplo
cuaderno Orqueste ejecuciones de tareas de bloc de notas y devuelva un único resultado estructurado (normalmente una cadena JSON) al emisor de la llamada. 
oidlUtils.notebook.run(
    notebook_path: str,
    timeout_seconds: int = 0, (Optional)
    parameters: dict (Optional)
) -> str
cuaderno Permita que un bloc de notas salga de una ejecución de tarea y devuelva un único resultado de cadena (normalmente una carga útil de JSON) al bloc de notas del emisor de llamada o a la API de salida de trabajo/tarea. 
oidlUtils.notebook.exit(value: str)

Ejemplo 1: uso compartido de bloc de notas

En este ejemplo, se utiliza Notebook A para llamar al Notebook B. Notebook B devuelve una carga útil de resultados que Notebook A está configurado para capturar y utilizar.

Cuaderno de notas A

result = oidlUtils.notebook.run("NotebookB", 0)
print("Output from Notebook B:", result)
Cuaderno B
import json

payload = {
"status": "SUCCESS",
"rows_processed": 1234,
"output_table": "sales_gold",
"run_id": "run_2026_02_11"
}

json_payload = json.dumps(payload)
oidlUtils.notebook.exit(str(json_payload))

Salida del Notebook B

{"status": "SUCCESS", "rows_processed": 1234, "output_table": "sales_gold", "run_id": "run_2026_02_11"}

Ejemplo 2: Transferencia de la salida a través de tareas de trabajo

En este ejemplo, devuelve un archivo JSON cuando el Notebook se ejecuta como una tarea: oidlUtils.notebook.exit(json.dumps(payload)). 

import json

payload = {
    "status": "SUCCESS",
    "output_table": "sales_gold",
    "rows_processed": 1234
}

oidlUtils.notebook.exit(json.dumps(payload))

A continuación, ejecute el trabajo con la tarea de bloc de notas y obtenga la salida de la tarea mediante la llamada de API: endpoint = f"https://<workspace-url>/jobs/runs/get-output?run_id={task_run_id}" and response = requests.get(endpoint, headers=headers).json(). 

import requests

task_run_id = "<task_run_id>"

endpoint = f"https://<workspace-url>/jobs/runs/get-output?run_id={task_run_id}"
response = requests.get(endpoint, headers=headers).json()

Por último, captura la salida devuelta por el bloc de notas con job_result = response['notebook_output']['result']. 

job_result = response["notebook_output"]["result"]
payload = json.loads(job_result)

print(payload["output_table"])   # Output : sales_gold
print(payload["rows_processed"]) # Output : 1234

Navegación por bloc de notas

Puede crear y mantener una tabla de contenido que se pueda utilizar para organizar y navegar por el bloc de notas.

Puede hacer clic en el icono de tabla de contenido en la parte superior izquierda de su bloc de notas para mostrar un esquema de bloc de notas. La tabla de contenido se genera automáticamente en función de los encabezados de rebaja que pueda crear, lo que permite una fácil organización y navegación.

Puede agregar texto con formato, encabezados, listas y documentación como Markdown para organizar y explicar el contenido del bloc de notas para usted y otros usuarios.

Crear una celda de rebaja

Puede crear celdas de rebaja para proporcionar encabezados en la tabla de contenido del bloc de notas para facilitar la organización y la navegación.

  1. En la página Inicio, acceda a su bloc de notas.
  2. En la lista desplegable de tipo de celda, seleccione Desplegable.
  3. Agregue la rebaja a la celda.
    • Las celdas de rebaja pueden incluir texto formateado, encabezados, listas y otra documentación.
    • Para crear un encabezado, inicie una línea con # seguida de un espacio. El encabezado 1 usa un #; el encabezado 2 usa ##. Agregue # adicional para cada nivel de cabecera adicional.

Resultados y salida del bloc de notas

Puede ver las salidas del bloc de notas y los resultados en una nueva celda que aparece justo después de la celda con código.

Mientras una celda está en curso, puede cancelar la ejecución de la celda. Si se ejecuta un bloc de notas como un trabajo de flujo de trabajo, la salida no estará visible en el mismo bloc de notas. En ese caso, la salida está visible en el área de salida de la ejecución del trabajo de flujo de trabajo correspondiente.

Puede descargar la salida de la celda de salida como un archivo CSV o Excel. También puede copiar el contenido de la celda de salida directamente en el portapapeles.


Celda de salida en un bloc de notas que se muestra con los botones Copiar y Descargar resaltados. El menú Descargar está abierto y muestra las opciones Descargar CSV y Descargar Excel.

Descargar salida de bloc de notas

Puede descargar la salida resultante de una celda de bloc de notas directamente desde el panel de resultados.

  1. En la parte superior derecha de la celda desde la que desea descargar la salida, haga clic en Descargar.
  2. En el menú, seleccione el formato con el que desea descargar la salida.

Copiar salida de bloc de notas

Puede copiar la salida resultante de una celda de bloc de notas directamente desde el panel de resultados.

  1. En la parte superior derecha de la celda desde la que desea descargar la salida, haga clic en Copiar.
  2. El contenido de la celda de salida se copia directamente en el portapapeles. Puede pegarlo en cualquier parte del bloc de notas o en una ubicación externa.

Apariencia de bloc de notas

Puede modificar el espacio de pantalla disponible para trabajar en blocs de notas minimizando el panel de navegación izquierdo o ampliando la vista de bloc de notas.

Puede minimizar el panel de navegación izquierdo del área de trabajo de Oracle AI Data Platform mientras trabaja en el bloc de notas para aumentar el espacio de pantalla utilizable haciendo clic en el panel Minimizar en la parte inferior derecha del panel de navegación.


Panel de navegación izquierdo de AI Data Platform Workbench con el ícono Minimizar panel resaltado

También puede ampliar el bloc de notas haciendo clic en Ampliar en la parte superior derecha del bloc de notas, ampliando el espacio disponible y haciendo que las celdas y salidas más grandes sean más fáciles de leer.


Cuaderno abierto con el icono Expandir resaltado

Números de ejecución de celda

Cada celda de bloc de notas muestra un número de ejecución que indica el orden en el que se ejecutaron las celdas. Este número se actualiza cada vez que se ejecuta la celda. Puede ejecutar celdas en cualquier orden, por lo que es posible que los números de ejecución no coincidan con el orden físico de las celdas de su bloc de notas.

Gestionar ejecuciones de trabajos

Puede crear ejecuciones de trabajos para gestionar cómo y cuándo se ejecuta el código desde los blocs de notas.

Las ejecuciones de trabajos manuales se pueden volver a ejecutar o configurar posteriormente para que se ejecuten según un programa. Las ejecuciones de trabajos programados se disparan automáticamente en función del programa que defina. A menos que se configure una programación, los trabajos manuales solo se ejecutan una vez.

Creación de un trabajo de ejecución manual desde un bloc de notas

Puede crear un trabajo no programado que se pueda ejecutar manualmente a partir del código que haya desarrollado en el bloc de notas.

  1. En la página inicial, haga clic en Espacio de trabajo.
  2. Vaya a su bloc de notas.
  3. Haga clic en Acciones y, a continuación, en Programar.
  4. Proporcione un nombre y una descripción para el trabajo.
  5. Haga clic en Examinar y seleccione la ubicación en la que desea almacenar el trabajo. Haga clic en Seleccionar.
  6. Seleccione un cluster de recursos informáticos en la lista desplegable Cluster.
  7. En Programar, seleccione Ejecución manual.
  8. Haga clic en Create.

Creación de una ejecución de trabajo programada a partir de un bloc de notas

Puede crear un trabajo programado que se ejecute automáticamente a partir del código que ha desarrollado en el bloc de notas.

  1. En la página inicial, haga clic en Espacio de trabajo.
  2. Vaya a su bloc de notas.
  3. Haga clic en Acciones y, a continuación, en Programar.
  4. Proporcione un nombre y una descripción para el trabajo.
  5. Haga clic en Examinar y seleccione la ubicación en la que desea almacenar el trabajo. Haga clic en Seleccionar.
  6. Seleccione un cluster de recursos informáticos en la lista desplegable Cluster.
  7. En Programar, seleccione Programar.
  8. Seleccione un Estado de programa.
    • Seleccione Activo si desea que el programa se active inmediatamente.
    • Seleccione En pausa si desea activar manualmente la ejecución programada más adelante.
  9. Proporcione una zona horaria en la que basar el programa.
  10. Seleccione el tipo de programa.
    • Para el calendario, debe especificar la frecuencia y las horas o días en los que se repetirá el programa.
    • Para Expresión cron, debe proporcionar el programa en forma de expresión cron.
  11. Compruebe el tiempo de ejecución mostrado en la parte inferior para confirmar que el programa es correcto. Haga clic en Create.

Métodos abreviados de teclado de bloc de notas

Puede utilizar métodos abreviados de teclado para simplificar el uso de comandos en el bloc de notas.

Windows macOS Acción
Ctrl + Intro Código + devolución Ejecutar Celda
Mayús + Intro Turno + Devolución Ejecutar celda y avanzar a la siguiente celda
Ctrl + S Cmd + S Guardar bloc de notas
Ctrl + N Ctrl + N Nuevo bloc de notas
Ctrl + Z Cmd + Z Deshacer
Ctrl + Y Cmd + Y Rehacer
Ctrl + C Cmd + C Copiar
Ctrl + X Código +X Cortar
Ctrl + V Cmd + V Pegar
Ctrl + Alt + F Ctrl + Opción + F Buscar y Sustituir
Ctrl + Mayús + A Ctrl + Mayús + A Insertar celdas arriba
Ctrl + Mayús + B Ctrl + Mayús + B Insertar celdas debajo
Ctrl + Alt + Arriba Ctrl + Opción + Arriba Mover celda hacia arriba
Ctrl + Alt + Abajo Ctrl + Opción + Abajo Mover celda hacia abajo
Ctrl + D Ctrl + D Eliminar celda
Alt + Mayús + Intro Opción + Turno + Devolución Ejecutar Todo
Alt + Mayús + Arriba Opción + Mayús + Arriba Ejecutar todas las celdas anteriores

Migración de código de Apache Spark existente al área de trabajo de la plataforma de datos de Oracle AI

Puede adaptar su código de Apache Spark para migrarlo para su uso en los blocs de notas de Oracle AI Data Platform Workbench.

Si va a migrar el código de Spark existente desde otras plataformas, puede utilizar las siguientes directrices para adaptar el código para su uso en blocs de notas.

Tabla 11-2 Directrices de migración de Apache Spark a AI Data Platform

Instrucción Detalles
Eliminar comandos de creación de SparkSession AI Data Platform Workbench crea automáticamente un SparkContext para cada cluster de recursos informáticos. Recomendamos eliminar los comandos de creación de sesión o sustituirlos por SparkSession.builder().getOrCreate().
Eliminar comandos de terminación de sesión, como sys.exit() o spark.stop() Todos los clusters de recursos informáticos son clusters compartidos, por lo que si algún usuario para SparkSession, mediante sys.exit() o spark.stop(), por ejemplo, el cluster se debe reiniciar para todos. Para evitar interrupciones, recomendamos evitar esos comandos en los blocs de notas.