Início rápido do ClickHouse Cloud

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 ajudar você a configurar tudo em três etapas simples.

Crie um serviço ClickHouse

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

Crie uma conta na página de cadastro
Você pode se cadastrar usando seu e-mail ou por SSO do Google, SSO da Microsoft, 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 24 h usando o link recebido por e-mail
Faça login com o nome de usuário e a senha que você acabou de criar

Após 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 em que deseja implantar o serviço e dê um nome a ele:
Por padrão, novas organizações são incluídas no plano Scale e criam 3 réplicas, cada uma com 4 vCPUs e 16 GiB de RAM. O escalonamento vertical automático é habilitado por padrão no plano Scale. Você poderá alterar o plano da sua organização posteriormente na página ‘Planos’.Se necessário, personalize os recursos do serviço definindo tamanhos mínimo e máximo para o escalonamento das réplicas. Quando estiver tudo pronto, selecione Create service.
Parabéns! Seu serviço ClickHouse Cloud está em execução, e o onboarding foi concluído. Continue lendo para saber como começar a ingerir e consultar seus dados.

Conectar ao ClickHouse

Há duas maneiras de se conectar ao ClickHouse:

Conecte-se usando nosso console SQL na web
Conecte-se pelo seu app

Conectar usando o console SQL

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

SHOW databases

Você deverá ver quatro bancos de dados na lista, além daqueles que tiver adicionado.
Pronto! Agora você pode começar a usar seu novo serviço do ClickHouse.

Conecte-se ao seu aplicativo

Clique no botão Connect no menu de navegação. Uma janela modal será aberta, exibindo as credenciais do seu serviço e instruções para se conectar usando sua interface ou cliente por linguagem.
Se o cliente da sua linguagem não estiver listado, consulte nossa lista de Integrações.

Adicionar dados

O ClickHouse é ainda melhor com dados! Há várias maneiras de adicionar dados, e a maioria delas está disponível na página Data Sources, acessível pelo menu de navegação.
Você pode fazer upload de dados pelos 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 a partir do 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. Projetada para as cargas de trabalho mais exigentes, a arquitetura robusta e escalável do ClickPipes garante desempenho e confiabilidade consistentes. O ClickPipes pode ser usado tanto para necessidades de streaming de longo prazo quanto para um trabalho pontual de carregamento de dados.

Adicionar dados pelo SQL Console

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

CREATE DATABASE IF NOT EXISTS helloworld

Execute o comando a seguir 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 de 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 compatíveis
Se os dados são replicados ou não

Há diversos motores de tabela disponíveis, mas, para uma tabela simples em um servidor ClickHouse de nó único, MergeTree provavelmente é a melhor opção.

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!):

as chaves primárias no ClickHouse não são exclusivas para cada linha de uma tabela

A primary key de uma tabela ClickHouse determina como os dados são ordenados ao serem gravados em disco. A cada 8.192 linhas ou 10MB de dados (o que se chama de index granularity), é criada uma entrada no arquivo de índice da primary key. Esse conceito de granularidade gera um índice esparso que cabe facilmente em memória, e os grânulos representam um stripe da menor quantidade de dados de coluna processada durante as queries SELECT.A chave primária pode ser definida por meio do parâmetro PRIMARY KEY. Se você definir uma tabela sem especificar PRIMARY KEY, a chave passa a ser a tupla especificada na cláusula ORDER BY. Se você especificar tanto PRIMARY KEY quanto 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 (user_id, timestamp). Portanto, os dados armazenados em cada arquivo de coluna serão ordenados por user_id e, em seguida, por timestamp.Para se aprofundar nos conceitos fundamentais do ClickHouse, consulte “Conceitos fundamentais”.

Insira dados na sua tabela

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

Prática recomendada do ClickHouseInsira um grande número de linhas por batch — dezenas de milhares ou até milhões de linhas de uma só vez. Não se preocupe — o ClickHouse lida facilmente com esse volume — e economiza dinheiro ao enviar menos solicitações de gravação ao seu serviço.

Mesmo em um exemplo simples, vamos inserir mais de uma linha por 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 )

Observe que a coluna timestamp é preenchida com várias funções de Date e DateTime. O ClickHouse conta com centenas de funções úteis, que você pode consultar na seção Functions.

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 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 na lista suspensa:

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

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

Se aparecer o prompt com a carinha sorridente, você já pode executar queries!

:)

Teste executando a seguinte consulta:

SELECT *
FROM helloworld.my_first_table
ORDER BY timestamp

Observe que a resposta é retornada 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 vários formatos de saída compatíveis do ClickHouse:

SELECT *
FROM helloworld.my_first_table
ORDER BY timestamp
FORMAT TabSeparated

Na consulta acima, a saída é retornada com os campos separados 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 usar um banco de dados é inserir dados que você já tem em arquivos. Disponibilizamos online alguns dados de exemplo que você pode inserir e que representam dados de clickstream — eles incluem um ID de usuário, uma URL visitada e o timestamp do evento.Suponha que tenhamos 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 consultar no SQL Console:

Filtragem da lista de acesso IPAntes de continuar, recomendamos configurar a filtragem da lista de acesso IP. 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 executar algumas consultas analíticas
Temos uma lista de conjuntos de dados de exemplo com instruções sobre como inseri-los
Confira nosso vídeo de 12 minutos sobre Getting Started with ClickHouse
Se seus dados vierem de uma fonte externa, consulte 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, consulte os guias do usuário para conectar uma UI ao ClickHouse
O guia do usuário sobre primary keys reúne tudo o que você precisa saber sobre primary keys e como defini-las

Get started

Setup

Sample datasets

Migrate

Conectar usando o console SQL

Conecte-se ao seu aplicativo

ClickPipes

Adicionar dados pelo SQL Console

Uma breve introdução às chaves primárias

Insira dados na sua tabela

Adicionar dados usando o ClickHouse Client

Fazer upload de um arquivo

O que vem a seguir?

​Conectar usando o console SQL

​Conecte-se ao seu aplicativo

​ClickPipes

​Adicionar dados pelo SQL Console

​Uma breve introdução às chaves primárias

​Insira dados na sua tabela

​Adicionar dados usando o ClickHouse Client

​Fazer upload de um arquivo

​O que vem a seguir?

Conectar usando o console SQL

Conecte-se ao seu aplicativo

ClickPipes

Adicionar dados pelo SQL Console

Uma breve introdução às chaves primárias

Insira dados na sua tabela

Adicionar dados usando o ClickHouse Client

Fazer upload de um arquivo

O que vem a seguir?