Tabellenerweiterungen
Tabellenerweiterungen ermöglichen es Ihnen, mit einem Analytics-Erweiterungen-Skript Datentabellen zu erstellen. Sie können ein benutzerdefiniertes TabPy- oder Rserve-Skript schreiben und optional ein oder mehrere Eingabetabellen hinzufügen.
Hinweis: Eine Tabellenerweiterung wird jedes Mal aktualisiert, wenn Sie eine Arbeitsmappe öffnen oder eine Datenquelle aktualisieren.
Vorteile
Tabellenerweiterungen bieten neuen und erfahrenen Benutzern die folgenden Vorteile.
Skripte oder erweiterte Funktionen können einfach in Tableau integriert werden
Daten aus Tableau-Datenverbindungen können einfach als Eingabe in Skripte gezogen werden
Der Low-Code-Editor erleichtert das Hinzufügen von Code zu Datenquellen
- Ermöglicht die Integration mit Datenhandbuch und Erklär die Daten
Ermöglicht die Integration mit TabPy, Rserve und anderen Analytics-Erweiterungen
- Ergebnisse können zur Erstellung von Dashboards oder Visualisierungen verwendet werden
Voraussetzungen
Bevor Sie Tabellenerweiterungen verwenden können, müssen Sie die folgende Liste durchgehen.
- Öffnen Sie eine Datenquelle in Desktop oder der Webdokumenterstellung.
- Konfigurieren einer Analytics-Erweiterung
- Schritte zum Konfigurieren von Verbindungen zu Analytics-Erweiterungen finden Sie unter Übergeben von Ausdrücken mit Analytics-Erweiterungen.
Erstellen einer Tabellenerweiterung
Führen Sie die folgenden Schritte aus, um eine Tabellenerweiterung zu erstellen.
- Öffnen Sie eine Arbeitsmappe.
- Öffnen Sie eine Datenquelle oder erstellen Sie eine.
- Wählen Sie unter Verbindungen die Option Neue Tabellenerweiterung aus.
- Ziehen Sie das Blatt in das Datenmodell.
- (Optional) Ziehen Sie Tabellen aus der Datenverbindung in den Tabellenerweiterungsbereich, um sie als Eingabe in Ihr Analytics-Erweiterungsskript oder Ihre Funktion zu verwenden. Standardmäßig werden Daten von Tableau an die Analytics-Erweiterung übergeben und als
variable _arg1
definiert, eine wörterbuchähnliche Struktur wie:
{‘colum_name’: [1,2,3], ‘column_name_2’: [3,4,5]
Python-Eingabedaten: Die Eingabedaten können wie folgt in einen Pandas-Datenrahmen konvertiert werden.
import pandas as pddf = (pd.DataFrame(_arg1))
Rserve-Eingabedaten: Bei Verwendung von Rserve werden die Eingabedaten als
variable.arg1
definiert, und der Datentyp ist eine benannte Liste von Listen.Benutzerdefinierte SQL-Eingabedaten: Für unterstützte relationale Datenquellen können Sie benutzerdefinierte SQL als Eingabe in eine Tabellenerweiterung verwenden. Wenn Parameter in der benutzerdefinierten SQL-Abfrage verwendet werden, bewirkt eine Änderung des Parameters, dass die Abfrage erneut ausgeführt und das Skript neu berechnet wird. Dadurch wird ein Pfad erstellt, durch den Parameter in einem Dashboard dynamisch aktualisiert und Werte gefiltert oder andernfalls an das Tabellenerweiterungsskript übergeben werden.
Geben Sie unter Skript Ihr Skript oder Ihren Funktionsaufruf ein. Das Skript muss ein Wörterbuch oder eine Liste von Listen zurückgeben, z. B. ein JSON-Objekt. Ein Skript für RServe muss einen data.frame oder eine Liste benannter Listen zurückgeben. Ein Skript für Python muss ein Wörterbuch zurückgeben.
Python-Beispiel: Verwenden Sie den folgenden expliziten Rückgabebefehl.
return df.to_dict(orient='list')
Hinweis: Tabellenerweiterungen unterstützen das direkte Aufrufen von TabPy-Endpunkten nicht, wenn TABPY_EVALUATE_ENABLE in TabPy deaktiviert ist.
- Wählen Sie Übernehmen, um das Skript auszuführen.
(Optional) Wenn Sie die Tabellenerweiterung mit einer anderen Tabelle im Datenmodell verknüpfen, definieren Sie die Beziehung zwischen mindestens einem Feld in jeder Tabelle.
Wählen Sie im Datenraster unter Ausgabetabelle die Option Jetzt aktualisieren aus. Die Ergebnisse werden auf der Registerkarte "Ausgabetabelle" angezeigt.
Hinweis: Wenn Sie keine Beziehung zu einer Tabelle im Datenmodell definieren, ist die Registerkarte "Eingabetabelle" leer, und die Meldung "Datenvorschau nicht verfügbar" wird angezeigt.
- (Optional) Geben Sie im Feld Name einen eindeutigen Namen für Ihre neue Tabellenerweiterung ein.
- Wechseln Sie zur Registerkarte Blatt, um mit der Untersuchung und Visualisierung der Daten zu beginnen.
- Veröffentlichen Sie die Arbeitsmappe, um sie freizugeben. Für das Veröffentlichungsziel muss eine Analytics-Erweiterung vom entsprechenden Typ aktiviert und konfiguriert sein.
Tipp zur Fehlerbehebung: Wenn bei Ihrer Tabellenerweiterung ein Fehler auftritt, stellen Sie sicher, dass der gesamte Code und die Formatierung korrekt sind, und verwenden Sie die kreisförmige Schaltfläche "Datenquelle aktualisieren" neben der Schaltfläche "Speichern" oder klicken Sie erneut auf "Übernehmen".
Vergleichen von Erweiterungstypen
Auch wenn nicht alle folgenden Produkte miteinander zusammenhängen, haben Tabellenerweiterungen und Analytics-Erweiterungen einige gemeinsame Merkmale. Das Feature "Tabellenerweiterungen" benötigt eine Verbindung zu einer Analytics-Erweiterung, um funktionieren zu können. Schauen wir uns beide Features genauer an.
Dashboarderweiterungen
Dashboard-Erweiterungen ermöglichen das Hinzufügen benutzerdefinierter Webanwendungen zu Dashboards mithilfe des Dashboard Extension SDK.
Tabellenerweiterungen
Mit dem Feature "Tabellenerweiterungen" können Sie eine Tabelle in einer Datenquelle erstellen, die Daten und ein Skript an Ihre Analytics-Erweiterung sendet und als Ergebnis eine vollständige Tabelle beliebiger Form zurückgibt. Die zurückgegebenen Ergebnisse werden im Datenmodell als Tabelle und in einer Arbeitsmappe als Kennzahlen und Dimensionen angezeigt.
Analytics-Erweiterungen
Mithilfe des Features Analytics-Erweiterungen können Sie Tableau-Berechnungen um Programmiersprachen (wie Python), externe Tools und externe Plattformen erweitern.
Nachdem Sie eine Verbindung zu einer Analytics-Erweiterung hergestellt haben, können Sie mit Ihrem externen Server über berechnete Felder mit der Bezeichnung SCRIPT_X
oder MODEL_EXTERNAL_X
kommunizieren, wobei X
der Datentyp der erwarteten Rückgabewerte ist. Weitere Informationen finden Sie unter Übergeben von Ausdrücken mit Analytics-Erweiterungen.