Skip to main content
A interface web SQL integrada (play.html, disponibilizada no caminho /play de qualquer porta HTTP do ClickHouse) pode manter visíveis as colunas escolhidas de um resultado enquanto o restante da tabela é rolado horizontalmente. Uma coluna fixada fica presa à borda mais próxima da área de resultados em vez de sair de vista com a rolagem, de modo que uma coluna-chave — um identificador, um nome, uma data — continue visível ao lado das colunas mais à direita que você estiver lendo.

Fixando uma coluna

Um ícone de 📌 aparece à esquerda do cabeçalho de cada coluna. Clique nele para fixar a coluna; clique novamente para desafixá-la. O ícone é um botão de verdade, portanto quem usa teclado pode navegar até ele com a tecla Tab e acioná-lo pelo teclado, e ele expõe seu estado fixado às tecnologias assistivas. Em dispositivos com ponteiro que permite hover (como um mouse), o ícone é mostrado apenas quando o cursor está sobre o cabeçalho ou quando o toggle está em foco, para não atrapalhar nos demais casos; em dispositivos touch e outros com ponteiro impreciso, que não têm hover, o ícone é sempre exibido para que possa ser tocado diretamente. Uma coluna fixada mantém o ícone sempre visível e com intensidade total, indicando que a coluna está fixada.

Quando a fixação está disponível

A fixação só está disponível quando a tabela é larga o suficiente para permitir rolagem horizontal. Quando a tabela inteira cabe na área de visualização, não há nada para ocultar com a rolagem; por isso, o toggle de fixação fica desabilitado e é removido da ordem de tabulação do teclado. Assim que o resultado passa a permitir rolagem horizontal — seja por ser um resultado largo, uma janela estreita ou um resultado em stream que cresce horizontalmente — os toggles ficam ativos.

Como uma coluna fixada se comporta durante a rolagem

Uma coluna fixada se move com o conteúdo durante a rolagem horizontal até o momento em que sairia da área visível; nesse ponto, ela se fixa na borda mais próxima — a borda esquerda para colunas à esquerda e a borda direita para colunas à direita — e permanece visível. Várias colunas fixadas se alinham junto à borda na ordem original, cada uma separada do conteúdo em rolagem por uma borda. Uma célula fixada é exibida sobre as células comuns que passam por baixo dela durante a rolagem, inclusive uma célula selecionada, para que permaneça sempre legível.

Compartilhado em um resultado

As fixações são controladas pelo nome da coluna e compartilhadas entre as tabelas de resultados que pertencem a um mesmo resultado — uma execução de Run all (várias consultas) renderiza uma tabela por instrução, e todas elas compartilham o mesmo conjunto de colunas fixadas —, assim como acontece com os modos de codificação por cores por coluna. Fixar uma coluna chamada id em uma dessas tabelas mantém fixada a coluna chamada id nas demais e em execuções posteriores da mesma consulta que retornem essa mesma coluna. O conjunto de colunas fixadas pertence ao resultado ao qual se aplica: à aba da consulta e, no caso de uma aba que seja um notebook, a cada célula individualmente. Portanto, fixar uma coluna em uma célula não afeta as demais células — nem as outras abas —, que mantêm suas próprias fixações independentes.

Persistência

O conjunto de colunas fixadas fica registrado na URL da página, no histórico do navegador e no snapshot de resultados da célula à qual pertence; assim, recarregar a página, compartilhar o link ou navegar para trás e para frente o preserva. Fixar ou desafixar uma coluna em uma célula que não está com o editor aberto no momento também atualiza a cópia salva dessa célula, de modo que o estado é mantido após recarregar a página. Somente as colunas fixadas são armazenadas — um conjunto vazio não adiciona nada à URL nem ao estado do histórico — para mantê-las compactas.

Limitações

  • A visualização vertical (transposta) de uma única linha não tem colunas com rolagem horizontal, portanto não permite fixar colunas.
Última modificação em 23 de julho de 2026