 |
Resumen | Discourse Data Explorer te permite realizar consultas SQL contra tu base de datos en vivo, lo que permite informes de estadísticas actualizados al minuto. |
 |
Guía de instalación | Este plugin viene incluido con el núcleo de Discourse. No es necesario instalar el plugin por separado. |
Si buscas ejemplos o soporte para consultas personalizadas, puedes encontrar muchos temas en nuestra categoría #data-reporting bajo la etiqueta sql-query. Si no hay uno que se adapte a tus necesidades particulares, siéntete libre de crear un nuevo tema para pedir ayuda a la comunidad.
Ayuda con consultas
¿Alojado por nosotros? Este plugin está disponible en nuestros planes Business y Enterprise. Data Explorer | Discourse - Civilized Discussion
Después de instalar el plugin, ve a /admin/plugins.
Haz clic en el botón «Configuración» y activa data explorer enabled, luego regresa y recarga la página.
Ahora debería haber una pestaña en la navegación apilada llamada «Data Explorer». Selecciónala o ve a /admin/plugins/discourse-data-explorer, luego usa los botones +, Importar o Ejecutar para empezar.
Consultas predeterminadas
En una instalación nueva, el Data Explorer ahora incluye varias consultas que pueden ayudarte a obtener información sobre la actividad de tu foro. Abre cualquier consulta y haz clic en Ejecutar para probarla.
Así es como se ven las consultas estándar.
Nota: Las consultas predeterminadas se obtienen de este archivo: discourse-data-explorer/lib/discourse_data_explorer/queries.rb at main · discourse/discourse-data-explorer · GitHub
Si tienes una consulta increíble que quieres que todos tengan, haz una PR como esta.
Las consultas predeterminadas no se pueden editar; si deseas modificarlas, siéntete libre de copiar el SQL y pegarlo en una nueva consulta.
Escribiendo consultas
Cuando haces clic en cualquiera de los botones Editar en una vista de consulta o inicias una nueva consulta de explorador, se te presenta una pantalla como la siguiente:
Los dos cuadros superiores son el nombre y la descripción de la consulta. El nombre es lo que seleccionas en el cuadro desplegable, y la descripción debe usarse para cosas como explicar qué poner en los parámetros de la consulta o describir qué datos se están consultando.
El panel izquierdo es donde escribes la consulta SQL. Se proporciona resaltado de sintaxis y verificación menores.
Ejecución automática de consultas
Aunque siempre puedes ejecutar una consulta haciendo clic en el botón Ejecutar, puedes ahorrar tiempo al cargar una consulta agregando el parámetro run a la URL.
Por ejemplo: /admin/plugins/discourse-data-explorer/queries/123?run
Cuando se agrega este parámetro a la URL, la consulta se ejecuta tan pronto como cargas la página, por lo que no necesitas hacer clic en el botón Ejecutar para ver los resultados. Esto es especialmente útil para consultas que ejecutas con frecuencia, permitiéndote marcarlas como favoritas o agregarlas a tu barra lateral con el parámetro run incluido para un informe de un solo clic.
Importando consultas
Para un ejemplo, importemos una que escribí. Descarga este archivo, luego abre el cuadro de diálogo de importación y selecciona el archivo para subirlo o pega la consulta en el cuadro de texto. Haz clic en Importar para guardarla y luego haz clic en Ejecutar para ver los resultados.
most-common-likers.dcquery (1).json (442 Bytes)
Parece que todos los desarrolladores de Discourse se gustan bastante 
Buscando consultas
Si has acumulado demasiadas consultas increíbles, ¡no hay problema! La barra de búsqueda puede ayudarte a filtrar por títulos y descripciones.
Permitir que grupos no de personal ejecuten consultas
Puedes agregar grupos específicos (incluidos los moderadores) a una consulta para concederles acceso a ella:
Después de guardar, puedes encontrarla en la página de Grupos para ese grupo particular en la pestaña Informes:
Haz clic en cualquier consulta para abrirla y luego en el botón Ejecutar para ver los resultados. También puedes marcar como favoritas los informes de grupo haciendo clic en el botón Marcar como favorita.
Compartiendo consultas con parámetros predefinidos
Si has incluido parámetros definidos por el usuario en tu consulta, puedes compartir un enlace a la consulta e incluir los parámetros en la URL para que se rellenen automáticamente cuando se cargue la página.
Debes incluir los parámetros en la URL en este formato params={"nombre_del_parámetro":"valor"}. Separa múltiples parámetros con comas. Por ejemplo:
discourse.example.com/g/my-group/reports/6?params={"param1":"valor1","param2":"valor2"}
Combinado con el parámetro run mencionado anteriormente, puedes compartir un informe con parámetros predefinidos que se ejecute automáticamente al cargarse.
Límites de resultados y exportación de consultas
Con consultas grandes, es posible que notes que hay un límite en el número de filas que Data Explorer mostrará. Por defecto, el límite está establecido en 1000 filas. Esto es para evitar que consultas excesivamente grandes ralenticen o interrumpan el rendimiento de tu instancia de Discourse.
Si deseas omitir este límite, tienes varias opciones:
- Paginación: Puedes paginar tus resultados. En lugar de intentar devolver todos los resultados a la vez, puedes escribir tu consulta para devolver un rango específico de resultados. Luego puedes ajustar este rango para ver diferentes secciones de tus datos. Esto no aumentará el límite, pero te permitirá ver todos tus datos en secciones.
- Aumentar el límite: Si tienes acceso al servidor de Discourse y te sientes cómodo haciendo cambios en la configuración de Discourse, puedes aumentar el límite. Sin embargo, esto debe hacerse con precaución. Aumentar el límite puede poner mucha carga en tu servidor si no tienes cuidado, especialmente si varios usuarios ejecutan consultas grandes al mismo tiempo.
- Descargar los resultados: También tienes la opción de descargar los resultados de la consulta en lugar de verlos directamente en Discourse haciendo clic en el botón
JSONoCSVdespués de ejecutar la consulta. Los datos descargados de una consulta en formato JSON o CSV tendrán un límite de resultados mucho más alto de 10,000 filas. Para fines programáticos, es mejor optar por el formato JSON, o si deseas trabajar con los datos en una aplicación de hoja de cálculo, el formato CSV podría ser más conveniente.
Generalmente es una buena idea intentar escribir consultas más eficientes o filtrar tus datos para que solo recuperes lo que necesitas, en lugar de intentar omitir el límite.
También puedes exportar la consulta SQL en formato .JSON haciendo clic en el botón Exportar. Las consultas exportadas de esta manera luego pueden importarse en otros sitios de Discourse o usarse con aplicaciones de terceros.
Plan de consulta
La casilla de verificación «Incluir plan de consulta» puede usarse para comprender y optimizar mejor tus consultas SQL.
Cuando marcas esta casilla y ejecutas una consulta, Discourse mostrará la secuencia de operaciones utilizadas para acceder a los datos en la base de datos de Discourse. Esto puede incluir operaciones como escaneos, uniones, ordenamientos y otras acciones de base de datos. Al examinar el plan de consulta, puedes ver exactamente cómo la base de datos está ejecutando tu consulta.
La serie de tutoriales de Data Explorer
También tenemos una serie dedicada sql-tutorial sobre Data Explorer! Si estás interesado en aprender más sobre cómo escribir consultas SQL en Discourse, recomendamos encarecidamente leer los temas de esta serie: