

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Uso de los Cuadernos de EMR
<a name="emr-managed-notebooks-working-with"></a>

**nota**  
Cuadernos de EMR está disponible como Espacios de trabajo de EMR Studio en la nueva consola. El botón **Crear espacio de trabajo** de la consola le permite crear nuevos cuadernos. Para crear espacios de trabajo o acceder a ellos, los usuarios de Cuadernos de EMR necesitan permisos de rol de IAM adicionales. Para obtener más información, consulte [Cuadernos de Amazon EMR es Espacios de trabajo de Amazon EMR Studio en la consola](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-managed-notebooks-migration.html) y [Consola Amazon EMR](https://docs.aws.amazon.com/emr/latest/ManagementGuide/whats-new-in-console.html).

Después de crear un cuaderno de EMR, el cuaderno tarda unos momentos en iniciarse. El campo **Status (Estado)** de la lista **Notebooks (Blocs de notas)** muestra **Starting (Comenzando)**. Puede abrir un bloc de notas cuando su estado sea **Ready (Listo)**. Es posible que el bloc de notas tarde algo más de tiempo en estar **Ready (Listo)** si lo ha creado al mismo tiempo que un clúster.

**sugerencia**  
Actualice el navegador o elija el icono de actualización situado encima de la lista de blocs de notas para actualizar el estado del bloc de notas.

## Descripción de los estados del cuaderno
<a name="emr-managed-notebooks-status"></a>

Un cuaderno de EMR puede tener los siguientes valores en el campo **Estado** de la lista **Cuadernos**.


| Status | Significado | 
| --- | --- | 
|  Ready  |  Puede abrir el bloc de notas con el editor de blocs de notas. Mientras el bloc de notas tenga el estado **Ready (Listo)**, puede detenerlo o eliminarlo. Para cambiar de clúster, primero debe detener el bloc de notas. Si un bloc de notas que se encuentra en el estado **Ready (Listo)** está inactivo durante un periodo prolongado de tiempo, se detiene automáticamente.  | 
|  Inicio  |  El bloc de notas se está creando y asociando al clúster. Mientras se inicia un bloc de notas, no se puede abrir el editor de blocs de notas, detenerlo, eliminarlo ni cambiar de clúster.  | 
|  Pending (Pendiente)  |  El bloc de notas se ha creado y está esperando a que finalice la integración con el clúster. El clúster puede estar todavía aprovisionando recursos o respondiendo a otras solicitudes. Puede abrir el editor de blocs de notas con el bloc de notas en *modo local*. El código que se basa en los procesos del clúster no se ejecuta y genera un error.  | 
|  Detención  |  El bloc de notas se está cerrando o el clúster al que está asociado se está terminando. Mientras se detiene un bloc de notas, no se puede abrir el editor de blocs de notas, detenerlo, eliminarlo ni cambiar de clúster.  | 
|  Stopped  |  El bloc de notas se ha cerrado. Puede iniciar el bloc de notas en el mismo clúster, siempre que este siga ejecutándose. Puede cambiar de clúster y eliminar el clúster.  | 
|  Eliminación  |  El clúster se está eliminando de la lista de clústeres disponibles. El archivo del cuaderno, `NotebookName.ipynb `, permanece en Amazon S3 y continúa acumulando los cargos de almacenamiento correspondientes.  | 

## Uso del editor de cuadernos
<a name="emr-managed-notebooks-editor"></a>

Una ventaja de usar un cuaderno EMR es que puedes iniciar el cuaderno en Jupyter o JupyterLab directamente desde la consola.

Con EMR Notebooks, el editor de cuadernos al que puede acceder desde la consola Amazon EMR es el conocido editor Jupyter Notebook de código abierto o. JupyterLab Dado que el editor de cuadernos se lanza en la consola de Amazon EMR, resulta más eficaz configurar el acceso que en el caso de un cuaderno alojado en un clúster de Amazon EMR. No es necesario configurar el cliente del usuario para poder disponer de acceso web a través de SSH, reglas de grupos de seguridad y configuraciones de proxy. Si el usuario tiene permisos suficientes, solo tiene que abrir el editor de cuadernos en la consola de Amazon EMR.

Solo un usuario puede abrir un cuaderno de EMR a la vez desde Amazon EMR. Si otro usuario intenta abrir un cuaderno de EMR que ya está abierto, se produce un error.

**importante**  
Amazon EMR crea una URL prefirmada única para cada sesión del editor de cuadernos, que es válida solamente durante un breve periodo. Le recomendamos que no comparten la URL del editor de bloc de notas. De hacerlo se crea un riesgo de seguridad ya que los destinatarios de la URL adoptan sus permisos para editar el bloc de notas y ejecutar el código del bloc de notas durante la vida útil de la URL. Si otras personas necesitan acceso a un cuaderno, proporcione permisos a su usuario mediante políticas de permisos y asegúrese de que el rol de servicio de Cuadernos de EMR tenga acceso a la ubicación de Amazon S3. Para obtener más información, consulte [Control de acceso y seguridad de los cuadernos de EMR](emr-managed-notebooks-security.md) y [Rol de servicio para Cuadernos de Amazon EMR](emr-managed-notebooks-service-role.md).

**Para abrir el editor de cuadernos con un cuaderno de EMR**

1. Seleccione un bloc de notas cuyo **Estado** sea **Listo** o **Pendiente** en la lista **Blocs de notas**.

1. **Seleccione **Abrir en o Abrir** en Jupyter. JupyterLab**

   Se abre una nueva pestaña del navegador en el editor JupyterLab o en el editor de Jupyter Notebook.

1. En el menú **Kernel**, elija **Change kernel (Cambiar kernel)** y, a continuación, seleccione el kernel correspondiente al lenguaje de programación que utilice.

   Ahora está preparado para escribir y ejecutar código desde el editor de blocs de notas.

### Cómo guardar el contenido de un cuaderno
<a name="emr-managed-notebooks-saving"></a>

Cuando se trabaja en el editor de cuadernos, el contenido de las celdas del cuaderno y la salida se guardan automáticamente de forma periódica en el archivo del cuaderno en Amazon S3. Un bloc de notas que no ha sufrido cambios desde la última vez que se ha editado una celda muestra la cadena **(autosaved) (guardado automático)** junto al nombre del bloc de notas en el editor. Si los cambios no se han guardado todavía, aparece la cadena **unsaved changes (cambios sin guardar)**.

Puede guardar un bloc de notas manualmente. En el menú **Archivo**, seleccione **Guardar y establecer punto de control** o pulse CTRL \$1 S. De este modo, se crea un archivo denominado `NotebookName.ipynb` en una carpeta de **puntos de control** dentro de la carpeta del cuaderno en Amazon S3. Por ejemplo, `s3://amzn-s3-demo-bucket/MyNotebookFolder/NotebookID/checkpoints/NotebookName.ipynb`. En esta ubicación, solo se guarda el archivo de punto de comprobación más reciente.

## Cambio de clústeres
<a name="emr-managed-notebooks-changing-clusters"></a>

Puede cambiar el clúster al que está asociado un cuaderno de EMR sin cambiar el contenido del propio cuaderno. Solo se pueden cambiar de clúster los blocs de notas que tengan el estado **Stopped (Detenido)**.

**Para cambiar el clúster de un cuaderno de EMR**

1. Si el bloc de notas que desea cambiar se está ejecutando, selecciónelo en la lista **Notebooks (Blocs de notas)** y elija **Stop (Detener)**.

1. Cuando el estado del bloc de notas sea **Stopped (Detenido)**, selecciónelo en la lista **Notebooks (Blocs de notas)** y, a continuación, elija **View details (Ver detalles)**.

1. Elija **Change cluster (Cambiar clúster)**.

1. Si tiene un clúster activo que ejecuta Hadoop, Spark y Livy al que desea asociar el bloc de notas, deje el valor predeterminado y seleccione un clúster en la lista. En la lista solo aparecerán los clústeres que cumplan los requisitos.

   —o—

   Elija **Create a cluster (Crear clúster)** y, a continuación, elija las opciones del clúster. Para obtener más información, consulte [Requisitos del clúster](emr-managed-notebooks-considerations.md#considerations-limitations).

1. Elija una opción para **Security groups (Grupos de seguridad)** y, a continuación, elija **Change cluster and start notebook (Cambiar clúster e iniciar bloc de notas)**.

## Eliminación de cuadernos y archivos de cuadernos
<a name="emr-managed-notebooks-deleting"></a>

Cuando se elimina un cuaderno de EMR mediante la consola de Amazon EMR, se elimina el cuaderno de la lista de cuadernos disponibles. Sin embargo, los archivos de cuadernos permanecen en Amazon S3 y continúan acumulando cargos de almacenamiento.

**Para eliminar un bloc de notas y sus archivos asociados**

1. Abra la consola de Amazon EMR en [https://console.aws.amazon.com/elasticmapreduce/](https://console.aws.amazon.com/elasticmapreduce/).

1. Elija **Notebooks (Blocs de notas)**, seleccione el bloc de notas en la lista y, a continuación, elija **View details (Ver detalles)**.

1. Elija el icono de carpeta que se encuentra junto a **Notebook location (Ubicación del bloc de notas)** y copie la **URL**, que tiene el patrón `s3://MyNotebookLocationPath/NotebookID/`.

1. Elija **Eliminar**.

   El bloc de notas se elimina de la lista y los detalles de este ya no se pueden consultar.

1. Siga las instrucciones de [¿Cómo elimino carpetas de un bucket de S3?](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-folders.html) en la Guía del usuario de Amazon Simple Storage Service. Vaya al bucket y la carpeta del paso 3.

   —o—

   Si lo tiene AWS CLI instalado, abra una línea de comandos y escriba el comando al final de este párrafo. Sustituya la ubicación de Amazon S3 por la ubicación que ha copiado anteriormente. Asegúrese de que AWS CLI está configurado con las claves de acceso de un usuario con permisos para eliminar la ubicación de Amazon S3. Para obtener más información, consulte [Configuración de la AWS CLI](https://docs.aws.amazon.com/AmazonS3/latest/userguide/cli-chap-getting-started.html) en la *Guía del usuario de AWS Command Line Interface *.

   ```
   aws s3 rm s3://MyNotebookLocationPath/NotebookID
   ```

## Uso compartido de archivos de cuadernos
<a name="emr-managed-notebooks-file-sharing"></a>

Cada cuaderno de EMR se guarda en Amazon S3 como un archivo denominado `NotebookName.ipynb`. Siempre que un archivo de cuaderno sea compatible con la misma versión de Cuaderno de Jupyter en la que está basado Cuadernos de EMR, puede abrir el cuaderno como un cuaderno de EMR.

La forma más sencilla de abrir un archivo de bloc de notas de otro usuario es guardar el archivo\$1.ipynb de otro usuario en el sistema de archivos local y, a continuación, utilizar la función de carga en Jupyter y en los editores. JupyterLab 

Puede emplear este proceso para utilizar blocs de notas de EMR compartidos por otros usuarios, blocs de notas compartidos en la comunidad de Jupyter o para restaurar un bloc de notas que se ha eliminado de la consola mientras aún se conserva el archivo de bloc de notas.

**Para utilizar un archivo de cuaderno diferente como base de un cuaderno de EMR**

1. Antes de continuar, cierre el editor de cuadernos para los cuadernos con los que va a trabajar y, a continuación, detenga el cuaderno si se trata de un cuaderno de EMR.

1. Cree un cuaderno de EMR y asígnele un nombre. El nombre que escriba para el bloc de notas será el nombre del archivo que necesita reemplazar. El nombre de archivo nuevo debe coincidir exactamente con el nombre de este archivo.

1. Anote la ubicación en Amazon S3 que ha elegido para el cuaderno. El archivo que va a sustituir está en una carpeta con una ruta y un nombre de archivo que tienen el siguiente patrón: `s3://MyNotebookLocation/NotebookID/MyNotebookName.ipynb`.

1. Detenga el bloc de notas.

1. Sustituya el antiguo archivo de cuaderno en la ubicación de Amazon S3 por el nuevo y utilice exactamente el mismo nombre.

   El siguiente AWS CLI comando para Amazon S3 reemplaza un archivo guardado en una máquina local llamada bloc de notas EMR `SharedNotebook.ipynb` por el nombre **MyNotebook**, un identificador y con el que se creó `amzn-s3-demo-bucket/MyNotebooksFolder` especificados en Amazon S3. `e-12A3BCDEFJHIJKLMNO45PQRST` Para obtener más información sobre el uso de la consola de Amazon S3 para copiar y reemplazar archivos, consulte [Carga, descarga y administración de objetos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-download-objects.html) en la *Guía del usuario de Amazon Simple Storage Service*.

   ```
   aws s3 cp SharedNotebook.ipynb s3://amzn-s3-demo-bucket/MyNotebooksFolder/-12A3BCDEFJHIJKLMNO45PQRST/MyNotebook.ipynb
   ```