Conectar ProbeDeck a ClickHouse

ProbeDeck es un cliente para iOS y iPadOS que permite comprobar el estado de un servidor de ClickHouse, inspeccionar las tablas system y ejecutar SQL. Se conecta a la interfaz HTTP de ClickHouse a través de la red del dispositivo o mediante un bastión SSH; no requiere un servidor de retransmisión.

• Instala ProbeDeck desde la App Store.
• Usa iOS o iPadOS 17.0 o una versión posterior.
• Permite que el dispositivo alcance el endpoint HTTP o HTTPS de ClickHouse a través de su red, una VPN o un bastión SSH.
• Crea un usuario de ClickHouse con acceso a las bases de datos que quieras consultar.
• Concede al usuario acceso SELECT a las tablas system pertinentes para la monitorización.

Algunas secciones de monitorización dependen de tablas de registros opcionales o de tablas del sistema más recientes. Por ejemplo, system.server_settings, que ProbeDeck utiliza para obtener el límite de memoria configurado, requiere ClickHouse 23.3 o posterior. ProbeDeck marca como limitada una sección afectada cuando su fuente no está disponible.

1. ProbeDeck envía solicitudes SQL al endpoint HTTP(S) de ClickHouse.
2. Lee datos de monitorización de las tablas system con el usuario de ClickHouse configurado.
3. La aplicación muestra los resultados de las consultas y las vistas de monitorización en el dispositivo. Un bastión SSH puede establecer la misma conexión HTTP(S) cuando no hay una ruta directa al endpoint desde el dispositivo.

Obtenga los datos de conexión del servicio

En la consola de ClickHouse Cloud, abra su servicio, seleccione Conectar y elija HTTPS.

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:

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

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

Añada la conexión en ProbeDeck

1. En la pantalla Connections, toque +.
2. Introduzca un nombre para la conexión y el host sin https://.
3. Configure Port como 8443 y active TLS.
4. Introduzca el nombre de usuario y la contraseña de la base de datos del cuadro de diálogo Conectar. El nombre de la base de datos es opcional.
5. Toque Probar conexión. Tras una comprobación correcta, ProbeDeck muestra la versión del servidor y el tiempo de ida y vuelta.
6. Toque Guardar.

ProbeDeck autentica las solicitudes SQL al endpoint del servicio con estas credenciales de base de datos. ClickHouse Cloud usa claves de nivel de organización de la página API Keys para Cloud API y los endpoints de Query API. El flujo de conexión SQL de ProbeDeck no usa esas claves.

Active SSH Tunnel en el formulario de conexión e introduzca:

1. El host del bastión y el puerto SSH (22 de forma predeterminada).
2. El nombre de usuario SSH.
3. Una contraseña SSH o una clave privada.

ProbeDeck abre un canal SSH direct-tcpip desde el bastión hasta el host de ClickHouse y el puerto HTTP(S) de la sección Server. En la primera conexión, compare la huella digital SHA-256 de la clave de host del bastión con el valor proporcionado por el administrador del servidor antes de aceptarla.

ProbeDeck envía el nombre de usuario y la contraseña de la base de datos en los encabezados de solicitud X-ClickHouse-User y X-ClickHouse-Key. No incluye credenciales en la URL.

Para TLS mutuo, active TLS Client Certificate e importe un archivo PKCS#12 (.p12) que contenga el certificado de cliente y la clave privada; a continuación, introduzca la frase de contraseña.

Cuando un endpoint autohospedado presenta un certificado autofirmado o emitido por una CA privada, ProbeDeck muestra su huella digital SHA-256, emisor, sujeto y período de validez. Compare la huella digital con el valor proporcionado por el administrador del servidor antes de aceptarlo. ProbeDeck vincula la decisión a esa conexión; si el certificado cambia, la conexión se detiene hasta que lo revise.

ProbeDeck almacena los secretos de conexión y el material de claves importado en el llavero de iOS del dispositivo.

Abra la conexión guardada y seleccione Monitor. El panel resume estas fuentes:

Pulse Consultas en ejecución para ordenar las consultas activas por tiempo transcurrido e inspeccionar el uso de memoria y las filas leídas.

Este ejemplo utiliza el conjunto de datos de precios de propiedades del Reino Unido. Carga el conjunto de datos en uk_price_paid y, a continuación:

1. Abre la conexión y selecciona Data.
2. Abre el editor de SQL.
3. Ejecuta esta consulta de solo lectura con límites:

SELECT
    town,
    count() AS sales,
    round(avg(price)) AS average_price
FROM uk_price_paid
GROUP BY town
ORDER BY sales DESC
LIMIT 10

El resultado debe contener diez localidades con sus recuentos de transacciones y precios medios.

• ProbeDeck funciona con iOS y iPadOS 17.0 o versiones posteriores.
• Los usuarios gratuitos pueden guardar una conexión a la vez. Al eliminarla, se libera el espacio; ProbeDeck Pro permite guardar un número ilimitado de conexiones.
• Admite la interfaz HTTP(S) de ClickHouse, no el protocolo nativo.
• ProbeDeck carga los resultados de SQL en páginas de 200 filas y limita cada solicitud a 10.000 filas. Use una cláusula WHERE selectiva y LIMIT para tablas grandes.
• La visibilidad de Monitoring depende de los permisos del usuario de ClickHouse y de las tablas de registros opcionales.
• El dispositivo necesita una ruta al endpoint a través de su red, una VPN o el túnel SSH integrado.
• Monitoring y las consultas SQL de solo lectura no requieren compras dentro de la aplicación. KILL QUERY, KILL MUTATION, las sentencias de escritura y DDL, y otras acciones operativas requieren ProbeDeck Pro.

• Consulta el sitio web de ProbeDeck para obtener información específica sobre el producto.
• Consulta la documentación de la interfaz HTTP de ClickHouse para configurar el servidor.