ClickHouse

Passo a Passo: Configuração Completa

Passo 1 — Criar o Ativo (Asset)

1. Acesse Console → Ativos → Lista de Ativos

2. Clique em "+ Criar" e selecione a categoria Banco de Dados → ClickHouse

3. Preencha os campos:

Campo	Valor Exemplo	Observação
Nome	ClickHouse-Analytics-01	Nome identificador do ativo
IP/Host	192.168.1.70	Endereço do servidor ClickHouse
Porta	9000	Porta nativa do ClickHouse
Plataforma	ClickHouse	Selecionar plataforma ClickHouse
Nó	/Default	Nó organizacional

1. Clique em Enviar para salvar

Passo 2 — Adicionar Conta (Account)

1. Acesse o ativo ClickHouse criado → aba Contas

2. Clique em "+ Criar"

3. Preencha:

Campo	Valor	Observação
Nome	ch-admin	Identificador da conta
Usuário	PAM_admin	Usuário ClickHouse
Senha	●●●●●●●●	Senha do usuário

1. Clique em Enviar

Passo 3 — Criar Autorização (Asset Permission)

1. Acesse Console → Permissões → Permissões de Ativos

2. Clique em "+ Criar"

3. Configure:

Campo	Valor
Nome	Acesso-ClickHouse-Analytics
Usuários	Selecionar usuário(s) ou grupo(s)
Ativos	ClickHouse-Analytics-01
Contas	ch-admin
Ações	Conectar, Copiar/Colar
Data de início/fim	Conforme política

1. Clique em Enviar

---

Passo 4 — Conectar ao ClickHouse

Após a configuração, o usuário autorizado pode acessar o ClickHouse pelo Workbench:

Método 1: Web CLI (clickhouse-client)

1. No Workbench, localize o ativo ClickHouse

2. Clique em Web CLI

3. Um terminal clickhouse-client abrirá diretamente no navegador

4. Execute consultas SQL normalmente:

SHOW DATABASES;
USE minha_base;
SHOW TABLES;
SELECT count() FROM minha_tabela;
SELECT * FROM minha_tabela LIMIT 10;

Dica: O Web CLI é ideal para consultas rápidas e operações administrativas.

Método 2: RemoteApp

1. No Workbench, clique em RemoteApp

2. Uma aplicação (ex: DBeaver ou DataGrip) será aberta via sessão remota

3. A conexão é estabelecida automaticamente com as credenciais configuradas

4. Use a interface gráfica para navegar databases, tabelas e executar queries complexas

---

Passo 5 — Verificação e Testes

Teste	Comando / Ação	Resultado Esperado
Conectividade	clickhouse-client --host <IP> --port 9000	Conexão estabelecida
Autenticação	Login com usuário/senha	Acesso concedido
Consulta	SELECT 1	Resultado: 1
Web CLI	Acessar via Workbench	Terminal funcional
Auditoria	Console → Auditoria → Sessões	Sessão registrada

---

Troubleshooting ClickHouse

Problema	Causa Provável	Solução
Erro "Authentication failed"	Credenciais incorretas	Verificar usuário e senha no ClickHouse
Connection refused	ClickHouse não escutando na interface	Adicionar <listen_host>0.0.0.0</listen_host> no config.xml
Connection timeout	Firewall ou rede	Liberar porta 9000 entre PAM e ClickHouse
Erro "Access denied"	Usuário sem GRANT adequado	Verificar permissões: SHOW GRANTS FOR user
Porta errada	Usando 8123 (HTTP) ao invés de 9000	PAM usa protocolo nativo (porta 9000)
Usuário não vê o ativo	Falta autorização	Criar Asset Permission para o usuário

Nota: O ClickHouse é otimizado para consultas analíticas em grandes volumes. Diferente de bancos transacionais (OLTP), ele é ideal para agregações, relatórios e análises de dados históricos. O PAM audita todas as queries SQL executadas.