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.

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 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 usando 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 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 autoescalonamento vertical será ativado por padrão no tier Scale. Você pode alterar o tier da sua organização mais tarde na página ‘Plans’.Se necessário, personalize os recursos do serviço especificando um tamanho mínimo e máximo entre os quais as réplicas poderão escalar. Quando estiver tudo pronto, selecione Create service.
Parabéns! Seu serviço no ClickHouse Cloud já está em execução, e o onboarding foi concluído. Continue lendo para saber como começar a fazer a ingestão e consultar 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 aba de consulta e digite uma consulta simples para verificar se a conexão está funcionando:

SHOW databases

Você deve ver 4 bancos de dados na lista, além de quaisquer outros que tenha adicionado.
É isso — você já pode começar a usar seu novo serviço ClickHouse!

Conecte seu app

Clique no botão de conexão no menu de navegação. Uma janela modal será aberta, mostrando as credenciais do seu serviço e um conjunto de instruções sobre como se conectar usando sua interface ou clientes na sua linguagem.
Se você não encontrar o cliente para a sua 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 do ClickHouse
Faça upload de um arquivo - os formatos aceitos incluem JSON, CSV e TSV
Carregar dados de uma URL de 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 os workloads mais exigentes, a arquitetura robusta e escalável do ClickPipes garante desempenho e confiabilidade consistentes. O ClickPipes pode ser utilizado 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 aceitas
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 nó único, a opção mais provável é MergeTree.

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 ú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 (denominado 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 passa 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 ordem de 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”.

Insira 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.

Prática recomendada 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 volume — e isso ajuda você a economizar ao enviar menos solicitaçõ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 )

Observe que a coluna timestamp é preenchida com várias funções Date e DateTime. O ClickHouse tem 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 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 hostname, nome de usuário e senha pelos seus valores:

./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 consulta a seguir:

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 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 separada por tabulações:

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á possui 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 consultar pelo 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 mostra como inserir 2 milhões de linhas em uma tabela e escrever algumas consultas analíticas
Temos uma lista de datasets de exemplo com instruções sobre como inseri-los
Confira nosso vídeo de 12 minutos sobre Primeiros passos com ClickHouse
Se seus dados vêm 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/BI, consulte 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

​Crie um serviço ClickHouse

​Conectar ao ClickHouse

​Conectar usando o SQL Console

​Conecte seu app

​Adicionar dados

​ClickPipes

​Adicionar dados usando o 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?

Crie um serviço ClickHouse

Conectar ao ClickHouse

Conectar usando o SQL Console

Conecte seu app

Adicionar dados

ClickPipes

Adicionar dados usando o 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?