Uso del editor de cuadernos de Athena
Administre sus cuadernos en el explorador de cuadernos de Athena y edítelos y ejecútelos en sesiones con el editor de cuadernos de Athena. Puede configurar el uso de la DPU para las sesiones de su cuaderno según sus necesidades.
Al detener un cuaderno, se termina la sesión asociada. Se guardan todos los archivos, pero se pierden los cambios en curso en las variables, funciones y clases declaradas. Al reiniciar el cuaderno, Athena vuelve a cargar los archivos del cuaderno y puede volver a ejecutar el código.
El editor de cuadernos de Athena es un entorno interactivo para escribir y ejecutar código. En las siguientes secciones, se describen las características del entorno.
Comprensión de las sesiones de cuadernos y los cálculos
Cada cuaderno está asociado a un único núcleo de Python y ejecuta código Python. Un cuaderno puede tener una o más celdas que contengan comandos. Para ejecutar las celdas de un cuaderno, primero debe crear una sesión para el cuaderno. Las sesiones realizan un seguimiento de las variables y el estado de los cuadernos.
Ejecutar una celda en un cuaderno significa ejecutar un cálculo en la sesión actual. Los cálculos hacen avanzar el estado del cuaderno y pueden realizar tareas como leer desde Amazon S3 o escribir en otros almacenes de datos. Mientras se esté ejecutando una sesión, los cálculos utilizan y modifican el estado que se mantiene en el cuaderno.
Cuando ya no necesite el estado, puede finalizar una sesión. Al finalizar una sesión, el cuaderno permanece, pero las variables y el resto de información de estado se destruyen. Si necesita trabajar en varios proyectos al mismo tiempo, puede crear una sesión para cada proyecto y las sesiones serán independientes entre sí.
Las sesiones tienen una capacidad de cálculo dedicada, medida en DPU. Cuando crea una sesión, puede asignar a la sesión una cantidad de DPU. Las diferentes sesiones pueden tener diferentes capacidades según los requisitos de la tarea.
Cambio entre el modo de comando y el modo de edición
El editor de cuadernos tiene una interfaz de usuario modal: un modo de edición para ingresar texto en una celda y un modo de comandos para enviar comandos al propio editor, como copiar, pegar o ejecutar.
Para utilizar el modo de edición y el modo de comandos, puede realizar las siguientes tareas:
-
Para ingresar al modo de edición, pulse
ENTERo elija una celda. Cuando una celda está en modo de edición, su margen izquierdo está en verde. -
Para entrar en el modo de comandos, pulse
ESCo haga clic fuera de una celda. Tenga en cuenta que, normalmente, los comandos solo se aplican a la celda seleccionada actualmente, no a todas las celdas. Cuando el editor está en modo de comandos, el margen izquierdo de la celda está en azul. -
En el modo de comandos, puede utilizar los atajos de teclado y el menú situado encima del editor, pero no puede ingresar texto en celdas individuales.
-
Para seleccionar una celda, elíjala.
-
Para seleccionar todas las celdas, pulse
Ctrl+A(Windows) oCmd+A(Mac).
Uso de las acciones del menú del editor del cuaderno
Los iconos del menú situados en la parte superior del editor de cuadernos ofrecen las siguientes opciones:
-
Save (Guardar): guarda el estado actual del cuaderno.
-
Insert cell below (Insertar celda debajo): agrega una celda nueva (vacía) debajo de la seleccionada actualmente.
-
Cut selected cells (Suprimir celdas seleccionadas): elimina la celda seleccionada de su ubicación actual y la copia en la memoria.
-
Copy selected cells (Copiar celdas seleccionadas): copia la celda seleccionada en la memoria.
-
Paste cells below (Pegar celdas debajo): pega la celda copiada debajo de la celda actual.
-
Move selected cells up (Mover celdas seleccionadas hacia arriba): sitúa la celda actual encima de la celda superior.
-
Move selected cells down (Mover celdas seleccionadas hacia abajo): sitúa la celda actual debajo de la celda inferior.
-
Run (Ejecutar): ejecuta la celda actual (seleccionada). El resultado se muestra justo debajo de la celda actual.
-
Run all (Ejecutar todo): ejecuta todas las celdas del cuaderno. El resultado de cada celda se muestra justo debajo de la celda.
-
Stop (Interrupt the kernel) (Detener [interrumpir el kernel]): interrumpe el kernel para detener el cuaderno actual.
-
Format option (Opción de formato): selecciona el formato de celda, que puede ser uno de los siguientes:
-
Code: se usa para código Python (predeterminado).
-
Markdown: se usa para ingresar texto en formato Markdown al estilo de GitHub
. Para renderizar el Markdown, ejecute la celda. -
Raw NBConvert: se usa para ingresar texto en forma no modificada. Las celdas marcadas como Raw NBConvert se pueden convertir a un formato diferente, como HTML, mediante la herramienta de línea de comandos nbconvert
de Jupyter.
-
-
Heading (Encabezado): se usa para cambiar el nivel del encabezado de la celda.
-
Command palette (Paleta de comandos): contiene los comandos del cuaderno de Jupyter y sus atajos de teclado. Para obtener más información acerca de los atajos de teclado, consulte las secciones que aparecen más adelante en este documento.
-
Session (Sesión): utilice las opciones de este menú para ver los detalles de una sesión, editar los parámetros de la sesión o terminar la sesión.
Uso de atajos de teclado en modo de comando para aumentar la productividad
A continuación, se presentan algunos atajos de teclado habituales de un editor de cuadernos en el modo de comandos. Estos atajos están disponibles después de pulsar ESC para ingresar al modo de comandos. Para ver una lista completa de los comandos disponibles en el editor, pulse ESC +
H.
| Clave | Acción |
|---|---|
1 - 6 |
Cambiar el tipo de celda a Markdown y establecer el nivel del encabezado en el número escrito |
a |
Crear una celda encima de la celda actual |
b |
Crear una celda debajo de la celda actual |
c |
Copiar la celda actual en memoria |
d d |
Eliminar la celda actual |
h |
Mostrar la pantalla de ayuda de los atajos de teclado |
j |
Ir una celda más abajo |
k |
Ir una celda más arriba |
m |
Cambiar el formato de celda actual a Markdown |
r |
Cambiar el formato de celda actual a Raw |
s |
Guardar el cuaderno |
v |
Pegar el contenido de la memoria en la celda actual |
x |
Cortar la celda o las celdas seleccionadas |
y |
Cambiar el formato de celda a Code |
z |
Deshacer |
Ctrl+Enter |
Ejecutar la celda actual e ingresar al modo de comandos |
Shift+Enter o Alt+Enter |
Ejecutar la celda actual, crear una nueva debajo de la salida y hacer que ingrese al modo de edición |
Space |
Página siguiente |
Shift+Space |
Página anterior |
Shift + L |
Para alternar la visibilidad de los números de línea en las celdas |
Personalización de los atajos del modo de comandos
El editor de cuadernos tiene una opción para personalizar los atajos de teclado del modo de comandos.
Para editar los atajos del modo de comandos
-
En el menú del editor de cuadernos, elija Command palette (Paleta de comandos).
-
En la paleta de comandos, elija el comando Edit command mode keyboard shortcuts (Editar atajos de teclado del modo de comandos).
-
Utilice la interfaz Edit command mode shortcuts (Editar atajos del modo de comandos) para asignar o reasignar los comandos que desee al teclado.
Para ver las instrucciones sobre cómo editar los atajos del modo de comandos, desplácese hasta la parte inferior de la pantalla Edit command mode shortcuts (Editar atajos del modo de comandos).
Para obtener información sobre el uso de comandos mágicos en Athena para Apache Spark, consulte Uso de comandos mágicos.
