Consola SQL

Ejecute consultas y cree visualizaciones con la Consola SQL.

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.

​

Explorar tablas

​

Ver la lista de tablas y la información del esquema

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

Haz clic en una tabla de la lista para abrirla en una pestaña nueva. En la vista de tabla, puedes ver, seleccionar y copiar los datos fácilmente. Ten en cuenta que la estructura y el formato se conservan al copiar y pegar en aplicaciones de hojas de cálculo como Microsoft Excel y Google Sheets. Puedes pasar de una página a otra de los datos de la tabla (paginados en bloques de 30 filas) mediante la navegación del pie de página.

​

Inspección de datos de celdas

La herramienta Cell Inspector se puede usar para ver grandes cantidades de datos contenidas en una sola celda. Para abrirla, haz clic con el botón derecho en una celda y selecciona ‘Inspect Cell’. El contenido de Cell Inspector se puede copiar haciendo clic en el icono de copiar de la esquina superior derecha.

​

Filtrar y ordenar tablas

​

Ordenar una tabla

Para ordenar una tabla en Consola SQL, abra una tabla y seleccione el botón ‘Sort’ de la barra de herramientas. Este botón abrirá un menú que le permitirá configurar la ordenación. Puede elegir la columna por la que desea ordenar y configurar el orden (ascendente o descendente). Seleccione ‘Aplicar’ o pulse Intro para ordenar la tabla

Consola SQL también le permite añadir varios criterios de ordenación a una tabla. Haga clic de nuevo en el botón ‘Sort’ para añadir otro criterio de ordenación.

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 una tabla

Para filtrar una tabla en la Consola SQL, abra una tabla y seleccione el botón ‘Filter’. Al igual que con la ordenación, este botón abrirá un menú que le permitirá configurar el filtro. Puede elegir una columna por la que desea filtrar y seleccionar los criterios necesarios. La Consola SQL muestra de forma inteligente opciones de filtro que se corresponden con el tipo de datos contenido en la columna.

Cuando esté conforme con el filtro, puede seleccionar ‘Aplicar’ para filtrar los datos. También puede añadir filtros adicionales, como se muestra a continuación.

Al igual que con la funcionalidad de ordenación, haga clic en el botón ‘x’ junto a un filtro para eliminarlo.

​

Filtrar y ordenar a la vez

La consola SQL permite filtrar y ordenar una tabla al mismo tiempo. Para ello, agregue todos los filtros y criterios de ordenación que desee siguiendo los pasos descritos anteriormente y haga clic en el botón ‘Aplicar’.

​

Crear una consulta a partir de filtros y ordenaciones

La consola SQL puede convertir directamente los filtros y las ordenaciones en consultas con un solo clic. Simplemente seleccione el botón ‘Create Query’ en la barra de herramientas con los parámetros de ordenación y filtro que desee. Después de hacer clic en ‘Create query’, se abrirá una nueva pestaña de consulta ya completada con el comando SQL correspondiente a los datos que contiene la vista de tabla.

Los filtros y las ordenaciones no son obligatorios al usar la función ‘Create Query’.

Puede obtener más información sobre cómo hacer consultas en la consola SQL leyendo la (link) documentación sobre consultas.

​

Crear y ejecutar una consulta

​

Crear una consulta

Hay dos formas de crear una consulta nueva en la consola SQL.

• 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

​

Ejecutar una consulta

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.

​

Cancelar una consulta

Mientras se ejecuta una consulta, el botón ‘Run’ de la barra de herramientas del editor de consultas se reemplaza por el botón ‘Cancel’. Haz clic en este botón o pulsa Esc para cancelar la consulta. Nota: Los resultados que ya se hayan devuelto permanecerán tras la cancelación.

​

Guardar una consulta

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.

Como alternativa, puede asignar un nombre y guardar una consulta al mismo tiempo haciendo clic en “Untitled Query” en la barra de herramientas, ajustando el nombre y pulsando Intro:

​

Compartir consultas

La Consola SQL le permite compartir consultas fácilmente con los miembros de su equipo. La Consola SQL admite cuatro niveles de acceso que pueden ajustarse tanto globalmente como por usuario:

• Owner (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

Si se ha compartido una consulta contigo, aparecerá en la pestaña “Queries” de la barra lateral izquierda de Consola SQL:

​

Enlace a una consulta (permalinks)

Las consultas guardadas también tienen permalinks, lo que significa que puedes enviar y recibir enlaces a consultas compartidas y abrirlas directamente.

Los valores de cualquier parámetro presente en una consulta se añaden automáticamente a la URL de la consulta guardada como parámetros de consulta. Por ejemplo, si una consulta contiene los parámetros {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&param_end_date=2016-01-01.

​

Funciones avanzadas para consultas

​

Búsqueda en los resultados de la consulta

Después de ejecutar una consulta, puedes buscar rápidamente en el conjunto de resultados devuelto mediante el campo de búsqueda del panel de resultados. Esta función ayuda a obtener una vista previa de los resultados de una cláusula 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:

​

Ajustar la configuración de paginación

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

Los resultados de las consultas se pueden exportar fácilmente en formato CSV directamente desde la consola SQL. Para ello, abra el menú ••• situado a la derecha de la barra de herramientas del panel de resultados y seleccione ‘Descargar como CSV’.

​

Visualizar datos de consultas

Algunos datos pueden interpretarse más fácilmente en forma de gráfico. Puede crear visualizaciones rápidamente a partir de los resultados de una consulta directamente desde Consola SQL con solo unos clics. Como ejemplo, usaremos una consulta que calcula estadísticas semanales de los viajes en taxi de NYC:

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

Sin una visualización, estos resultados son difíciles de interpretar. Convirtámoslos en un gráfico.

​

Crear gráficos

Para empezar a crear la visualización, selecciona la opción ‘Chart’ en la barra de herramientas del panel de resultados de la consulta. Aparecerá un panel de configuración de gráficos:

Empezaremos creando un gráfico de barras sencillo que muestre 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

La Consola SQL admite diez tipos de gráficos que pueden seleccionarse desde el selector de tipo de gráfico en el panel de configuración del gráfico. Por ejemplo, podemos cambiar fácilmente el tipo de gráfico anterior de barras a área:

Los títulos de los gráficos coinciden con el nombre de la consulta que proporciona los datos. Si se actualiza el nombre de la consulta, el título del gráfico también se actualizará:

También pueden ajustarse varias características más avanzadas del gráfico en la sección ‘Advanced’ del panel de configuración del gráfico. Para empezar, ajustaremos esta configuración:

• 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: