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. Tabeluitbreidingen worden ondersteund door Tableau Cloud, Tableau Server en Tableau Desktop. Dit document richt zich op Tableau Cloud.
Opmerking: de tabeluitbreiding wordt, net als bij een live verbinding, 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
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.
- Open een databron in Desktop of Webauthoring.
- Een analyse-uitbreiding configureren
- Zie Expressies met analyse-uitbreidingen doorgeven voor stappen om verbindingen met analyse-uitbreidingen te configureren.
Een tabeluitbreiding maken
Voer de volgende stappen uit om een tabeluitbreiding te maken.
- Open een gepubliceerde werkmap.
- Open een databron of maak er een.
- Kies onder verbindingen Nieuwe tabeluitbreiding.
- Sleep deze naar het datamodel.
(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:{‘colum_name’: [1,2,3], ‘column_name_2’: [3,4,5]
Python-voorbeeld: de invoerdata kunnen als volgt worden omgezet naar een pandas-dataframe.
import pandas as pddf = (pd.DataFrame(_arg1))
Bij gebruik van RServe worden de invoerdata gedefinieerd als de variabele .arg1 en is het datatype een benoemde lijst met lijsten.
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.
Voer in het gedeelte Script uw script of functieaanroep in. Het script moet een woordenboek of een lijst met lijsten retourneren, in feite een JSON-object. Een script voor RServe moet een data.frame of een lijst met benoemde lijsten retourneren, terwijl een script voor Python een woordenboek moet retourneren.
Python-voorbeeld: we gebruiken de volgende expliciete return-opdracht.
return df.to_dict(orient='list')
- Selecteer Toepassen om het script uit te voeren.
(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. Als de velden dezelfde naam hebben, kan dit automatisch gebeuren.
- Kies Nu bijwerken en de resultaten verschijnen in het tabblad Uitvoertabel.
Opmerking: tabeluitbreidingen ondersteunen het rechtstreeks aanroepen van TabPy-eindpunten niet als TABPY_EVALUATE_ENABLE is uitgeschakeld in TabPy.
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.
- (Optioneel) Voer in het veld Naam een unieke naam in voor uw tabeluitbreiding.
- Ga naar het tabblad Blad om de data te verkennen en visualiseren. Resultaten van een tabeluitbreiding functioneren op dezelfde manier als andere data in Tableau die worden opgevraagd uit een bestand zonder opmaak of relationele bron.
- Publiceer de werkmap om deze te delen. Voor de publicatiebestemming (Server of Tableau Cloud) moet een analyse-uitbreiding van het juiste type zijn ingeschakeld en geconfigureerd.
Tip voor probleemoplossing: fouten van analyse-uitbreidingen worden weergegeven in een Tableau-foutbericht als er een probleem is met de uitvoering van het script. 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, naast de knop Opslaan, of klik nogmaals op Toepassen.
Tabeluitbreidingen Vs. analyse-uitbreidingen
Hoewel sommige van deze 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
Dashboard-uitbreidingen: hiermee kunt u aangepaste webtoepassingen toevoegen aan dashboards met de Dashboard Extension SDK. Dit type uitbreiding is echter niet gerelateerd aan tabeluitbreidingen.
Tabeluitbreidingen
Met de functie Tabeluitbreidingen kunt u een tabel in een databron maken die data en een script naar uw Analytics-extensie kan sturen en als resultaat een volledige tabel met een willekeurige vorm kan retourneren. De geretourneerde resultaten worden weergegeven als een tabel in het datamodel op het tabblad Databron en als meetwaarden en dimensies in de 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. Hierbij is X het datatype van de verwachte retourwaarden. Zie Expressies met analyse-uitbreidingen doorgeven voor meer informatie.