Tabeluitbreidingen

Met tabeluitbreidingen kunt u datatabellen maken met een script voor analyse-uitbreidingen. U kunt een aangepast TabPy- of Rserve-script schrijven en optioneel een of meer invoertabellen toevoegen.

Opmerking: een tabeluitbreiding wordt telkens vernieuwd wanneer u een werkmap opent of een databron vernieuwt.

Voordelen

Tabeluitbreidingen bieden nieuwe en ervaren gebruikers de volgende voordelen.

  • Eenvoudig scripts of geavanceerde functies in Tableau integreren
  • Eenvoudig data uit Tableau-dataverbindingen als invoer in scripts slepen
  • Een bewerker met weinig code editor maakt het toevoegen van code aan databronnen eenvoudig
  • Integreert met Datagids en Data uitleggen
  • Integreert met TabPy, Rserve en andere analyse-uitbreidingen
  • Resultaten kunnen worden gebruikt om dashboards of visualisaties te maken

Vereisten

Voordat u tabeluitbreidingen kunt gebruiken, moet u de volgende lijst invullen.

Een tabeluitbreiding maken

Voer de volgende stappen uit om een tabeluitbreiding te maken.

  1. Open een werkmap.
  2. Open een databron of maak a een.
  3. Kies onder Verbindingen Nieuwe tabeluitbreiding.
  4. Sleep het blad naar het datamodel.
  5. (Optioneel) Sleep tabellen uit de dataverbinding naar het deelvenster Tabeluitbreiding om ze te gebruiken als invoer in uw script of functie voor analyse-uitbreidingen.

    Standaard worden data van Tableau doorgegeven aan de analyse-uitbreiding en gedefinieerd als de variable _arg1. Dit betreft een woordenboekachtige structuur zoals:{‘column_name’: [1,2,3], ‘column_name_2’: [3,4,5]

    • Python-invoerdata: de invoerdata kunnen als volgt worden omgezet naar een pandas-dataframe: import pandas as pddf = (pd.DataFrame(_arg1))
    • RServe-invoerdata: de invoerdata worden gedefinieerd als de variable.arg1 en het datatype is een benoemde lijst met lijsten.
    • Aangepaste SQL-invoerdata: voor ondersteunde relationele databronnen kunt u aangepaste SQL gebruiken als invoer in een tabeluitbreiding. Wanneer parameters worden gebruikt in de aangepaste SQL-query, zorgt het wijzigen van de parameter ervoor dat de query opnieuw wordt uitgevoerd en het script opnieuw wordt berekend. Hiermee wordt een pad gemaakt om parameters in een dashboard dynamisch bij te werken en waarden te filteren of op een andere manier door te geven aan het script voor de tabeluitbreiding.

      Let op: als een parameter in een tabeluitbreiding wordt gebruikt, kan die parameter pas worden verwijderd nadat deze uit de uitbreiding is verwijderd. Het verwijderen van een parameter die in een tabeluitbreiding wordt aangeroepen, kan een fatale fout veroorzaken.

      relationele databronnen

  1. Voer onder Script uw script of functie-aanroep in. Het script moet een woordenboek of een lijst met lijsten retourneren, zoals een JSON-object. Een script voor RServe moet een data.frame of een lijst met benoemde lijsten retourneren. Een script voor Python moet een woordenboek retourneren.
    • Python-voorbeeld: gebruik de volgende expliciete return-opdracht: return df.to_dict(orient='list')
    • Opmerking: tabeluitbreidingen ondersteunen het rechtstreeks aanroepen van TabPy-eindpunten niet als TABPY_EVALUATE_ENABLE is uitgeschakeld in TabPy.

  2. Selecteer Toepassen om het script uit te voeren.

    dialoogvenster script

  3. (Optioneel) Als u de tabeluitbreiding aan een andere tabel in het datamodel koppelt, definieert u de relatie tussen ten minste één veld in elke tabel.
  4. in het dataraster onder Uitvoertabel kiest u Nu bijwerken. De resultaten worden weergegeven in het tabblad Uitvoertabel.

    tabel uitvoerresultaten

Opmerking: als u geen relatie met een tabel in het datamodel definieert, is het tabblad Invoertabel leeg en wordt het bericht 'Datavoorbeeld niet beschikbaar' weergegeven.

  1. (Optioneel) Voer in het veld Naam een unieke naam in voor uw nieuwe tabeluitbreiding.
  2. Ga naar het tabblad Blad om de data te verkennen en visualiseren.
  3. Publiceer de werkmap om deze te delen. Voor de publicatiebestemming moet een analyse-uitbreiding van het juiste type zijn ingeschakeld en geconfigureerd.

Tip voor probleemoplossing: als er een fout optreedt met uw tabeluitbreiding, controleer dan of alle code en opmaak correct zijn. Probeer het dan met de ronde knop Databron vernieuwen in de werkbalk of klik nogmaals op Toepassen.

Uitbreidingstypen vergelijken

Hoewel sommige van de volgende producten niet gerelateerd zijn, delen tabel- en analyse-uitbreidingen verschillende functies. De functie tabeluitbreidingen is afhankelijk van een verbinding met analyse-uitbreiding. Laten we elke functie eens nader bekijken.

Dashboarduitbreidingen

Dashboarduitbreidingen maken het mogelijk om aangepaste webtoepassingen toe te voegen aan dashboards met de Dashboard Extension SDK.

Tabeluitbreidingen

Met tabeluitbreidingen kunt u een tabel in een databron maken die data en een script naar uw analyse-uitbreiding kan sturen en als resultaat een volledige tabel kan retourneren. De geretourneerde resultaten worden weergegeven als een tabel in het datamodel en als meetwaarden en dimensies in een werkmap.

Analyse-uitbreidingen

Met de functie Analyse-uitbreidingen kunt u Tableau-berekeningen uitbreiden met programmeertalen zoals Python, externe tools en externe platforms.

Nadat u een verbinding met een analyse-uitbreiding hebt gemaakt, kunt u communiceren met uw externe server via berekende velden met de naam SCRIPT_X of MODEL_EXTERNAL_X, waar X het datatype van de verwachte retourwaarden is. Zie Expressies met analyse-uitbreidingen doorgeven voor meer informatie.