Estensioni delle tabelle
Le estensioni delle tabelle consentono di creare tabelle di dati con uno script di estensioni di analisi. Puoi scrivere uno script TabPy o Rserve personalizzato e, facoltativamente, aggiungere una o più tabelle di input. Le estensioni delle tabelle sono supportate da Tableau Cloud, Tableau Server e Tableau Desktop. Questo documento è incentrato su Tableau Cloud.
Nota: così come accade in una connessione live, l’estensione della tabella si aggiorna ogni volta che apri una cartella di lavoro o aggiorni un’origine dati.
Vantaggi
Le estensioni delle tabelle offrono i seguenti vantaggi sia per gli utenti nuovi che per quelli esperti.
Integrazione semplificata di script o funzioni avanzate in Tableau
Trascinamento semplificato dei dati dalle connessioni dati di Tableau come input negli script
L’editor low code semplifica l’aggiunta di codice alle origini dati
- Si integra con Guida ai dati e Interpreta i dati
Si integra con TabPy, Rserve e altre estensioni di analisi
- I risultati possono essere utilizzati per creare dashboard o visualizzazioni
Prerequisiti
Prima di poter utilizzare le estensioni delle tabelle, devi completare l’elenco seguente.
- Apri un’origine dati in Desktop o Web Authoring.
- Configurare un’estensione di analisi
- Per le fasi di configurazione delle estensioni di analisi, consulta Passare espressioni con le estensioni di analisi.
Creare un’estensione della tabella
Per creare una chiave, completa i seguenti passaggi.
- Apri una cartella di lavoro pubblicata.
- Apri un’origine dati o creane una.
- In Connessioni, scegli Nuova estensione tabella.
- Trascinalo nel modello di dati.
(Facoltativo) Trascina le tabelle dalla connessione dati nel riquadro dell’estensione di tabella per utilizzarle come input nello script o nella funzione delle estensioni di analisi.
Per impostazione predefinita, i dati di Tableau vengono passati all’estensione di analisi e definiti come
variable _arg1
, una struttura simile a un dizionario come:{‘colum_name’: [1,2,3], ‘column_name_2’: [3,4,5]
Esempio Python: i dati di input possono essere convertiti in un dataframe Pandas utilizzando quanto segue.
import pandas as pddf = (pd.DataFrame(_arg1))
Quando si utilizza RServe, i dati di input sono definiti come la variabile .arg1 e il tipo di dati è un elenco denominato di elenchi.
Per le origini dati relazionali supportate, puoi utilizzare Custom SQL come input in un’estensione di tabella. Quando i parametri vengono utilizzati nella query SQL personalizzata, la modifica del parametro comporta la riesecuzione della query e il ricalcolo dello script. Questo crea un percorso per aggiornare dinamicamente i parametri in una dashboard e filtrare o altrimenti passare i valori allo script di estensione della tabella.
Nell’area Script, inserisci lo script o la chiamata di funzione. Lo script deve restituire un dizionario o un elenco di elenchi, essenzialmente un oggetto JSON. Uno script per RServe deve restituire un data.frame o un elenco di elenchi denominati mentre lo script per Python deve restituire un dizionario.
Esempio Python: utilizziamo il seguente comando di ritorno esplicito.
return df.to_dict(orient='list')
- Seleziona Applica per eseguire lo script.
(Facoltativo) Se stai correlando l’estensione della tabella a un’altra tabella nel modello di dati, definisci la relazione tra almeno un campo in ogni tabella. Se i campi hanno lo stesso nome, ciò può avvenire automaticamente.
- Scegli Aggiorna ora e i risultati verranno visualizzati nella scheda Tabella di output.
Nota: le estensioni di tabella non supportano la chiamata diretta agli endpoint TabPy se TABPY_EVALUATE_ENABLE è disabilitato in TabPy.
Nota: se non si definisce una relazione con una tabella nel modello di dati, la scheda Tabella di input è vuota e visualizzerà il messaggio "Anteprima dati non disponibile".
- (Facoltativo) Nel campo Nome immetti un nome univoco per l’estensione della tabella.
- Vai alla scheda Foglio per iniziare a esplorare e visualizzare i dati. I risultati di un’estensione di tabella funzionano come qualsiasi altro dato in Tableau interrogato da un file flat o da un’origine relazionale.
- Pubblica la cartella di lavoro per condividerla. La destinazione di pubblicazione, Server o Tableau Cloud, deve disporre di un’estensione di analisi del tipo appropriato abilitata e configurata.
Suggerimento per la risoluzione dei problemi: se si verifica un problema durante l’esecuzione dello script, gli errori delle estensioni di analisi verranno visualizzati in un messaggio di errore di Tableau. Se l’estensione della tabella riscontra un errore, assicurati che tutto il codice e la formattazione siano corretti e prova a utilizzare il pulsante circolare Aggiorna origine dati, situato accanto al pulsante Salva, oppure fai di nuovo clic su Applica.
Estensioni tabella ed Estensioni di analisi
Sebbene alcuni di questi prodotti non siano correlati, le estensioni delle tabelle e le estensioni di analisi condividono numerose funzioni. La funzione estensioni della tabella si basa su una connessione con estensioni di analisi per funzionare. Vediamo in dettaglio ogni funzione.
Estensioni di dashboard
Le estensioni di dashboard consentono l’aggiunta di applicazioni Web personalizzate alle dashboard utilizzando Dashboard Extension SDK, tuttavia questo tipo di estensione non è correlato alle estensioni di tabella.
Estensioni delle tabelle
La funzione Estensioni tabella consente di creare una tabella in un’origine dati che può inviare dati e uno script all’estensione di analisi e restituire come risultato una tabella completa di forma arbitraria. I risultati generati vengono visualizzati come tabella nel modello di dati nella scheda Origine dati e come misure e dimensioni nella cartella di lavoro.
Estensioni di analisi
La funzione Estensioni di analisi ti consente di estendere i calcoli di Tableau con linguaggi di programmazione come Python, strumenti esterni e piattaforme esterne. Dopo aver creato una connessione a un’estensione di analisi, puoi comunicare con il tuo server esterno tramite campi calcolati denominati SCRIPT_X o MODEL_EXTERNAL_X, dove X è il tipo di dati dei valori restituiti previsti. Per maggiori informazioni, consulta Passare espressioni con le estensioni di analisi.