Cliente ClickHouse para Mac
Ejecuta SQL analítico por la interfaz HTTP de ClickHouse, lee el plan, el pipeline o la estimación de filas de una consulta y gestiona las partes y particiones MergeTree desde la pestaña Partes. Las consultas largas informan de las filas leídas mientras se ejecutan, y Detener las termina en el servidor.
Funciona en MacEl controlador viene con la app para Mac


De un vistazo
- Lenguaje de consulta
- SQL
- Controlador
- Incluido en la app para Mac
- Conectar mediante
- Host y puerto, Túnel SSH, SSL/TLS
- Puerto predeterminado
- 8123
- iPhone y iPad
- No se abre
Conectar
Indica el host y el puerto HTTP, un usuario y, si quieres, una base de datos. El cambio de base se hace sin reconectar; cada pestaña abierta conserva la base inicial. Ver > Barra lateral como árbol muestra las bases del servidor en un árbol que puedes desplegar directamente.
Elige cualquier modo SSL para pasar a HTTPS. Los puertos 443 o 8443, este último usado por ClickHouse Cloud, activan Verificar identidad, que comprueba el certificado con tu archivo de CA o el almacén de confianza del sistema. Verificar CA necesita un archivo de CA; un certificado de cliente y su clave permiten acceder a servidores que requieren TLS mutuo.
Sin TLS, accede a un servidor remoto mediante un túnel SSH en lugar de enviar HTTP sin cifrar por la red.
Consulta y edita
Cada consulta lleva su propio ID y solicita información de progreso, de modo que una consulta larga informa de las filas leídas. Detener envía KILL QUERY para ese ID, y el tiempo de espera de consulta de la conexión llega al servidor.
El menú Explicar ofrece Plan, Pipeline, AST, Sintaxis y Estimación. La salida con sangría se representa como diagrama o árbol; Estimación muestra las filas, marcas y partes que leería la consulta.
Las ediciones de la cuadrícula se envían como INSERT, ALTER TABLE … UPDATE y ALTER TABLE … DELETE, con Vista previa SQL antes. ClickHouse ejecuta actualizaciones y eliminaciones como mutaciones en segundo plano, por lo que guardar significa que se han aceptado, todavía no aplicado; system.mutations muestra el progreso. Las vistas materializadas se abren en solo lectura.
Un resultado con tuplas de puntos o anillos de ClickHouse se abre en la vista Mapa. Una consulta con su propia cláusula FORMAT muestra la salida bruta del servidor en una columna; omite la cláusula para obtener una cuadrícula.
Tablas, partes y particiones
Una tabla se abre con las pestañas Estructura, Índices, DDL y Partes. Índices muestra la clave de ordenación y los índices de omisión de datos; DDL muestra el CREATE TABLE completo, incluidos el motor y los ajustes.
Partes enumera cada parte de system.parts con su partición, filas, tamaño en disco, fecha de modificación e indicador de actividad, y permite ejecutar Optimizar, Eliminar partición y Desvincular partición.
La pestaña Estructura añade, modifica y elimina columnas y elimina índices de omisión de datos. La clave de ordenación y la primaria se fijan al crear la tabla, así que añade un índice de omisión con ALTER TABLE … ADD INDEX y vuelve a crear la tabla para otros cambios.
Supervisar
El Panel del servidor muestra consultas y fusiones activas, mutaciones de partes y uso de disco; enumera las demás sesiones con Terminar sesión en cada una y lee las consultas lentas de system.query_log: las consultas finalizadas más recientes que tardaron más de un segundo.
Transfiere datos
Carga archivos CSV, TSV, JSON, JSONL, XLSX y SQL con Importar y exporta tablas o resultados de consultas como CSV, JSON, SQL, XLSX, Markdown, HTML y XML. Si una columna contiene siquiera un valor que no sea UTF-8 válido, se muestra en hexadecimal en la cuadrícula; selecciona toValidUTF8(column) para leerla como texto.
iPhone y iPad
La app para iPhone y iPad no tiene un controlador de ClickHouse. Las conexiones de ClickHouse sincronizadas desde un Mac aparecen en la lista, pero no se abren.
Limitaciones
- Las conexiones usan la interfaz HTTP de ClickHouse. No se usa el protocolo TCP nativo.
- TLS está desactivado por defecto. Elige un modo SSL en el formulario de conexión para usar HTTPS.
- Sin claves foráneas ni transacciones.
- Una sentencia SET no se conserva para la siguiente consulta.
Preguntas sobre ClickHouse
¿Cómo cambio un ajuste para una consulta?
Inclúyelo en una cláusula SETTINGS de la consulta, como SELECT … SETTINGS max_threads = 4. Cada sentencia es su propia solicitud HTTP sin sesión, así que un SET separado desaparece en la siguiente.
¿Por qué no conecta el puerto 9000?
El puerto 9000 es el puerto TCP nativo de ClickHouse, que TablePro no usa. Conecta al puerto HTTP, o al 8443 para HTTPS en ClickHouse Cloud, y comprueba que la interfaz HTTP esté activada: una solicitud a /ping en ese puerto responde Ok.
Consigue TablePro
Requiere macOS 13 Ventura o posterior