# Usar o editor de cadernos do Athena
<a name="notebooks-spark-editor"></a>

**nota**  
O editor do caderno do Athena é compatível com a versão 3 do mecanismo Pyspark. Para usar cadernos com a versão 3.5 do Apache Spark, consulte [Cadernos do SageMaker](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/what-is-sagemaker-unified-studio.html).

Você gerencia seus cadernos no explorador de cadernos do Athena e os edita e executa em sessões usando o editor de cadernos do Athena. É possível configurar o uso da DPU para suas sessões de cadernos de acordo com seus requisitos.

Ao interromper um caderno, você encerra a sessão associada. Todos os arquivos serão salvos, mas as alterações em andamento nas variáveis, funções e classes declaradas serão perdidas. Quando você reinicia o caderno, o Athena recarrega os arquivos do caderno e você pode executar o código novamente.

O editor de cadernos do Athena é um ambiente interativo para gravar e executar códigos. As seções a seguir descrevem os recursos do ambiente.

## Entender as sessões e os cálculos de cadernos
<a name="notebooks-spark-sessions-and-calculations"></a>

Cada caderno está associado a um único kernel do Python e executa o código Python. Um caderno pode ter uma ou mais células que contêm comandos. Para executar as células em um caderno, primeiro crie uma sessão para ele. As sessões acompanham as variáveis ​​e o estado dos cadernos. 

Executar uma célula em um caderno significa executar um cálculo na sessão atual. Os cálculos avançam no estado do caderno e podem executar tarefas como leitura do Amazon S3 ou gravação para outros armazenamentos de dados. Enquanto uma sessão estiver em execução, os cálculos usam e modificam o estado que é mantido para o caderno.

Quando você não precisar mais do estado, poderá encerrar uma sessão. Ao encerrar uma sessão, o caderno permanecerá, mas as variáveis e outras informações de estado serão destruídas. Se você precisar trabalhar em diversos projetos ao mesmo tempo, poderá criar uma sessão para cada projeto, e as sessões serão independentes umas das outras.

As sessões têm capacidade de computação dedicada, que é medida em DPU. Ao criar uma sessão, é possível atribuir à sessão um número de DPUs. Sessões diferentes podem ter capacidades diferentes, dependendo dos requisitos para a tarefa.

## Alternar entre o modo de comando e o modo de edição
<a name="notebooks-spark-command-mode-vs-edit-mode"></a>

O editor de cadernos tem uma interface de usuário modal: um modo de edição para inserir texto em uma célula e um modo de comando para emitir comandos para o próprio editor, como copiar, colar ou executar.

Para usar o modo de edição e o modo de comando, você pode executar as tarefas a seguir:
+ Para entrar no modo de edição, pressione **ENTER** ou selecione uma célula. Quando uma célula está no modo de edição, ela tem uma margem esquerda na cor verde.
+ Para entrar no modo de comando, pressione **ESC** ou clique na parte exterior de uma célula. Observe que os comandos geralmente se aplicam somente à célula selecionada no momento, não a todas as células. Quando o editor está no modo de comando, a célula tem uma margem esquerda na cor azul.
+ No modo de comando, é possível usar atalhos de teclado e o menu acima do editor, mas não é possível inserir texto em células individuais.
+ Para selecionar uma célula, escolha a célula.
+ Para selecionar todas as células, pressione **Ctrl\+A** (Windows) ou **Cmd\+A** (Mac).

## Usar ações no menu do editor de cadernos
<a name="notebooks-spark-notebook-editor-menu"></a>

Os ícones no menu presente na parte superior do editor de cadernos oferecem as seguintes opções:
+ **Salvar**: salva o estado atual do caderno.
+ **Inserir célula abaixo**: adiciona uma nova célula (vazia) abaixo da célula selecionada no momento.
+ **Recortar células selecionadas**: remove a célula selecionada de sua localização atual e copia a célula para a memória.
+ **Copiar células selecionadas**: copia a célula selecionada para a memória.
+ **Colar células abaixo**: cola a célula copiada abaixo da célula atual.
+ **Mover as células selecionadas para cima**: move a célula atual acima da célula que está na posição acima.
+ **Mover as células selecionadas para baixo**: move a célula atual abaixo da célula que está na posição abaixo.
+ **Executar**: executa a célula atual (selecionada). A saída é exibida logo abaixo da célula atual.
+ **Executar tudo**: executa todas as células presentes no caderno. A saída para cada célula é exibida logo abaixo das respectivas células.
+ **Parar (interromper o kernel)**: interrompe o caderno atual ao interromper o kernel.
+ **Opção de formato**: seleciona o formato da célula, que pode ser um dos seguintes:
  + **Código**: use para códigos do Python (padrão).
  + **Markdown**: use para inserir texto no formato [markdown estilo GitHub](https://docs.github.com/en/get-started/writing-on-github). Para renderizar o markdown, realize a execução da célula.
  + **Raw NBConvert**: use para inserir texto em um formato não modificado. As células marcadas como **Raw NBConvert** podem ser convertidas em um formato diferente, como HTML, pela ferramenta de linha de comando [nbconvert](https://nbconvert.readthedocs.io/en/latest/usage.html) do Jupyter.
+ **Cabeçalho**: use para alterar o nível do cabeçalho da célula.
+ **Paleta de comandos**: contém comandos do caderno Jupyter e seus atalhos de teclado. Para obter mais informações sobre os atalhos de teclado, consulte as seções posteriores neste documento.
+ **Sessão**: use as opções desse menu para [visualizar](notebooks-spark-getting-started.md#notebooks-spark-getting-started-viewing-session-and-calculation-details) os detalhes de uma sessão, [editar os parâmetros da sessão](notebooks-spark-getting-started.md#notebooks-spark-getting-started-editing-session-details) ou [encerrá-la](notebooks-spark-getting-started.md#notebooks-spark-getting-started-terminating-a-session). 

## Usar os atalhos de teclado do modo de comando para aumentar a produtividade
<a name="notebooks-spark-command-mode-keyboard-shortcuts"></a>

A seguir estão alguns atalhos de teclado conhecidos do modo de comando do editor de cadernos. Esses atalhos estão disponíveis após pressionar **ESC** para entrar no modo de comando. Para visualizar uma lista completa de comandos disponíveis no editor, pressione **ESC \+ H**.


****  

| Chave | Ação | 
| --- | --- | 
| 1 - 6 | Alterar o tipo de célula para markdown e definir o nível do cabeçalho para o número digitado | 
| a | Criar uma célula acima da célula atual | 
| b | Criar uma célula abaixo da célula atual | 
| c | Copiar a célula atual para a memória | 
| d d | Excluir a célula atual | 
| h | Exibir a tela de ajuda para os atalhos de teclado | 
| j | Ir uma célula abaixo | 
| k | Ir uma célula acima | 
| m | Alterar o formato atual da célula para markdown | 
| r | Alterar o formato atual da célula para raw | 
| s | Salvar o caderno | 
| v | Colar o conteúdo da memória na célula atual | 
| x | Recortar a célula ou as células selecionadas | 
| y | Alterar o formato da célula para código | 
| z | Desfazer | 
| Ctrl\+Enter  | Executar a célula atual e entrar no modo de comando | 
| Shift\+Enter ou Alt\+Enter | Executar a célula atual e criar uma nova célula abaixo da saída, além de inserir a nova célula no modo de edição | 
| Space | Uma página abaixo | 
| Shift\+Space | Uma página acima | 
| Shift \+ L | Alternar a visibilidade dos números de linha nas células | 

## Personalizar os atalhos do modo de comando
<a name="notebooks-spark-editing-command-mode-shortcuts"></a>

O editor de cadernos tem a opção para personalizar os atalhos de teclado do modo de comando.

**Para editar atalhos do modo de comando**

1. No menu do editor de cadernos, escolha a **Command palette** (Paleta de comandos).

1. Na paleta de comandos, escolha o comando **Edit command mode keyboard shortcuts** (Editar atalhos de teclado do modo de comando).

1. Use a interface **Edit command mode shortcuts** (Editar atalhos do modo de comando) para mapear ou mapear novamente os comandos que você deseja para o teclado.

   Para visualizar as instruções para edição dos atalhos do modo de comando, role até a parte inferior da tela do **Edit command mode shortcuts** (Editar atalhos do modo de comando).

Para obter informações sobre como usar comandos magic no Athena para Apache Spark, consulte [Usar comandos mágicos](notebooks-spark-magics.md).

**Topics**
+ [Entender as sessões e os cálculos de cadernos](#notebooks-spark-sessions-and-calculations)
+ [Alternar entre o modo de comando e o modo de edição](#notebooks-spark-command-mode-vs-edit-mode)
+ [Usar ações no menu do editor de cadernos](#notebooks-spark-notebook-editor-menu)
+ [Usar os atalhos de teclado do modo de comando para aumentar a produtividade](#notebooks-spark-command-mode-keyboard-shortcuts)
+ [Personalizar os atalhos do modo de comando](#notebooks-spark-editing-command-mode-shortcuts)
+ [Usar comandos mágicos](notebooks-spark-magics.md)