Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Conectar o QStudio ao ClickHouse

View as MarkdownEdit this pageReport an issueSet up docs MCP
Mantido pela comunidade

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.

Obtenha os detalhes do seu ClickHouse

O QStudio usa JDBC sobre HTTP(S) para se conectar ao ClickHouse; você precisa 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:

botão Connect do serviço do ClickHouse Cloud

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

detalhes de conexão HTTPS do ClickHouse Cloud

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

Baixe o QStudio

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

Adicione um banco de dados

  • Ao abrir o QStudio pela primeira vez, clique nas opções de menu Server->Add Server ou no botão de adicionar servidor na barra de ferramentas.
  • Em seguida, preencha os detalhes:
Tela de configuração da conexão com o banco de dados no QStudio mostrando as configurações de conexão do ClickHouse
  1. Tipo de servidor: ClickHouse.com
  2. Observação: em Host, você DEVE incluir https:// Host: https://abc.def.clickhouse.cloud Port: 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á baixá-lo para você:

Consultar o ClickHouse

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

  • Ctrl + e - Executa o texto destacado

  • Ctrl + Enter - Executa a linha atual

  • Um exemplo de consulta:

Interface do QStudio mostrando a execução de uma consulta SQL de exemplo no banco de dados ClickHouse

Próximos passos

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

Navigation