Estensioni delle tabelle

Le estensioni tabella 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.

Nota: un’estensione tabella si aggiorna ogni volta che apri una cartella di lavoro o aggiorni un’origine dati.

Vantaggi

Le estensioni tabella offrono i seguenti vantaggi sia per i nuovi utenti 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
  • Un 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.

Creare un’estensione della tabella

Per creare una chiave, completa i seguenti passaggi.

  1. Apri una cartella di lavoro.
  2. Apri un’origine dati o creane una.
  3. In Connessioni, scegli Nuova estensione tabella.
  4. Trascina il foglio nel modello di dati.
  5. (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:{‘column_name’: [1,2,3], ‘column_name_2’: [3,4,5]

    • Dati di input Python: i dati di input possono essere convertiti in un dataframe Pandas utilizzando quanto segue: import pandas as pddf = (pd.DataFrame(_arg1))
    • Dati di input RServe: i dati di input sono definiti come variable.arg1 e il tipo di dati è un elenco denominato di elenchi.
    • Dati di input SQL personalizzato: per le origini dati relazionali supportate, puoi utilizzare SQL personalizzato come input in un’estensione 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.

      Nota: se un parametro viene utilizzato in un’estensione tabella, tale parametro non potrà essere eliminato finché non verrà rimosso dall’estensione. L’eliminazione di un parametro richiamato nell’estensione tabella può causare un errore irreversibile.

      origini dati relazionali

  1. Sotto Script, inserisci lo script o la chiamata di funzione. Lo script deve restituire un dizionario o un elenco di elenchi, ad esempio un oggetto JSON. Uno script per RServe deve restituire un data.frame o un elenco di elenchi denominati. Uno script per Python deve restituire un dizionario.
    • Esempio Python: utilizza il seguente comando di restituzione esplicito: return df.to_dict(orient='list')
    • Nota: le estensioni di tabella non supportano la chiamata diretta agli endpoint TabPy se TABPY_EVALUATE_ENABLE è disabilitato in TabPy.

  2. Seleziona Applica per eseguire lo script.

    finestra di dialogo dello script

  3. (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.
  4. Nella griglia dei dati sotto Tabella di output scegli Aggiorna ora. I risultati verranno visualizzati nella scheda Tabella di output.

    tabella dei risultati di output

Nota: se non si definisce una relazione con una tabella nel modello di dati, la scheda Tabella di input è vuota e visualizza il messaggio “Anteprima dati non disponibile”.

  1. (Facoltativo) Nel campo Nome immetti un nome univoco per la nuova estensione tabella.
  2. Vai alla scheda Foglio per iniziare a esplorare e visualizzare i dati.
  3. Pubblica la cartella di lavoro per condividerla. La destinazione di pubblicazione deve disporre di un’estensione di analisi del tipo appropriato abilitata e configurata.

Suggerimento per la risoluzione dei problemi: se l’estensione tabella presenta un errore, verifica innanzitutto che tutto il codice e la formattazione siano corretti. Prova quindi a utilizzare il pulsante circolare Aggiorna origine dati nella barra degli strumenti o fai nuovamente clic su Applica.

Confrontare i tipi di estensione

Sebbene alcuni dei seguenti 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.

Estensioni delle tabelle

Le estensioni tabella consentono 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. I risultati generati vengono visualizzati come una tabella nel modello di 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 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.