SQL Console

Execute consultas e crie visualizações com o SQL Console.

O SQL Console é a maneira mais rápida e fácil de explorar e consultar seus bancos de dados no ClickHouse Cloud. Você pode usar o SQL Console para:

• Conectar-se aos seus serviços do ClickHouse Cloud
• Visualizar, filtrar e ordenar dados de tabelas
• Executar consultas e visualizar os resultados com apenas alguns cliques
• Compartilhar consultas com membros da equipe e colaborar de forma mais eficaz.

​

Explorar tabelas

​

Visualizando a lista de tabelas e informações de esquema

Uma visão geral das tabelas contidas na sua instância do ClickHouse pode ser encontrada na barra lateral esquerda. Use o seletor de banco de dados na parte superior da barra lateral esquerda para visualizar as tabelas em um banco de dados específico

As tabelas na lista também podem ser expandidas para visualizar colunas e tipos

​

Explorando os dados da tabela

Clique em uma tabela na lista para abri-la em uma nova guia. Na Visualização da tabela, é possível visualizar, selecionar e copiar os dados com facilidade. Observe que a estrutura e a formatação são preservadas ao copiar e colar em aplicativos de planilha, como Microsoft Excel e Google Sheets. Você pode navegar entre as páginas de dados da tabela (paginadas em blocos de 30 linhas) usando a navegação no rodapé.

​

Inspecionando os dados da célula

A ferramenta Cell Inspector pode ser usada para visualizar grandes volumes de dados contidos em uma única célula. Para abri-la, clique com o botão direito em uma célula e selecione ‘Inspecionar célula’. O conteúdo do Cell Inspector pode ser copiado clicando no ícone de cópia no canto superior direito do inspetor.

​

Filtrar e ordenar tabelas

​

Ordenando uma tabela

Para ordenar uma tabela no SQL Console, abra uma tabela e selecione o botão ‘Sort’ na barra de ferramentas. Esse botão abrirá um menu que permitirá configurar a ordenação. Você pode escolher a coluna pela qual deseja ordenar e definir a ordem da ordenação (crescente ou decrescente). Selecione ‘Apply’ ou pressione Enter para ordenar a tabela

O SQL Console também permite adicionar várias ordenações a uma tabela. Clique no botão ‘Sort’ novamente para adicionar outra ordenação.

As ordenações são aplicadas na ordem em que aparecem no painel de ordenação (de cima para baixo). Para remover uma ordenação, basta clicar no botão ‘x’ ao lado dela.

​

Filtrando uma tabela

Para filtrar uma tabela no SQL Console, abra uma tabela e selecione o botão ‘Filter’. Assim como na ordenação, esse botão abrirá um menu que permitirá configurar o filtro. Você pode escolher uma coluna para filtrar e selecionar os critérios necessários. O SQL Console exibe de forma inteligente opções de filtro que correspondem ao tipo de dado contido na coluna.

Quando estiver satisfeito com o filtro, você pode selecionar ‘Apply’ para filtrar os dados. Também é possível adicionar filtros extras, como mostrado abaixo.

Assim como na funcionalidade de ordenação, clique no botão ‘x’ ao lado de um filtro para removê-lo.

​

Filtragem e ordenação ao mesmo tempo

O SQL Console permite filtrar e ordenar uma tabela ao mesmo tempo. Para fazer isso, adicione todos os filtros e ordenações desejados usando as etapas descritas acima e clique no botão ‘Apply’.

​

Criando uma consulta a partir de filtros e ordenações

O SQL Console pode converter suas ordenações e filtros diretamente em consultas com um clique. Basta selecionar o botão ‘Create Query’ na barra de ferramentas com os parâmetros de ordenação e filtro que desejar. Após clicar em ‘Create query’, uma nova aba de consulta será aberta já preenchida com o comando SQL correspondente aos dados contidos na visualização da tabela.

Filtros e ordenações não são obrigatórios ao usar o recurso ‘Create Query’.

Você pode saber mais sobre como fazer consultas no SQL Console lendo a documentação sobre consultas em (link).

​

Criar e executar uma consulta

​

Criando uma consulta

Há duas maneiras de criar uma nova consulta no SQL Console.

• Clique no botão ’+’ na barra de abas
• Selecione o botão ‘New Query’ na lista de consultas da barra lateral esquerda

​

Executando uma consulta

Para executar uma consulta, digite seu comando SQL ou seus comandos SQL no SQL Editor e clique no botão ‘Run’ ou use o atalho cmd / ctrl + enter. Para escrever e executar vários comandos em sequência, adicione um ponto e vírgula após cada comando.

Opções de execução de consultas Por padrão, ao clicar no botão Run, todos os comandos contidos no SQL Editor serão executados. O SQL Console oferece outras duas opções de execução de consultas:

• Executar comandos selecionados
• Executar o comando na posição do cursor

Para executar comandos selecionados, selecione o comando ou a sequência de comandos desejada e clique no botão ‘Run’ (ou use o atalho cmd / ctrl + enter). Você também pode selecionar ‘Run selected’ no menu de contexto do SQL Editor (aberto ao clicar com o botão direito em qualquer lugar do editor) quando houver uma seleção.

A execução do comando na posição atual do cursor pode ser feita de duas maneiras:

• Selecione ‘At Cursor’ no menu expandido de opções de execução (ou use o atalho de teclado correspondente cmd / ctrl + shift + enter

• Selecione ‘Run at cursor’ no menu de contexto do SQL Editor

O comando na posição do cursor piscará em amarelo quando for executado.

​

Cancelando uma consulta

Enquanto uma consulta estiver em execução, o botão ‘Run’ na barra de ferramentas do Query Editor será substituído pelo botão ‘Cancel’. Basta clicar nesse botão ou pressionar Esc para cancelar a consulta. Observação: todos os resultados que já tiverem sido retornados permanecerão após o cancelamento.

​

Salvando uma consulta

Salvar consultas permite encontrá-las facilmente depois e compartilhá-las com sua equipe. O SQL Console também permite organizar suas consultas em pastas.

Para salvar uma consulta, basta clicar no botão “Save”, imediatamente ao lado do botão “Run” na barra de ferramentas. Digite o nome desejado e clique em “Save Query”.

Usar o atalho cmd / ctrl + s também salvará qualquer alteração na aba da consulta atual.

Como alternativa, você pode nomear e salvar uma consulta ao mesmo tempo clicando em “Untitled Query” na barra de ferramentas, ajustando o nome e pressionando Enter:

​

Compartilhamento de consultas

O SQL Console permite compartilhar consultas facilmente com os membros da sua equipe. O SQL Console oferece quatro níveis de acesso, que podem ser ajustados globalmente e por usuário:

• Proprietário (pode ajustar as opções de compartilhamento)
• Acesso de escrita
• Acesso somente leitura
• Sem acesso

Depois de salvar uma consulta, clique no botão “Share” na barra de ferramentas. Um modal com opções de compartilhamento será exibido:

Para ajustar o acesso à consulta para todos os membros da organização com acesso ao serviço, basta ajustar o seletor de nível de acesso na primeira linha:

Após aplicar essa configuração, a consulta poderá ser visualizada (e executada) por todos os membros da equipe com acesso ao SQL Console do serviço.

Para ajustar o acesso à consulta para membros específicos, selecione o membro desejado da equipe no seletor “Add a team member”:

Após selecionar um membro da equipe, uma nova linha deverá aparecer com um seletor de nível de acesso:

​

Acessando consultas compartilhadas

Se uma consulta tiver sido compartilhada com você, ela aparecerá na aba “Queries” da barra lateral esquerda do SQL console:

​

Link para uma consulta (permalinks)

As consultas salvas também têm permalinks, o que significa que você pode enviar e receber links de consultas compartilhadas e abri-las diretamente.

Os valores de todos os parâmetros presentes em uma consulta são adicionados automaticamente à URL da consulta salva como query parameters. Por exemplo, se uma consulta contiver os parâmetros {start_date: Date} e {end_date: Date}, o permalink pode ter a seguinte aparência: https://console.clickhouse.cloud/services/:serviceId/console/query/:queryId?param_start_date=2015-01-01&param_end_date=2016-01-01.

​

Recursos avançados de consulta

​

Pesquisando resultados de consultas

Depois que uma consulta é executada, você pode pesquisar rapidamente no conjunto de resultados retornado usando o campo de pesquisa no painel de resultados. Esse recurso ajuda a visualizar os resultados de uma cláusula WHERE adicional ou simplesmente verificar se dados específicos estão incluídos no conjunto de resultados. Depois de inserir um valor no campo de pesquisa, o painel de resultados será atualizado e retornará registros que contenham uma entrada correspondente ao valor informado. Neste exemplo, vamos procurar todas as ocorrências de breakfast na tabela hackernews em comentários que contenham ClickHouse (sem diferenciar maiúsculas de minúsculas):

Observação: qualquer campo que corresponda ao valor informado será retornado. Por exemplo, o terceiro registro na captura de tela acima não corresponde a ‘breakfast’ no campo by, mas o campo text corresponde:

​

Ajustando as configurações de paginação

Por padrão, o painel de resultados da consulta exibe todos os registros do resultado em uma única página. Para conjuntos de resultados maiores, pode ser preferível paginar os resultados para facilitar a visualização. Isso pode ser feito usando o seletor de paginação no canto inferior direito do painel de resultados:

Ao selecionar um tamanho de página, a paginação será aplicada imediatamente ao conjunto de resultados, e as opções de navegação aparecerão no centro do rodapé do painel de resultados

​

Exportando dados do resultado da consulta

Os resultados das consultas podem ser exportados facilmente no formato CSV diretamente do SQL Console. Para fazer isso, abra o menu ••• no lado direito da barra de ferramentas do painel de resultados e selecione ‘Baixar como CSV’.

​

Visualizando dados de consultas

Alguns dados podem ser interpretados com mais facilidade na forma de gráficos. Você pode criar rapidamente visualizações a partir dos dados resultantes da consulta diretamente no SQL Console com apenas alguns cliques. Como exemplo, usaremos uma consulta que calcula estatísticas semanais de corridas de táxi em NYC:

SELECT
   toStartOfWeek(pickup_datetime) AS week,
   sum(total_amount) AS fare_total,
   sum(trip_distance) AS distance_total,
   count(*) AS trip_total
FROM
   nyc_taxi
GROUP BY
   1
ORDER BY
   1 ASC

Sem uma visualização, esses resultados são difíceis de interpretar. Vamos transformá-los em um gráfico.

​

Criando gráficos

Para começar a criar sua visualização, selecione a opção ‘Chart’ na barra de ferramentas do painel de resultados da consulta. Um painel de configuração do gráfico será exibido:

Vamos começar criando um gráfico de barras simples para acompanhar trip_total por week. Para isso, vamos arrastar o campo week para o eixo x e o campo trip_total para o eixo y:

A maioria dos tipos de gráfico oferece suporte a vários campos em eixos numéricos. Para demonstrar isso, vamos arrastar o campo fare_total para o eixo y:

​

Personalizando gráficos

O SQL Console oferece suporte a dez tipos de gráfico, que podem ser selecionados no seletor de tipo de gráfico no painel de configuração do gráfico. Por exemplo, podemos mudar facilmente o tipo do gráfico anterior de Barra para Área:

Os títulos dos gráficos correspondem ao nome da consulta que fornece os dados. Ao atualizar o nome da consulta, o título do gráfico também será atualizado:

Algumas características mais avançadas do gráfico também podem ser ajustadas na seção ‘Advanced’ do painel de configuração do gráfico. Para começar, vamos ajustar as seguintes configurações:

• Subtítulo
• Títulos dos eixos
• Orientação do rótulo do eixo x

Nosso gráfico será atualizado de acordo:

Em alguns cenários, pode ser necessário ajustar as escalas dos eixos de cada campo de forma independente. Isso pode ser feito na seção ‘Advanced’ do painel de configuração do gráfico, especificando os valores mínimo e máximo para um intervalo do eixo. Por exemplo, o gráfico acima está bom, mas, para demonstrar a correlação entre nossos campos trip_total e fare_total, os intervalos dos eixos precisam de alguns ajustes: