Query sui dati

Questa pagina descrive come inviare una query a un'origine dati che supporta il protocollo origine dati di Chart Tools.

Contenuti

Panoramica

Un'origine dati è un servizio web che supporta il protocollo Origine dati degli strumenti del grafico. Puoi inviare una query SQL a un'origine dati e in risposta riceverai una tabella di dati compilata con le informazioni appropriate. Alcuni esempi di origini dati includono Fogli di lavoro Google e SalesForce.

Inviare una richiesta

Per inviare una richiesta:

1. Crea un'istanza di un oggetto Query con l'URL dell'origine dati. L'URL deve indicare i dati richiesti con una sintassi comprensibile da quell'origine dati.
2. Facoltativamente, puoi specificare opzioni di richiesta come il metodo di invio come secondo parametro facoltativo nel costruttore dell'oggetto Query (per i dettagli, consulta il parametro opt_options del costruttore di query):
3. Facoltativamente, aggiungi una stringa in linguaggio di query per ordinare o filtrare i risultati e quindi inviare la richiesta. Le origini dati non sono necessarie per supportare il linguaggio di query dell'origine dati di Strumenti grafici. Se l'origine dati non supporta il linguaggio di query, la stringa di query SQL verrà ignorata, ma restituirà un DataTable. Il linguaggio di query è una variante del linguaggio SQL; leggi la sintassi completa del linguaggio di query qui.
4. Invia la query, specificando un gestore di callback che verrà chiamato quando verrà ricevuta la risposta: vedi la sezione successiva per maggiori dettagli.

Ecco un esempio di invio di una richiesta per i dati in un intervallo di celle di un foglio di lavoro Google. Per scoprire come ottenere l'URL di un foglio di lavoro Google, visita questa pagina:

function initialize() {
  var opts = {sendMethod: 'auto'};
  // Replace the data source URL on next line with your data source URL.
  var query = new google.visualization.Query('http://spreadsheets.google.com?key=123AB&...', opts);

  // Optional request to return only column C and the sum of column B, grouped by C members.
  query.setQuery('select C, sum(B) group by C');

  // Send the query with a callback function.
  query.send(handleQueryResponse);
}

function handleQueryResponse(response) {
  // Called when the query response is returned.
  ...
}

Se invii la query da Apps Script, assicurati di utilizzare la modalità IFRAME.

Elaborazione della risposta

La funzione di gestore delle risposte verrà chiamata al ritorno della richiesta. Il parametro passato alla funzione di gestore delle risposte è di tipo google.visualization.QueryResponse. Se la richiesta ha avuto esito positivo, la risposta conterrà una tabella di dati (classe google.visualization.DataTable). Se la richiesta non è andata a buon fine, la risposta conterrà informazioni sull'errore e nessun elemento DataTable.

Il gestore delle risposte deve:

1. Controlla se la richiesta è riuscita o meno chiamando response.isError(). Non dovrebbe essere necessario mostrare all'utente messaggi di errore; la libreria di visualizzazione mostrerà un messaggio di errore nel tuo contenitore <div>. Tuttavia, se vuoi gestire manualmente gli errori, puoi utilizzare la classe goog.visualization.errors per visualizzare messaggi personalizzati (vedi Esempio di wrapper query per un esempio di gestione personalizzata degli errori).
2. Se la richiesta ha esito positivo, la risposta includerà un elemento DataTable che potrai recuperare chiamando getDataTable(). Passalo al grafico.

Il codice seguente mostra la gestione della richiesta precedente di disegnare un grafico a torta:

function handleQueryResponse(response) {

  if (response.isError()) {
    alert('Error in query: ' + response.getMessage() + ' ' + response.getDetailedMessage());
    return;
  }

  var data = response.getDataTable();
  var chart = new google.visualization.PieChart(document.getElementById('chart_div'));
  chart.draw(data, {width: 400, height: 240, is3D: true});
}

Leggere i file CSV

Per creare un grafico a partire da dati CSV (valori separati da virgole), hai due opzioni: Converti manualmente i dati CSV nel formato tabella dati di Google Charts oppure posiziona il file CSV sul server web per la pubblicazione del grafico ed esegui una query utilizzando la tecnica descritta in questa pagina.

Ulteriori informazioni

• Sintassi del linguaggio di query: descrive la sintassi del linguaggio utilizzato per eseguire le query sui dati.
• Classe query: pagina di riferimento per la classe che aggrega una query.
• Classe QueryResponse: la pagina di riferimento per la classe che aggrega la risposta a una query.