Consola SQL es la forma más rápida y sencilla de explorar y consultar sus bases de datos en ClickHouse Cloud. Puede usar Consola SQL para:
- Conectarse a sus servicios de ClickHouse Cloud
- Ver, filtrar y ordenar los datos de las tablas
- Ejecutar consultas y visualizar los resultados con solo unos clics
- Compartir consultas con los miembros del equipo y colaborar de forma más eficaz.
En el área de la barra lateral izquierda encontrará una vista general de las tablas de su instancia de ClickHouse. Use el selector de bases de datos en la parte superior de la barra lateral izquierda para ver las tablas de una base de datos concreta
Las tablas de la lista también se pueden desplegar para ver las columnas y los tipos
Explorar los datos de una tabla
Inspección de datos de celdas
Los criterios de ordenación se aplican en el orden en que aparecen en el panel de ordenación (de arriba abajo). Para eliminar un criterio de ordenación, simplemente haga clic en el botón ‘x’ situado junto a él.
Filtrar y ordenar a la vez
Crear una consulta a partir de filtros y ordenaciones
Los filtros y las ordenaciones no son obligatorios al usar la función ‘Create Query’.
Crear y ejecutar una consulta
- Haz clic en el botón ’+’ de la barra de pestañas
- Selecciona el botón ‘New Query’ en la lista de consultas de la barra lateral izquierda
Para ejecutar una consulta, escriba su comando o comandos SQL en el SQL Editor y haga clic en el botón ‘Run’ o use el atajo cmd / ctrl + enter. Para escribir y ejecutar varios comandos de forma secuencial, asegúrese de añadir un punto y coma después de cada comando.
Opciones de ejecución de consultas
De forma predeterminada, al hacer clic en el botón Run se ejecutarán todos los comandos incluidos en el SQL Editor. La Consola SQL admite otras dos opciones de ejecución de consultas:
- Ejecutar los comandos seleccionados
- Ejecutar el comando en la posición del cursor
Para ejecutar los comandos seleccionados, resalte el comando deseado o la secuencia de comandos y haga clic en el botón ‘Run’ (o use el atajo cmd / ctrl + enter). También puede seleccionar ‘Run selected’ en el menú contextual del SQL Editor (que se abre al hacer clic con el botón derecho en cualquier parte del editor) cuando haya una selección.
El comando ubicado en la posición actual del cursor puede ejecutarse de dos maneras:
- Seleccione ‘At Cursor’ en el menú ampliado de opciones de ejecución (o use el atajo de teclado correspondiente
cmd / ctrl + shift + enter
- Seleccione ‘Run at cursor’ en el menú contextual del SQL Editor
El comando situado en la posición del cursor parpadeará en amarillo al ejecutarse.
Esc para cancelar la consulta. Nota: Los resultados que ya se hayan devuelto permanecerán tras la cancelación.
Guardar las consultas permite encontrarlas fácilmente más adelante y compartirlas con otros miembros del equipo. La Consola SQL también permite organizar las consultas en carpetas.
Para guardar una consulta, simplemente haga clic en el botón “Save”, justo al lado del botón “Run” en la barra de herramientas. Introduzca el nombre que desee y haga clic en “Save Query”.
El atajo cmd / ctrl + s también guarda cualquier cambio en la pestaña de consulta actual.
- Propietario (puede ajustar las opciones para compartir)
- Permiso de escritura
- Acceso de solo lectura
- Sin acceso
Después de guardar una consulta, haga clic en el botón “Share” de la barra de herramientas. Aparecerá una ventana modal con opciones para compartir:
Para ajustar el acceso a la consulta para todos los miembros de la organización con acceso al servicio, simplemente ajuste el selector de nivel de acceso en la fila superior:
Después de aplicar lo anterior, la consulta podrá ser vista (y ejecutada) por todos los miembros del equipo con acceso a la Consola SQL del servicio.
Para ajustar el acceso a la consulta para miembros específicos, seleccione el miembro del equipo deseado en el selector “Add a team member”:
Después de seleccionar un miembro del equipo, debería aparecer una nueva fila con un selector de nivel de acceso:
Acceder a consultas compartidas
Enlace a una consulta (permalinks)
{start_date: Date} y {end_date: Date}, el permalink puede verse así: https://console.clickhouse.cloud/services/:serviceId/console/query/:queryId?param_start_date=2015-01-01¶m_end_date=2016-01-01.
Funciones avanzadas para consultas
Búsqueda en los resultados de la consulta
WHERE adicional o, simplemente, a comprobar que el conjunto de resultados incluye datos concretos. Después de introducir un valor en el campo de búsqueda, el panel de resultados se actualizará y devolverá los registros que contengan una entrada que coincida con el valor introducido. En este ejemplo, buscaremos todas las apariciones de breakfast en la tabla hackernews para los comentarios que contengan ClickHouse (sin distinguir entre mayúsculas y minúsculas):
Nota: se devolverá cualquier campo que coincida con el valor introducido. Por ejemplo, el tercer registro de la captura de pantalla anterior no coincide con ‘breakfast’ en el campo by, pero sí en el campo text:
De forma predeterminada, el panel de resultados de la consulta mostrará todos los registros en una sola página. Para conjuntos de resultados más grandes, puede ser preferible paginar los resultados para facilitar su visualización. Esto puede hacerse usando el selector de paginación en la esquina inferior derecha del panel de resultados:
Al seleccionar un tamaño de página, la paginación se aplicará inmediatamente al conjunto de resultados y las opciones de navegación aparecerán en el centro del pie del panel de resultados
Exportar datos de resultados de consultas
••• situado a la derecha de la barra de herramientas del panel de resultados y seleccione ‘Descargar como CSV’.
Visualizar datos de consultas
SELECT
toStartOfWeek(pickup_datetime) AS week,
sum(total_amount) AS fare_total,
sum(trip_distance) AS distance_total,
count(*) AS trip_total
FROM
nyc_taxi
GROUP BY
1
ORDER BY
1 ASC
trip_total por week. Para ello, arrastraremos el campo week al eje X y el campo trip_total al eje Y:
La mayoría de los tipos de gráficos admiten varios campos en los ejes numéricos. Para demostrarlo, arrastraremos el campo fare_total al eje Y:
Personalización de gráficos
- Subtítulo
- Títulos de los ejes
- Orientación de las etiquetas del eje x
Nuestro gráfico se actualizará en consecuencia:
En algunos casos, puede ser necesario ajustar de forma independiente las escalas de los ejes de cada campo. Esto puede hacerse en la sección ‘Advanced’ del panel de configuración del gráfico, especificando valores mínimos y máximos para el rango de un eje. Por ejemplo, el gráfico anterior se ve bien, pero, para mostrar la correlación entre nuestros campos trip_total y fare_total, es necesario ajustar un poco los rangos de los ejes:
