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 com mais eficiência.
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 dessa barra para ver as tabelas de um banco de dados específico
As tabelas da lista também podem ser expandidas para ver colunas e tipos de dados
Explorando os dados da tabela
Inspecionando os dados da célula
Filtrar e ordenar tabelas
Filtragem e ordenação juntas
Criando uma consulta a partir de filtros e ordenações
Filtros e ordenações não são obrigatórios ao usar o recurso ‘Create Query’.
Criar e executar uma consulta
- Clique no botão ’+’ na barra de abas
- Selecione o botão ‘New Query’ na lista de consultas na barra lateral esquerda
Para executar uma consulta, digite seu comando SQL ou comandos 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 ao final de cada comando.
Opções de execução de consulta
Por padrão, clicar no botão Run executará todos os comandos contidos no SQL Editor. O SQL Console oferece outras duas opções de execução de consulta:
- Executar comandos selecionados
- Executar o comando na posição do cursor
Para executar comandos selecionados, destaque o comando desejado ou a sequência de comandos 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 durante a execução.
Esc para cancelar a consulta. Observação: todos os resultados que já tiverem sido retornados permanecerão após o cancelamento.
Se ainda não tiver um nome, sua consulta deve aparecer como ‘Untitled Query’. Clique no nome da consulta para alterá-lo. Ao renomear uma consulta, ela será salva.
Você também pode usar o botão Salvar ou o atalho de teclado cmd / ctrl + s para salvar uma consulta.
Usando GenAI para gerenciar consultas
-
Abra um serviço do ClickHouse Cloud.
-
Crie uma nova consulta clicando no ícone +.
-
Cole e execute o código a seguir:
CREATE TABLE uk_price_paid
(
price UInt32,
date Date,
postcode1 LowCardinality(String),
postcode2 LowCardinality(String),
type Enum8('terraced' = 1, 'semi-detached' = 2, 'detached' = 3, 'flat' = 4, 'other' = 0),
is_new UInt8,
duration Enum8('freehold' = 1, 'leasehold' = 2, 'unknown' = 0),
addr1 String,
addr2 String,
street LowCardinality(String),
locality LowCardinality(String),
town LowCardinality(String),
district LowCardinality(String),
county LowCardinality(String)
)
ENGINE = MergeTree
ORDER BY (postcode1, postcode2, addr1, addr2);
-
Crie uma nova consulta e cole a consulta a seguir:
INSERT INTO uk_price_paid
WITH
splitByChar(' ', postcode) AS p
SELECT
toUInt32(price_string) AS price,
parseDateTimeBestEffortUS(time) AS date,
p[1] AS postcode1,
p[2] AS postcode2,
transform(a, ['T', 'S', 'D', 'F', 'O'], ['terraced', 'semi-detached', 'detached', 'flat', 'other']) AS type,
b = 'Y' AS is_new,
transform(c, ['F', 'L', 'U'], ['freehold', 'leasehold', 'unknown']) AS duration,
addr1,
addr2,
street,
locality,
town,
district,
county
FROM url(
'http://prod.publicdata.landregistry.gov.uk.s3-website-eu-west-1.amazonaws.com/pp-complete.csv',
'CSV',
'uuid_string String,
price_string String,
time String,
postcode String,
a String,
b String,
c String,
addr1 String,
addr2 String,
street String,
locality String,
town String,
district String,
county String,
d String,
e String'
) SETTINGS max_http_get_redirects=10;
Essa consulta busca o conjunto de dados no site gov.uk. Esse arquivo tem cerca de 4 GB, então a consulta levará alguns minutos para ser concluída. Depois que o ClickHouse processar a consulta, você terá o conjunto de dados completo na tabela uk_price_paid.
Vamos criar uma consulta usando linguagem natural.
-
Selecione a tabela uk_price_paid e, em seguida, clique em Create Query.
-
Clique em Generate SQL. Pode ser solicitado que você aceite que suas consultas sejam enviadas ao ChatGPT. Você deve selecionar I agree para continuar.
-
Agora você pode usar este prompt para inserir uma consulta em linguagem natural e fazer com que o ChatGPT a converta em uma consulta SQL. Neste exemplo, vamos inserir:
Mostre o preço total e o número total de todas as transações da uk_price_paid por ano.
-
O Console vai gerar a consulta que estamos procurando e exibi-la em uma nova aba. No nosso exemplo, o GenAI criou a seguinte consulta:
-- Mostre o preço total e o número total de todas as transações da uk_price_paid por ano.
SELECT year(date), sum(price) as total_price, Count(*) as total_transactions
FROM uk_price_paid
GROUP BY year(date)
-
Depois de verificar que a consulta está correta, clique em Run para executá-la.
Agora, vamos testar os recursos de depuração de consultas do GenAI.
-
Crie uma nova consulta clicando no ícone + e cole o código abaixo:
-- Mostre o preço total e o número total de todas as transações uk_price_paid por ano.
SELECT year(date), sum(pricee) as total_price, Count(*) as total_transactions
FROM uk_price_paid
GROUP BY year(date)
-
Clique em Run. A consulta falha, pois estamos tentando usar valores de
pricee em vez de price.
-
Clique em Fix Query.
-
O GenAI vai tentar corrigir a consulta. Neste caso, ele alterou
pricee para price. Ele também identificou que toYear é uma função mais adequada para este cenário.
-
Selecione Apply para adicionar as alterações sugeridas à sua consulta e clique em Run.
Lembre-se de que o GenAI é um recurso experimental. Tenha cautela ao executar consultas geradas pelo GenAI em qualquer conjunto de dados.
Recursos avançados para consultas
Buscando nos resultados da consulta
WHERE adicional ou simplesmente a verificar se determinados dados estão incluídos no conjunto de resultados. Depois de inserir um valor no campo de busca, o painel de resultados será atualizado e retornará registros que contenham um valor correspondente ao que foi inserido. 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 inserido será retornado. Por exemplo, o terceiro registro na captura de tela acima não corresponde a ‘breakfast’ no campo by, mas corresponde no campo text:
Por padrão, o painel de resultados da consulta exibe todos os registros de 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 da consulta:
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 da consulta
Exportando os dados do resultado da consulta
••• no lado direito da barra de ferramentas do painel de resultados e selecione ‘Baixar como CSV’.
Visualizando dados de consulta
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
trip_total por week. Para isso, arrastaremos 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 nos eixos numéricos. Para demonstrar, arrastaremos o campo fare_total para o eixo y:
O SQL Console oferece suporte a dez tipos de gráfico que podem ser selecionados no seletor de tipos de gráfico, no painel de configuração do gráfico. Por exemplo, podemos alterar 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 é 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 dos rótulos no eixo x
Nosso gráfico será atualizado de acordo:
Em alguns cenários, pode ser necessário ajustar de forma independente as escalas dos eixos de cada campo. Isso também pode ser feito na seção ‘Advanced’ do painel de configuração do gráfico, especificando valores mínimo e máximo para uma faixa do eixo. Como exemplo, o gráfico acima está bom, mas, para demonstrar a correlação entre nossos campos trip_total e fare_total, as faixas dos eixos precisam de alguns ajustes:
O SQL Console permite compartilhar consultas com sua equipe. Quando uma consulta é compartilhada, todos os membros da equipe podem ver e editar a consulta. Consultas compartilhadas são uma ótima forma de colaborar com sua equipe.
Para compartilhar uma consulta, clique no botão ‘Share’ na barra de ferramentas da consulta.
Uma caixa de diálogo será aberta, permitindo que você compartilhe a consulta com todos os membros de uma equipe. Se você tiver várias equipes, poderá selecionar com qual equipe compartilhar a consulta.
Em alguns cenários, pode ser necessário ajustar as escalas dos eixos de cada campo de forma independente. Isso também pode ser feito na seção ‘Advanced’ do painel de configuração do gráfico, especificando valores mínimo e máximo para um intervalo do eixo. Por exemplo, o gráfico acima parece bom, mas, para demonstrar a correlação entre nossos campos trip_total e fare_total, os intervalos dos eixos precisam de alguns ajustes:
