Vuoi estrarre dati dal tuo sito Discourse ma non sai da dove iniziare? Sei nel posto giusto! Questa è una guida tutorial per principianti che hanno poca familiarità con il Data Explorer. Se hai già familiarità con SQL e con l’uso del Data Explorer, allora molto probabilmente non avrai bisogno di leggere questo argomento e potresti voler consultare invece la nostra categoria Data & reporting.
Vuoi estrarre dati dal tuo sito Discourse ma non sai da dove iniziare? Sei nel posto giusto! Questa è una guida L’obiettivo di questa guida è aiutarti a farti un’idea di base su come utilizzare il Data Explorer per creare report sul tuo sito Discourse, ed è la prima parte della nostra serie di tutorial sul Data Explorer.
Cos’è il Data Explorer?
Il Data Explorer è un plugin di Discourse che ti permette di eseguire query SQL sul tuo database ed esportare i risultati. È uno strumento potente per estrarre e analizzare dati dal tuo sito Discourse.
Prima di poter utilizzare il Data Explorer, dovrai installarlo sul tuo sito. Vedi Install plugins on a self-hosted site se hai bisogno di assistenza.
Una volta installato il Data Explorer, puoi iniziare a usarlo per eseguire query SQL.
Creazione della nostra prima query SQL
Il modo migliore per familiarizzare con il Data Explorer è fare un po’ di pratica!
Iniziamo creando la nostra prima query:
- Vai alla sezione admin del tuo sito e fai clic sulla scheda
Plugins. - Trova il plugin
Data Explorere fai clic su di esso. - Fai clic sul pulsante
+per visualizzare una casella di testo e un pulsante per creare una nuova query SQL. - Digita il nome della tua query.
- Fai clic su
Create Newper creare la query.
Da qui possiamo iniziare a costruire la nostra prima query.
La pagina della nuova query predefinita:
Hello World
Per la nostra prima query, creiamo un report che ci mostri: Gli argomenti più visti sul sito 
Pensando a come dovremo crearlo, iniziamo selezionando i campi title e views dalla tabella topics:
SELECT
title, views
FROM
topics
Questo ci mostrerà un elenco di tutti gli argomenti sul sito e il numero di visualizzazioni che hanno. Fai clic su Run per vederlo in azione:
Ordinamento dei risultati
Guardando questi risultati, noterai che non sono ordinati: questo perché dobbiamo usare esplicitamente un’istruzione ORDER BY per ordinare i nostri risultati come desiderato. Aggiungiamola ora:
SELECT
title, views
FROM
topics
ORDER BY views DESC
Facciamo di nuovo clic su Run per vedere cosa è cambiato:
Ecco fatto: i nostri risultati sono ora ordinati in ordine discendente per visualizzazioni!
Formattazione dei risultati
Con questa query, non sarebbe bello se potessimo fare clic direttamente sul nome dell’argomento ed essere portati all’argomento? È un bene che possiamo farlo con i Risultati Tabella Formattati!
Modifichiamo la sezione title della nostra query in id as topic_id per vedere questo in azione:
SELECT
id as topic_id,
views
FROM
topics
ORDER BY views DESC
Ora i titoli degli argomenti sono visualizzati come collegamenti ipertestuali!
risposteche l’argomento ha.
Aggiunta di parametri e istruzioni WHERE
Per la nostra ultima aggiunta alla query, modifichiamo la query in modo da visualizzare solo gli argomenti con più di X numero di visualizzazioni. Per fare ciò, dovremo aggiungere un parametro e un’istruzione WHERE. Per il nostro parametro, useremo un int (intero) e l’istruzione WHERE filtrerà i risultati in modo che vengano visualizzati solo gli argomenti con più del numero minimo di visualizzazioni.
-- [params]
-- int :min_views= 10
SELECT
id as topic_id,
views
FROM
topics
WHERE views > :min_views
ORDER BY views DESC
Quando esegui questa query, vedrai ora che c’è un parametro min_views che puoi utilizzare per modificare il numero minimo di visualizzazioni che gli argomenti devono avere per essere visualizzati nei risultati.
Conclusione
Speriamo che tu stia iniziando a farti un’idea di come vengono costruite le query del Data Explorer dopo aver seguito questi passaggi, tuttavia, abbiamo appena scalfito la superficie in questo argomento!
Il Data Explorer, e più in generale, SQL è un argomento molto, molto vasto. Se sei interessato a saperne di più sul Data Explorer e sulle query SQL, ti consigliamo vivamente di leggere gli altri argomenti di questa serie.