Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Conecta QStudio a ClickHouse

View as MarkdownEdit this pageReport an issueSet up docs MCP
Mantenido por la comunidad

QStudio es una interfaz gráfica de SQL gratuita que permite ejecutar scripts SQL, explorar tablas fácilmente, crear gráficos y exportar resultados. Funciona en cualquier sistema operativo y con cualquier base de datos.

QStudio se conecta a ClickHouse mediante JDBC.

Reúne los detalles de tu ClickHouse

QStudio usa JDBC sobre HTTP(S) para conectarse a ClickHouse; necesitas:

  • endpoint
  • número de puerto
  • nombre de usuario
  • contraseña

Para conectarse a ClickHouse con HTTP(S), necesita esta información:

Parámetro(s) Descripción
HOST and PORT Normalmente, el puerto es 8443 cuando se usa TLS o 8123 cuando no se usa TLS.
DATABASE NAME De forma predeterminada, existe una base de datos llamada default; use el nombre de la base de datos a la que desea conectarse.
USERNAME and PASSWORD De forma predeterminada, el nombre de usuario es default. Use el nombre de usuario adecuado para su caso de uso.

Los detalles de su servicio de ClickHouse Cloud están disponibles en la consola de ClickHouse Cloud. Seleccione un servicio y haga clic en Connect:

Botón Connect del servicio de ClickHouse Cloud

Elija HTTPS. Los detalles de conexión se muestran en un comando curl de ejemplo.

Detalles de conexión HTTPS de ClickHouse Cloud

Si usa ClickHouse autogestionado, los detalles de conexión los establece su administrador de ClickHouse.

Descarga QStudio

QStudio está disponible en https://www.timestored.com/qstudio/download/

Agrega una base de datos

  • Cuando abras QStudio por primera vez, haz clic en Server->Add Server en el menú o en el botón para agregar un servidor en la barra de herramientas.
  • Luego configura los detalles:
Pantalla de configuración de conexión a base de datos de QStudio que muestra la configuración de conexión de ClickHouse
  1. Server Type: ClickHouse.com
  2. Ten en cuenta que en Host DEBES incluir https:// Host: https://abc.def.clickhouse.cloud Port: 8443
  3. Username: default Password: XXXXXXXXXXX
  4. Haz clic en Add

Si QStudio detecta que no tienes instalado el ClickHouse JDBC driver, te ofrecerá descargarlo por ti:

Consultar ClickHouse

  • Abre un editor de consultas y ejecuta una consulta. Puedes ejecutar consultas con:

  • Ctrl + e - Ejecuta el texto resaltado

  • Ctrl + Enter - Ejecuta la línea actual

  • Una consulta de ejemplo:

Interfaz de QStudio que muestra la ejecución de una consulta SQL de ejemplo en la base de datos ClickHouse

Siguientes pasos

Consulta QStudio para conocer sus capacidades y la documentación de ClickHouse para conocer las capacidades de ClickHouse.

Navigation