Tabelltillägg

Med tabelltillägg kan du skapa datatabeller med ett skript för analystillägg. Du kan skriva ett anpassat TabPy- eller Rserve-skript och eventuellt lägga till en eller flera indatatabeller. Tabelltillägg stöds av Tableau Cloud, Tableau Server och Tableau Desktop. Detta dokument fokuserar på Tableau Cloud.

Obs! På samma sätt som för en liveanslutning uppdateras tabelltillägget varje gång du öppnar en arbetsbok eller uppdaterar en datakälla.

Fördelar

Tabelltillägg har följande fördelar för både nya och erfarna användare.

  • Integrera enkelt skript eller avancerade funktioner i Tableau

  • Dra enkelt data från dataanslutningar i Tableau som indata till skript

  • Med en redigerare utan krav på kodningskunskap är det enkelt att lägga till kod i datakällor

  • Integreras med Dataguiden och Förklara data
  • Integreras med TabPy, Rserve och andra analystillägg

  • Resultaten kan användas för att skapa instrumentpaneler och visualiseringar

Förutsättningar

Innan du kan använda tabelltillägg måste du fylla i följande lista.

  • Öppna en datakälla i Tableau Desktop eller i webbredigering.
  • Konfigurera ett analystillägg

Skapa ett tabelltillägg

Följ stegen nedan för att skapa ett tabelltillägg.

  1. Öppna en publicerad arbetsbok.
  2. Öppna eller skapa en datakälla.
  3. Under Anslutningar väljer du Nytt tabelltillägg.

    menyn Anslutningar

  4. Dra det till datamodellen.
  5. (Valfritt) Dra tabeller från dataanslutningen till rutan för tabelltillägg för att använda dem som indata i skriptet eller funktionen för analystillägg.

    • Som standard skickas data från Tableau till analystillägget och definieras som variable _arg1, en lexikonliknande struktur som: {‘colum_name’: [1,2,3], ‘column_name_2’: [3,4,5]

      Python-exempel: Indata kan konverteras till en pandas-dataram på följande sätt.

      import pandas as pddf = (pd.DataFrame(_arg1))

    • När du använder Rserve definieras indata som variabeln .arg1 och datatypen är en namngiven lista med listor.

    • För relationsdatakällor som stöds kan du använda anpassad SQL som indata i ett tabelltillägg. När parametrar används i den anpassade SQL-frågan medför en ändring av parametern att frågan körs igen och skriptet beräknas om. Detta skapar en sökväg för att dynamiskt uppdatera parametrar på en instrumentpanel och filtrera eller på annat sätt skicka värden till skriptet för tabelltillägget.

      relationella datakällor

  6. I delen Skript anger du skriptet eller funktionsanropet. Skriptet måste returnera ett lexikon eller en lista med listor, i princip ett JSON-objekt. Ett skript för Rserve måste returnera en dataram eller en lista med namngivna listor, medan skriptet för Python måste returnera ett lexikon.

    Python-exempel: Vi använder följande explicita returkommando.

    return df.to_dict(orient='list')

  7. Obs! Tabelltillägg har inte stöd för direkta anrop till TabPy-slutpunkter om TABPY_EVALUATE_ENABLE är inaktiverat i TabPy.

  8. Välj Använd för att köra skriptet.
  9. (Valfritt) Om du relaterar tabelltillägget till en annan tabell i datamodellen definierar du relationen mellan minst ett fält i varje tabell. Om fälten har samma namn kan det hända att det görs automatiskt.

  10. Välj Uppdatera nu så visas resultatet på fliken Utmatningstabell.

    resultattabell för utdata

Obs! Om du inte definierar en relation till en tabell i datamodellen är fliken Indatatabell tom och meddelandet ”Dataförhandsgranskning ej tillgänglig” visas.

  1. (valfritt) I fältet Namn anger du ett unikt namn för tabelltillägget.
  2. Gå till fliken Blad för att börja utforska och visualisera data. Resultat från ett tabelltillägg fungerar som alla andra data i Tableau som efterfrågas från en platt fil eller relationskälla.
  3. Publicera arbetsboken om du vill dela den. Publiceringsmålet, Tableau Server eller Tableau Cloud, måste ha ett aktiverat och konfigurerat analystillägg av lämplig typ.

Felsökningstips: Fel från analystillägg visas i ett Tableau-felmeddelande om det finns problem med att köra skriptet. Om tabelltillägget råkar ut för ett fel ser du till att all kod och formatering är korrekt. Prova sedan med att använda den runda knappen Uppdatera datakälla, som finns bredvid knappen Spara, eller klicka på Använd igen.

Tabelltillägg jämfört med analystillägg

Vissa av de här produkterna har inget med varandra att göra, men tabelltillägg och analystillägg har vissa gemensamma funktioner. Funktionen för tabelltillägg måste ha en anslutning till ett analystillägg för att fungera. Vi delar upp varje funktion.

Tillägg för instrumentpaneler

Med tillägg för instrumentpaneler kan anpassade webbprogram läggas till på instrumentpaneler med hjälp av SDK:t, men den här tilläggstypen hänger inte ihop med tabelltillägg.

Tabelltillägg

Med funktionen för tabelltillägg kan du skapa en tabell i en datakälla som kan skicka data och ett skript till analystillägget och returnera en fullständig tabell med godtycklig form. Det returnerade resultatet visas som en tabell i datamodellen på fliken Datakälla och som mått och dimensioner i arbetsboken.

Analystillägg

Med funktionen för analystillägg kan du utöka Tableaus beräkningar med programmeringsspråk som Python, externa verktyg och externa plattformar. När du har skapat en anslutning till ett analystillägg kan du kommunicera med den externa servern via beräknade fält, som kallas SCRIPT_X eller MODEL_EXTERNAL_X, där X är datatypen för de förväntade returvärdena. Mer information finns i Skicka uttryck med analystillägg.