Usar o editor de cadernos do Athena - Amazon Athena
Entender as sessões e os cálculos de cadernosAlternar entre o modo de comando e o modo de ediçãoUsar ações no menu do editor de cadernosUsar os atalhos de teclado do modo de comando para aumentar a produtividadePersonalizar os atalhos do modo de comando

Usar o editor de cadernos do Athena

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

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

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

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. 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 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 os detalhes de uma sessão, editar os parâmetros da sessão ou encerrá-la.

Usar os atalhos de teclado do modo de comando para aumentar a produtividade

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

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).

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

  3. 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.

Tópicos