¿Desea extraer datos de su sitio de Discourse pero no sabe por dónde empezar? ¡Ha llegado al lugar correcto! Esta es una guía de tutorial para principiantes que son nuevos en el Explorador de Datos. Si ya está familiarizado con SQL y cómo usar el Explorador de Datos, entonces lo más probable es que no necesite leer este tema y tal vez quiera consultar nuestra categoría Data & reporting en su lugar.
¿Desea extraer datos de su sitio de Discourse pero no sabe por dónde empezar? ¡Ha llegado al lugar correcto! Esta es una guía de El objetivo de esta guía es ayudarle a comprender los conceptos básicos de cómo utilizar el Explorador de Datos para crear informes en su sitio de Discourse, y es la primera parte de nuestra serie de Tutoriales del Explorador de Datos.
¿Qué es el Explorador de Datos?
El Explorador de Datos es un plugin de Discourse que le permite ejecutar consultas SQL contra su base de datos y exportar los resultados. Es una herramienta potente para extraer y analizar datos de su sitio de Discourse.
Antes de poder utilizar el Explorador de Datos, deberá instalarlo en su sitio. Consulte Install plugins on a self-hosted site si necesita ayuda con esto.
Una vez que haya instalado el Explorador de Datos, puede empezar a utilizarlo para ejecutar consultas SQL.
Creando nuestra primera consulta SQL
¡La mejor manera de familiarizarse con el Explorador de Datos es tener experiencia práctica!
Comencemos creando nuestra primera consulta:
- Vaya a la administración de su sitio y haga clic en la pestaña
Plugins. - Busque el plugin
Data Explorery haga clic en él. - Haga clic en el botón
+para ver un cuadro de texto y un botón para crear una nueva consulta SQL. - Escriba el nombre de su consulta.
- Haga clic en
Create Newpara crear la consulta.
A partir de aquí podemos empezar a construir nuestra primera consulta.
La página de consulta nueva predeterminada:
Hola Mundo
Para nuestra primera consulta, creemos un informe que nos muestre: Los Temas Más Vistos en el Sitio 
Pensando en cómo tendremos que crear esto, comencemos seleccionando los campos title y views de la tabla topics:
SELECT
title, views
FROM
topics
Lo que nos mostrará una lista de todos los temas del sitio y el número de visitas que tienen. Haga clic en Run para ver esto en acción:
Ordenando Resultados
Al observar estos resultados, notará que no están ordenados; esto se debe a que necesitamos usar explícitamente una declaración ORDER BY para ordenar nuestros resultados como deseamos. Agreguémoslo ahora:
SELECT
title, views
FROM
topics
ORDER BY views DESC
Hagamos clic en Run nuevamente para ver qué cambió:
¡Ahí lo tiene! Nuestros resultados ahora están ordenados en orden descendente por visitas.
Formateando Resultados
Con esta consulta, ¿no sería bueno si pudiéramos hacer clic directamente en el nombre del tema y ser llevados al tema? ¡Qué bueno que podemos hacer esto con Formatted Table Results!
Cambiemos la sección title de nuestra consulta a id as topic_id para ver esto en acción:
SELECT
id as topic_id,
views
FROM
topics
ORDER BY views DESC
¡Ahora los títulos de los temas se muestran como hipervínculos!
respuestasque tiene el tema.
Agregando Parámetros y declaraciones WHERE
Como adición final a la consulta, modifiquemos la consulta para que solo veamos temas con más de X número de visitas. Para hacer esto, necesitaremos agregar un parámetro y una declaración WHERE. Para nuestro parámetro, usaremos un int (entero), y la declaración WHERE filtrará los resultados para que solo se muestren los temas con más del número mínimo de visitas.
-- [params]
-- int :min_views= 10
SELECT
id as topic_id,
views
FROM
topics
WHERE views > :min_views
ORDER BY views DESC
Al ejecutar esta consulta, ahora verá que hay un parámetro min_views que puede usar para cambiar el número mínimo de visitas que los temas deben tener para mostrarse en los resultados.
Conclusión
Esperamos que esté empezando a tener una idea de cómo se construyen las consultas del Explorador de Datos después de seguir estos pasos, sin embargo, ¡apenas hemos arañado la superficie en este tema!
El Explorador de Datos, y en general, SQL es un tema muy, muy amplio. Si está interesado en aprender más sobre el Explorador de Datos y las Consultas SQL, le recomendamos encarecidamente que lea los otros temas de esta serie.