---
schema_version: "1"
id: 4f3747353b8c4b49500414a5aab33d7b4ea37abc7190fd7a3ea26d16ca808c5c
title: Estensioni delle tabelle
collection: tableau
version: next
locale: it-it
portal_url: https://docs.salesforce.com/tableau/next/it-it/public/desktop/td_table_extensions.md
canonical_url: https://help.tableau.com/v0.0/public/desktop/it-it/td_table_extensions.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 4ad21d93e7a7983165343bcf726b789fe3b9c6c09bac6640ea5ec301c7cb6edc
description: Create table extensions with analytics extension scripts in Tableau Desktop.
---
[Passa al contenuto principale](#main-content)

# 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 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
- Un editor low-code semplifica l’aggiunta di codice alle origini dati
- Si integra con [Guida ai dati](https://help.tableau.com/current/server/it-it/data_guide.htm) e [Interpreta i dati](https://help.tableau.com/current/server/it-it/explain_data_basics.htm)
- 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](https://help.tableau.com/current/pro/desktop/it-it/r_connection_manage.htm).

## 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](/tableau/next/it-it/public/desktop/it-it/Img/table_ext_1.PNG)

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](/tableau/next/it-it/public/desktop/it-it/Img/table_ext_2.PNG)
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](/tableau/next/it-it/public/desktop/it-it/Img/table_ext_3.PNG)

**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.

> [!TIP]
> 
> **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](https://help.tableau.com/current/pro/desktop/it-it/dashboard_extensions.htm) 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](https://www.tableau.com/it-it/developer/learning/getting-started-analytics-extensions-api) 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](https://help.tableau.com/current/pro/desktop/it-it/r_connection_manage.htm).