Pular para o conteúdo principal

​
1. Configure uma conexão com o ClickHouse

Para se conectar ao ClickHouse, acesse a página Connections, selecione New Connection e, em seguida, escolha o ClickHouse no modal New Connection. Será solicitado que você informe um host, nome de usuário e senha:
  • Host: este é o host em que seu banco de dados ClickHouse está exposto. Observe que apenas https é aceito aqui para transferir dados com segurança pelo wire. A estrutura esperada da URL do host é: https://url-to-clickhouse-db:port/database Por padrão, o plugin se conectará ao banco de dados ‘default’ e à porta 443. Ao informar um banco de dados após a ’/’, você pode configurar a qual banco de dados se conectar.
  • Username: o nome de usuário que será usado para se conectar ao seu cluster ClickHouse.
  • Password: a senha para se conectar ao seu cluster ClickHouse
Consulte os exemplos em nossa documentação para desenvolvedores para saber como criar uma conexão com o ClickHouse por meio da nossa API.

​
2. Adicione conjuntos de dados

Depois de conectar o ClickHouse, você pode adicionar conjuntos de dados conforme explicado aqui. Você pode selecionar um ou vários conjuntos de dados disponíveis no ClickHouse e vinculá-los no Luzmo para garantir que possam ser usados em conjunto em um dashboard. Confira também este artigo sobre Como preparar seus dados para análise. Para saber como adicionar conjuntos de dados usando nossa API, consulte este exemplo na documentação para desenvolvedores. Agora você pode usar seus conjuntos de dados para criar dashboards incríveis (incorporados) ou até mesmo viabilizar um analista de dados com IA (Luzmo IQ) capaz de responder às perguntas dos seus clientes.

​
Notas de uso

  1. O conector ClickHouse do Luzmo usa a interface da API HTTP (normalmente executada na porta 8123) para se conectar.
  2. Se você usar tabelas com o mecanismo de tabela Distributed, alguns gráficos do Luzmo poderão falhar quando distributed_product_mode estiver definido como deny. No entanto, isso só deve ocorrer se você vincular a tabela com outra tabela e usar esse vínculo em um gráfico. Nesse caso, defina distributed_product_mode como outra opção que faça sentido no seu cluster ClickHouse. Se estiver usando ClickHouse Cloud, você pode ignorar essa configuração com segurança.
  3. Para garantir que, por exemplo, somente o aplicativo Luzmo possa acessar sua instância do ClickHouse, é altamente recomendável incluir na lista de permissões a faixa de endereços IP estáticos do Luzmo. Também recomendamos usar um usuário técnico somente leitura.
  4. Atualmente, o conector ClickHouse oferece suporte aos seguintes tipos de dados:
Última modificação em 12 de junho de 2026