Creación y ejecución de cuadernos

Puede utilizar cuadernos para organizar, anotar y compartir varias consultas SQL en un solo documento. Puede agregar varias celdas de consulta SQL y marcado a un cuaderno. Los cuadernos proporcionan una forma de agrupar consultas y explicaciones asociadas a un análisis de datos en un solo documento mediante varias celdas de consulta y Markdown. Puede agregar texto y dar formato a la apariencia mediante la sintaxis de Markdown para proporcionar contexto e información adicional para las tareas de análisis de datos. Puede compartir sus cuadernos con los miembros del equipo.

Para utilizar cuadernos, debe agregar el permiso para cuadernos a su entidad principal de IAM (un usuario o rol de IAM). Como práctica recomendada, aconsejamos asociar las políticas de permisos a un rol de IAM y luego asignarlo a los usuarios y grupos según sea necesario. Para obtener más información, consulte Administración de identidades y accesos en Amazon Redshift. Puede agregar el permiso a una de las políticas administradas del editor de consultas v2. Para obtener más información, consulte Acceso al editor de consultas v2.

Puede ejecutar todas las celdas de un cuaderno de forma secuencial. La celda de consulta SQL de un cuaderno tiene la mayoría de las mismas funciones que una pestaña del editor de consultas. Para obtener más información, consulte Creación y ejecución de consultas. A continuación, se indican las diferencias entre una pestaña del editor de consultas y una celda SQL de un cuaderno.

• No existe ningún control para ejecutar Explain en una instrucción SQL en un cuaderno.

• Solo puede crear un gráfico por cada celda SQL de un cuaderno.

Puede exportar e importar cuadernos a archivos creados con el editor de consultas v2. La extensión del archivo es .ipynb y el tamaño de archivo puede ser de un máximo de 5 MB. Las celdas SQL y Markdown se almacenan en el archivo. Un clúster o grupo de trabajo y la base de datos no están almacenados en el cuaderno exportado. Cuando abra un cuaderno importado, elija el clúster o grupo de trabajo y la base de datos donde ejecutarlo. Después de ejecutar las celdas SQL, puede elegir en la pestaña de resultados si desea mostrar la página actual de resultados como un gráfico. El conjunto de resultados de una consulta no se almacena en el cuaderno.

Si ejecuta un cuaderno, ya sea con Ejecutar todo o Ejecutar, aparecerá un panel Estado de ejecución. Seleccione el icono para abrir el panel. Este panel contiene un resumen del estado más reciente de las celdas SQL Ejecutar todo o Ejecutar del cuaderno. Si ejecuta varias celdas SQL, puede ver de un vistazo el estado, el tiempo transcurrido y algunos detalles sobre la ejecución. Puede filtrar las celdas que se muestran en función del estado: All, Succeeded, Error, In progress o Canceled. También puede usar este panel para navegar hasta una celda SQL del editor.

Para crear un cuaderno

1. En el menú del navegador, elija Editor de .

2. Elija y, a continuación, elija Notebook (Bloc de notas).

   De manera predeterminada, aparece una celda de consulta SQL en el cuaderno.

3. En la celda de consulta SQL, realice una de las siguientes acciones:

   • Ingrese una consulta.

   • Pegue una consulta que haya copiado.

4. (Opcional) Elija el icono y, a continuación, Markdown para agregar una celda de Markdown en la que puede proporcionar texto descriptivo o explicativo mediante la sintaxis de Markdown estándar.

5. (Opcional) Elija el icono y, a continuación, elija SQL para insertar una celda SQL.

Puede cambiar el nombre de los cuadernos mediante el icono (lápiz).

En el menú (más) también puede realizar las siguientes operaciones en un cuaderno:

• Share with my team (Compartir con mi equipo): compartir el cuaderno con su equipo definido por etiquetas. Para obtener más información, consulte Compartir una consulta

• Export (Exportar): exportar el cuaderno a un archivo local con la extensión .ipynb.

• Save version (Guardar versión): crear una versión del cuaderno. Para ver las versiones de un cuaderno, vaya a sus cuadernos guardados y abra Version history (Historial de versiones).

• Duplicate (Duplicar): crear una copia del cuaderno y abrirla en una nueva pestaña de cuaderno.

• Shortcuts (Accesos directos): mostrar los accesos directos disponibles al crear un cuaderno.

Para abrir un cuaderno guardado

1. En el menú del navegador, elija Notebooks (Cuadernos). Se muestran sus cuadernos y carpetas de cuadernos guardados.

2. Elija el cuaderno que desea abrir y haga doble clic en él.

Puede mostrar My notebooks (Mis cuadernos), los cuadernos Shared by me (Compartidos por mí) y los cuadernos Shared to my team (Compartidos con mi equipo) en la pestaña de cuadernos.

Para importar un cuaderno desde un archivo local a My notebooks (Mis cuadernos), elija Import (Importar) y navegue hasta el archivo .ipynb que contiene su cuaderno. El cuaderno se importa a la carpeta de cuadernos abierta en ese momento. A continuación, podrá abrir el cuaderno en el editor de cuadernos.

En el menú contextual (botón derecho del ratón) de un cuaderno puede realizar las siguientes operaciones:

• Open notebook (Abrir cuaderno): abrir el cuaderno en el editor.

• Save version (Guardar versión): guardar una versión del cuaderno.

• Version history (Historial de versiones): mostrar las versiones de un cuaderno. En la ventana Version history (Historial de versiones) puede eliminar y revertir versiones. También puede crear un cuaderno a partir de la versión seleccionada en ese momento.

• Edit tags (Editar etiquetas): crear y editar etiquetas en un cuaderno.

• Share with my team (Compartir con mi equipo): compartir un cuaderno con su equipo.

  Para compartir un cuaderno con su equipo, asegúrese de que tiene la etiqueta de entidad principal sqlworkbench-team establecida al mismo valor que el resto de los miembros de su equipo en su cuenta. Por ejemplo, un administrador podría establecer el valor en accounting-team para todos los miembros del departamento de contabilidad. Para ver un ejemplo, consulte Permisos necesarios para usar del editor de consultas v2 .

• Export (Exportar): exportar un cuaderno a un archivo local.

• Rename (Cambiar nombre): cambiar el nombre de un cuaderno.

• Duplicate (Duplicar): hacer una copia de un cuaderno.

• Delete (Eliminar): eliminar un cuaderno.

Para obtener una demostración de los blocs de notas, vea el siguiente video.