Início rápido do ClickHouse Cloud - ClickHouse Documentation

A maneira mais rápida e fácil de começar a usar o ClickHouse é criar um novo serviço no ClickHouse Cloud. Neste guia de início rápido, vamos deixar tudo pronto para você em três etapas simples.

Criar um serviço ClickHouse

Para criar um serviço ClickHouse gratuito no ClickHouse Cloud, basta se cadastrar seguindo as etapas abaixo:

Crie uma conta na página de cadastro
Você pode optar por se cadastrar com seu e-mail ou via Google SSO, Microsoft SSO, AWS Marketplace, Google Cloud ou Microsoft Azure
Se você se cadastrar com e-mail e senha, lembre-se de verificar seu endereço de e-mail nas próximas 24h pelo link que receberá por e-mail
Faça login com o nome de usuário e a senha que você acabou de criar

Depois de fazer login, o ClickHouse Cloud inicia o assistente de onboarding, que orienta você na criação de um novo serviço ClickHouse. Selecione a região desejada para implantar o serviço e dê um nome ao seu novo serviço:
Por padrão, novas organizações são colocadas no tier Scale e criarão 3 réplicas, cada uma com 4 VCPUs e 16 GiB de RAM. O Vertical autoscaling será ativado por padrão no tier Scale. Você pode alterar o tier da organização depois na página ‘Plans’.Personalize os recursos do serviço, se necessário, especificando um tamanho mínimo e máximo para o escalonamento das réplicas. Quando estiver tudo pronto, selecione Create service.
Parabéns! Seu serviço do ClickHouse Cloud está em funcionamento, e o onboarding foi concluído. Continue lendo para ver detalhes sobre como começar a fazer a ingestão e a consulta dos seus dados.

Conectar ao ClickHouse

Há 2 maneiras de se conectar ao ClickHouse:

Conectar usando nosso SQL Console na web
Conectar com seu aplicativo

Conectar usando o SQL Console

Para começar rapidamente, o ClickHouse oferece um SQL Console na web para o qual você será redirecionado ao concluir o onboarding.Crie uma guia de consulta e insira uma consulta simples para verificar se a conexão está funcionando:

SHOW databases

Você deverá ver 4 bancos de dados na lista, além de outros que possa ter adicionado.
É isso — você está pronto para começar a usar seu novo serviço ClickHouse!

Conecte seu aplicativo

Clique no botão Connect no menu de navegação. Um modal será aberto, mostrando as credenciais do seu serviço e um conjunto de instruções sobre como se conectar pela sua interface ou pelos seus clientes por linguagem.
Se você não encontrar seu cliente por linguagem, consulte nossa lista de Integrations.

Adicionar dados

O ClickHouse é melhor com dados! Há diversas formas de adicionar dados e a maioria delas está disponível na página de Fontes de Dados, acessível pelo menu de navegação.
Você pode fazer upload de dados usando os seguintes métodos:

Configure um ClickPipe para iniciar a ingestão de dados de fontes como S3, Postgres, Kafka e GCS
Use o console SQL
Use o cliente ClickHouse
Faça upload de um arquivo - os formatos aceitos incluem JSON, CSV e TSV
Faça upload de dados usando a URL do arquivo

ClickPipes

ClickPipes é uma plataforma de integração gerenciada que torna a ingestão de dados de diversas fontes tão simples quanto clicar em alguns botões. Projetado para os workloads mais exigentes, a arquitetura robusta e escalável do ClickPipes garante desempenho e confiabilidade consistentes. O ClickPipes pode ser usado para necessidades de streaming de longo prazo ou para jobs pontuais de carregamento de dados.

Adicionar dados usando o SQL Console

Como a maioria dos sistemas de gerenciamento de banco de dados, o ClickHouse agrupa tabelas logicamente em databases. Use o comando CREATE DATABASE para criar um novo banco de dados no ClickHouse:

CREATE DATABASE IF NOT EXISTS helloworld

Execute o seguinte comando para criar uma tabela chamada my_first_table no banco de dados helloworld:

CREATE TABLE helloworld.my_first_table
(
    user_id UInt32,
    message String,
    timestamp DateTime,
    metric Float32
)
ENGINE = MergeTree()
PRIMARY KEY (user_id, timestamp)

No exemplo acima, my_first_table é uma tabela MergeTree com quatro colunas:

user_id: um inteiro sem sinal de 32 bits (UInt32)
message: um tipo de dado String, que substitui tipos como VARCHAR, BLOB, CLOB e outros usados em outros sistemas de banco de dados
timestamp: um valor DateTime, que representa um instante no tempo
metric: um número de ponto flutuante de 32 bits (Float32)

Motores de tabelaOs motores de tabela determinam:

Como e onde os dados são armazenados
Quais consultas são suportadas
Se os dados são replicados ou não

Há muitos motores de tabela para escolher, mas, para uma tabela simples em um servidor ClickHouse de um único nó, MergeTree provavelmente será sua escolha.

Uma Breve Introdução às Chaves Primárias

Antes de prosseguir, é importante entender como as chaves primárias funcionam no ClickHouse (a implementação das chaves primárias pode parecer inesperada!):

chaves primárias em ClickHouse não são únicas para cada linha de uma tabela

A chave primária de uma tabela ClickHouse determina como os dados são ordenados quando gravados em disco. A cada 8.192 linhas ou 10 MB de dados (referido como a granularidade do índice) é criada uma entrada no arquivo de índice da chave primária. Esse conceito de granularidade cria um índice esparso que cabe facilmente na memória, e os grânulos representam uma stripe da menor quantidade de dados de coluna processada durante as consultas SELECT.A chave primária pode ser definida usando o parâmetro PRIMARY KEY. Se você definir uma tabela sem especificar um PRIMARY KEY, a chave passará a ser a tupla especificada na cláusula ORDER BY. Se você especificar tanto um PRIMARY KEY quanto um ORDER BY, a chave primária deve ser um subconjunto da ordenação.A chave primária também é a chave de ordenação, que é uma tupla de (user_id, timestamp). Portanto, os dados armazenados em cada arquivo de coluna serão ordenados por user_id e depois por timestamp.Para uma análise aprofundada dos conceitos fundamentais do ClickHouse, consulte “Conceitos Fundamentais”.

Inserir dados na sua tabela

Você pode usar o conhecido comando INSERT INTO TABLE com o ClickHouse, mas é importante entender que cada inserção em uma tabela MergeTree resulta na criação de uma part no armazenamento.

Melhor prática do ClickHouseInsira um grande número de linhas por lote — dezenas de milhares ou até milhões de linhas de uma só vez. Não se preocupe — o ClickHouse lida facilmente com esse tipo de volume — e ajuda você a economizar ao enviar menos requisições de gravação para o seu serviço.

Mesmo para um exemplo simples, vamos inserir mais de uma linha de uma vez:

INSERT INTO helloworld.my_first_table (user_id, message, timestamp, metric) VALUES
    (101, 'Hello, ClickHouse!',                                 now(),       -1.0    ),
    (102, 'Insert a lot of rows per batch',                     yesterday(), 1.41421 ),
    (102, 'Sort your data based on your commonly-used queries', today(),     2.718   ),
    (101, 'Granules are the smallest chunks of data read',      now() + 5,   3.14159 )

Note que a coluna timestamp é preenchida com várias funções de Date e DateTime. O ClickHouse tem centenas de funções úteis que você pode ver na seção Funções.

Vamos verificar se funcionou:

SELECT * FROM helloworld.my_first_table

Adicionar dados usando o ClickHouse Client

Você também pode se conectar ao seu serviço do ClickHouse Cloud usando uma ferramenta de linha de comando chamada clickhouse client. Clique em Connect no menu à esquerda para acessar esses detalhes. Na caixa de diálogo, selecione Native no menu suspenso:

Instale o ClickHouse.
Execute o comando, substituindo o nome do host, o nome de usuário e a senha:

./clickhouse client --host HOSTNAME.REGION.CSP.clickhouse.cloud \
--secure --port 9440 \
--user default \
--password <password>

Se o prompt com o rosto sorridente aparecer, você está pronto para executar queries!

:)

Experimente executar a seguinte consulta:

SELECT *
FROM helloworld.my_first_table
ORDER BY timestamp

Observe que a resposta é exibida em um formato de tabela bem organizado:

┌─user_id─┬─message────────────────────────────────────────────┬───────────timestamp─┬──metric─┐
│     102 │ Insert a lot of rows per batch                     │ 2022-03-21 00:00:00 │ 1.41421 │
│     102 │ Sort your data based on your commonly-used queries │ 2022-03-22 00:00:00 │   2.718 │
│     101 │ Hello, ClickHouse!                                 │ 2022-03-22 14:04:09 │      -1 │
│     101 │ Granules are the smallest chunks of data read      │ 2022-03-22 14:04:14 │ 3.14159 │
└─────────┴────────────────────────────────────────────────────┴─────────────────────┴─────────┘

4 rows in set. Elapsed: 0.008 sec.

Adicione uma cláusula FORMAT para especificar um dos muitos formatos de saída suportados pelo ClickHouse:

SELECT *
FROM helloworld.my_first_table
ORDER BY timestamp
FORMAT TabSeparated

Na consulta acima, a saída é retornada no formato separado por tabulação:

Query id: 3604df1c-acfd-4117-9c56-f86c69721121

Insert a lot of rows per batch      2022-03-21 00:00:00     1.41421
Sort your data based on your commonly-used queries  2022-03-22 00:00:00     2.718
Hello, ClickHouse!  2022-03-22 14:04:09     -1
Granules are the smallest chunks of data read       2022-03-22 14:04:14     3.14159

rows in set. Elapsed: 0.005 sec.

Para sair do clickhouse client, digite o comando exit:

exit

Fazer upload de um arquivo

Uma tarefa comum ao começar a trabalhar com um banco de dados é inserir dados que você já tem em arquivos. Disponibilizamos alguns dados de exemplo online que você pode inserir, representando dados de clickstream — incluindo um ID de usuário, uma URL visitada e o timestamp do evento.Suponha que temos o seguinte texto em um arquivo CSV chamado data.csv:

data.csv

102,This is data in a file,2022-02-22 10:43:28,123.45
101,It is comma-separated,2022-02-23 00:00:00,456.78
103,Use FORMAT to specify the format,2022-02-21 10:43:30,678.90

O comando a seguir insere os dados na tabela my_first_table:

./clickhouse client --host HOSTNAME.REGION.CSP.clickhouse.cloud \
--secure --port 9440 \
--user default \
--password <password> \
--query='INSERT INTO helloworld.my_first_table FORMAT CSV' < data.csv

Observe que as novas linhas agora aparecem na tabela ao consultá-la no SQL Console:

Filtragem por lista de acesso de IPsAntes de prosseguir, recomendamos configurar a filtragem por lista de acesso de IPs. Consulte “Configurar filtros de IP” para mais detalhes.

O que vem a seguir?

O Tutorial orienta você a inserir 2 milhões de linhas em uma tabela e escrever algumas consultas analíticas
Temos uma lista de conjuntos de dados de exemplo com instruções sobre como inseri-los
Assista ao nosso vídeo de 12 minutos sobre Primeiros passos com ClickHouse
Se os seus dados vêm de uma fonte externa, veja nossa coleção de guias de integração para se conectar a filas de mensagens, bancos de dados, pipelines e muito mais
Se você estiver usando uma ferramenta de visualização UI/BI, veja os guias do usuário para conectar uma UI ao ClickHouse
O guia do usuário sobre chaves primárias traz tudo o que você precisa saber sobre chaves primárias e como defini-las

​Conectar usando o SQL Console

​Conecte seu aplicativo

​ClickPipes

​Adicionar dados usando o SQL Console

​Uma Breve Introdução às Chaves Primárias

​Inserir dados na sua tabela

​Adicionar dados usando o ClickHouse Client

​Fazer upload de um arquivo

​O que vem a seguir?

Conectar usando o SQL Console

Conecte seu aplicativo

ClickPipes

Adicionar dados usando o SQL Console

Uma Breve Introdução às Chaves Primárias

Inserir dados na sua tabela

Adicionar dados usando o ClickHouse Client

Fazer upload de um arquivo

O que vem a seguir?