Resultados e saídas do notebook

Depois de anexar um notebook a um cluster e executar uma ou mais células, seu notebook terá estado e exibirá saídas. Esta seção descreve como gerenciar as saídas e o estado do notebook.

Limpar as saídas e o estado dos notebooks

Para limpar o estado e as saídas do notebook, selecione uma das opções Limpar na parte inferior do menu Executar.

Opção de menu	Descrição
Limpar todas as saídas de célula	Limpa as saídas da célula. Isso será útil se você estiver compartilhando o notebook e não quiser incluir resultados.
Estado de limpeza	Limpa o estado do notebook, incluindo definições de função e variável, dados e bibliotecas importadas.
Limpar estado e resultados	Limpa as saídas da célula e o estado do notebook.
Limpar estado e executar tudo	Limpa o estado do notebook e inicia uma nova execução.

Mostrar resultados

Quando uma célula é executada, a tabela retorna no máximo 10.000 linhas ou 2 MB, o que for menor.

Por padrão, os resultados do texto retornam no máximo de 50.000 caracteres. Com o Databricks Runtime 12.2 LTS e superior, você pode aumentar esse limite definindo a propriedade spark.databricks.driver.maxReplOutputLength de configuração do Spark.

Explorar resultados de células SQL em notebooks Python nativamente usando Python

Você pode carregar dados usando SQL e explorá-los usando o Python. Em um notebook Python do Databricks, os resultados da tabela de uma célula de linguagem SQL são disponibilizados automaticamente como um DataFrame do Python. Para obter detalhes, confira Explorar os resultados da célula SQL em notebooks do Python.

Nova tabela de resultados de célula

Importante

Esse recurso está em uma versão prévia.

Agora você pode selecionar uma nova renderização da tabela de resultados da célula. Com a nova tabela de resultados, você pode fazer o seguinte:

• Copiar uma coluna ou outro subconjunto de resultados tabulares para a área de transferência.
• Fazer uma pesquisa de texto sobre a tabela de resultados.
• Classificar e filtrar dados.
• Navegar entre células de tabela usando as teclas de seta do teclado.
• Selecionar parte de um nome de coluna ou valor de célula clicando duas vezes e arrastando para selecionar o texto desejado.

Para habilitar a nova tabela de resultados, clique em Nova tabela de resultados no canto superior direito dos resultados da célula e altere o seletor de alternância de OFF para ON.

Quando o recurso estiver ativado, você poderá clicar em cabeçalhos de coluna ou linha para selecionar colunas ou linhas inteiras e clicar na célula superior esquerda da tabela para selecionar a tabela inteira. Você pode arrastar o cursor por qualquer conjunto retangular de células para selecioná-las.

Para copiar os dados selecionados para a área de transferência, pressione Cmd + c no MacOS ou Ctrl + c no Windows ou clique com o botão direito do mouse e selecione Copiar no menu suspenso.

Para pesquisar texto na tabela de resultados, insira o texto na caixa Pesquisar. As células correspondentes são realçadas.

Para abrir um painel lateral que exibe informações sobre a seleção, clique no ícone do painel ícone no canto superior direito, ao lado da caixa Pesquisar.

Cabeçalhos de coluna indicam o tipo de dados da coluna. Por exemplo, indica o tipo de dados inteiro. Passe o mouse sobre o indicador para ver o tipo de dados.

Classificar e filtrar resultados

Ao usar a nova renderização da tabela de resultados da célula, você pode classificar e filtrar os resultados.

Para classificar a tabela pelos valores em uma coluna, passe o cursor sobre o nome da coluna. À direita da célula que contém o nome da coluna, um ícone é exibido. Clique na seta para classificar a coluna. Cliques sucessivos alternando por meio da classificação em ordem crescente, em ordem decrescente ou não variada.

Para classificar por várias colunas, mantenha pressionada a tecla Shift enquanto clica na seta de classificação das colunas.

Para criar um filtro, clique no canto superior direito dos resultados da célula. Na caixa de diálogo exibida, selecione a coluna para filtrar e a regra de filtro e o valor a serem aplicados. Por exemplo:

Para adicionar outro filtro, clique em .

Para habilitar ou desabilitar temporariamente um filtro, alterne o botão Habilitado/Desabilitado na caixa de diálogo. Para excluir um filtro, clique no X ao lado do nome do filtro .

Para filtrar por um valor específico, clique com o botão direito do mouse em uma célula com esse valor e selecione Filtrar por esse valor no menu suspenso.

Você também pode criar um filtro no menu kebab no nome da coluna:

Os filtros são aplicados somente aos resultados mostrados na tabela de resultados. Se os dados retornados forem truncados (por exemplo, quando uma consulta retornar mais de 64.000 linhas), o filtro será aplicado somente às linhas retornadas.

Baixar os resultados

Por padrão, o download de resultados está habilitado. Para alternar essa configuração, consulte Gerenciar a capacidade de baixar resultados de notebooks.

Você pode baixar um resultado de célula que contém a saída tabular para seu computador local. Clique na seta apontando para baixo ao lado do título da guia. As opções de menu dependem do número de linhas no resultado e na versão do Databricks Runtime. Os resultados baixados são salvos no computador local como um arquivo CSV chamado export.csv.

Exibir várias saídas por célula

Os notebooks Python e células %python em notebooks não Python dão suporte a várias saídas por célula. Por exemplo, a saída do código a seguir inclui o gráfico e a tabela:

import pandas as pd
from sklearn.datasets import load_iris

data = load_iris()
iris = pd.DataFrame(data=data.data, columns=data.feature_names)
ax = iris.plot()
print("plot")
display(ax)
print("data")
display(iris)

Confirmar saídas de notebook em pastas Git do Databricks

Para saber como confirmar as saídas de notebooks .ipynb, confira Permitir a confirmação de saídas de notebooks .ipynb.

• O notebook precisa ser um arquivo .ipynb
• As configurações de administrador do espaço de trabalho precisam permitir que as saídas de notebooks sejam confirmadas.