Como conectar o DataGrip ao ClickHouse

O DataGrip é uma IDE de banco de dados com suporte nativo ao ClickHouse.

​

Inicie ou faça o download do DataGrip

O DataGrip está disponível em https://www.jetbrains.com/datagrip/

​

1. Reúna os detalhes da sua conexão

Para se conectar ao ClickHouse via HTTP(S), você precisa das seguintes informações:

Parâmetro(s)	Descrição
HOST and PORT	Normalmente, a porta é 8443 ao usar TLS ou 8123 quando não se usa TLS.
DATABASE NAME	Por padrão, há um banco de dados chamado default; use o nome do banco de dados ao qual você deseja se conectar.
USERNAME and PASSWORD	Por padrão, o nome de usuário é default. Use o nome de usuário apropriado para o seu caso de uso.

Os detalhes do seu serviço do ClickHouse Cloud estão disponíveis no console do ClickHouse Cloud. Selecione um serviço e clique em Connect:

Escolha HTTPS. Os detalhes de conexão são exibidos em um comando curl de exemplo.

Se você estiver usando ClickHouse autogerenciado, os detalhes de conexão são definidos pelo administrador do seu ClickHouse.

​

2. Carregue o driver do ClickHouse

1. Inicie o DataGrip e, na guia Data Sources da caixa de diálogo Data Sources and Drivers, clique no ícone +

Selecione ClickHouse

À medida que você cria conexões, a ordem muda, e o ClickHouse talvez ainda não esteja no topo da lista.

• Mude para a guia Drivers e carregue o driver do ClickHouse

  O DataGrip não inclui drivers para reduzir o tamanho do download. Na guia Drivers, selecione ClickHouse na lista Complete Support e clique no sinal de +. Escolha o driver Latest stable na opção Provided Driver:

​

3. Conecte-se ao ClickHouse

• Especifique os detalhes da conexão com o banco de dados e clique em Test Connection. Na etapa um, você coletou os detalhes da conexão — preencha a URL do host, a porta, o nome de usuário, a senha e o nome do banco de dados e, em seguida, teste a conexão.

Digite apenas o hostname no campo Host (por exemplo, your-host.clickhouse.cloud), sem nenhum prefixo de protocolo, como https://.

Para conexões com o ClickHouse Cloud, você deve adicionar ?ssl=true ao campo URL abaixo do host. A URL JDBC completa deve ficar assim:

jdbc:clickhouse://your-host.clickhouse.cloud:8443/default?ssl=true

O ClickHouse Cloud exige criptografia SSL para todas as conexões. Sem o parâmetro ?ssl=true, você verá erros de “Connection reset” mesmo com as credenciais corretas.

Para mais detalhes sobre as configurações de URL JDBC, consulte o repositório do ClickHouse JDBC driver.

​

Saiba mais

Para obter mais informações sobre o DataGrip, consulte a documentação do DataGrip.