Conectar o QStudio ao ClickHouse

QStudio é uma ferramenta SQL gratuita.

QStudio é uma interface gráfica SQL gratuita que permite executar scripts SQL, navegar facilmente pelas tabelas, criar gráficos e exportar resultados. Funciona em qualquer sistema operacional e com qualquer banco de dados.

O QStudio se conecta ao ClickHouse usando JDBC.

​

1. Reúna as informações do seu ClickHouse

O QStudio usa JDBC via HTTP(S) para se conectar ao ClickHouse; você precisará de:

• endpoint
• número da porta
• nome de usuário
• senha

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. Baixe o QStudio

O QStudio está disponível em https://www.timestored.com/qstudio/download/

​

3. Adicione um banco de dados

• Ao abrir o QStudio pela primeira vez, clique nas opções do menu Server->Add Server ou no botão de adicionar servidor na barra de ferramentas.
• Em seguida, preencha os detalhes:

1. Tipo de servidor: Clickhouse.com
2. Observação: em Host, você DEVE incluir https:// Host: https://abc.def.clickhouse.cloud Porta: 8443
3. Nome de usuário: default Senha: XXXXXXXXXXX
4. Clique em Add

Se o QStudio detectar que você não tem o ClickHouse JDBC driver instalado, ele oferecerá fazer o download para você:

​

4. Consultar o ClickHouse

• Abra um editor de consultas e execute uma consulta. Você pode executar consultas usando:

• Ctrl + e - Executa o texto selecionado

• Ctrl + Enter - Executa a linha atual

• Um exemplo de consulta:

​

Próximos passos

Consulte o QStudio para conhecer os recursos do QStudio e a documentação do ClickHouse para conhecer os recursos do ClickHouse.