Tableau Prep-Hilfe

In diesem Artikel werden mögliche Probleme bei der Verwendung von Tableau Prep Builder und entsprechende Lösungsvorschläge aufgelistet.

Bei der Fehlerbehebung Ihres Schemas – ob selbstständig oder beim Kontakt mit dem Support – müssen Sie in der Regel die Protokolldateien und Absturzabbilddateien für die Analyse sammeln sowie die Schritte zum Reproduzieren des Fehlers dokumentieren. Die Angabe der genauen Schritte, die Sie vor dem Auftreten des Fehlers durchgeführt haben, sowie die Bereitstellung der Schemadatei ist die beste Möglichkeit, dem Entwickler oder Supportteam bei der Diagnose des Problems zu helfen.

Sammeln von Protokoll- und Absturzabbilddateien

Die Tableau Prep-Protokolldateien werden im Ordner „My Tableau Prep Repository“ gespeichert. Standardmäßig ist der Speicherort:

Windows: C:\Users\<username>\Documents\My Tableau Prep Repository\Logs.

MacOS: /users/<username>/Documents/My Tableau Prep Repository/Logs

Um das Problem richtig diagnostizieren zu können, müssen Sie alle Protokolldateien sammeln. Wenn Sie Tableau Prep Builder ausführen, befinden sich alle im Ordner „My Tableau Prep Repository/Logs“. Wenn Sie Tableau Prep über die Befehlszeile ausführen, sammeln Sie auch die Protokolldateien von „My Tableau Prep Repository/Command Line Repository/Logs.

Die folgende Tabelle enthält eine Beschreibung der erstellten Protokolldateien.

Aktivieren der Abfrageprotokollierung

Ab Tableau Prep Builder Version 2026.2 können Sie die Einstellung Abfrageprotokollierung aktivieren im Menü Hilfe > Einstellungen und Leistung aktivieren, ohne die Anwendung neu starten zu müssen. Wenn diese Einstellung aktiviert ist, wird für jede Abfrage, die Tableau Prep Builder ausführt, eine XML-Abfragedatei generiert. Dies kann bei der Fehleranalyse Ihres Schemas hilfreich sein. Die Protokolle werden erzeugt und im Abfrageordner gespeichert.

Diese Abfrageprotokolle befinden sich in den folgenden Verzeichnissen:

Windows: C:\Users\<username>\Documents\My Tableau Prep Repository\Query

MacOS: /users/<username>/Documents/My Tableau Prep Repository/Query

Ausführen von LogShark

LogShark ist ein kostenloses Open Source-Dienstprogramm für die Befehlszeile, mit dem Sie Informationen aus Prep-Protokolldateien extrahieren können, um Fehler zu beheben und Einblicke in Fehler und Nutzung zu gewinnen. Mit dem LogShark-Plug-in Prep.twbx können Sie Arbeitsmappen mit einem Fehler- und Schema-Dashboard generieren, das Ihnen beim Analysieren und Visualisieren von Problemen in Prep hilft.

Informationen über das Installieren und Ausführen von LogShark finden Sie unter Get your Computer Set Up for LogShark (So richten Sie Ihren Computer für LogShark ein).

Erstellen von Absturzabbilddateien

Sammeln Sie zusätzlich zu den Protokolldateien auch die Absturzabbilddateien. Alles, was nicht in den Protokolldateien enthalten ist, könnte hier detailliert aufgeführt sein. Dies hilft Ihnen bei der Fehlerbehebung beim Anwendungsstart, bei Ausnahmen oder bei Problemen bei der Abfrage von .hyper-Dateien.

Absturzabbilddateien sollten für die folgenden Prozesse erstellt werden.

Gehen Sie zum Erstellen von Absturzabbilddateien je nach Betriebssystem wie folgt vor.

Windows

1. Öffnen Sie den Task-Manager.

2. Klicken Sie mit der rechten Maustaste auf die Spaltenüberschrift und wählen Sie Prozessname (Process name) und Befehlszeile (Command line) aus. Dadurch werden die verschiedenen Prozesse angezeigt, und Sie können den Prozess auswählen, den Sie zum Erstellen einer Absturzabbilddatei verwenden möchten.

3. Klicken Sie mit der rechten Maustaste auf den Prozess tabminerva.exe (zuvor prepservice.exe).

4. Wählen Sie „Speicherabbilddatei erstellen“ (Create dump file) aus.

   Daraufhin wird ein Dialogfeld geöffnet, in dem der Speicherort der Absturzabbilddatei auf Ihrem System angezeigt wird.

MacOS

Unter MacOS gibt es zwei Arten von Diagnosedateien, die für die Fehlerbehebung in Tableau Prep nützlich sind:

• Absturzbericht – Zeichnet den Aufruf-Stack zum Zeitpunkt des Absturzes auf, ähnlich wie bei einem Stack-Trace.

• Core-Datei – ein vollständiger Snapshot des Prozess-Speichers zum Zeitpunkt des Absturzes.

In beiden Fällen muss der Tableau Prep-Prozess beendet werden. Nach der Erfassung dieser Dateien müssen Sie Tableau Prep neu starten.

Voraussetzung: Für die Sammlung der Core-Dateien ist Administratorzugriff erforderlich.

Schritt 1: Erstellen Sie einen Absturzbericht

1. Öffnen Sie das Terminal.

2. Führen Sie den folgenden Befehl aus: pgrep tabminerva | xargs kill -SEGV

   Dadurch wird der tabminerva.exe Prozess beendet. Ein Segmentierungsfehler-Signal wird gesendet, durch das MacOS automatisch einen Absturzbericht generiert.

3. Den gespeicherten Absturzbericht finden Sie unter: ~/Library/Logs/DiagnosticReports/

   Der Dateiname hat das Format tabminerva_YYYY-MM-DD-HHMMSS_machinename.crash oder tabminerva_YYYY-MM-DD-HHMMSS_machinename.ips.

Wenn Sie diese Datei an den Tableau-Support oder an das Entwicklungsteam senden, geben Sie an, dass Sie absichtlich ein Segmentierungsfehler-Signal gesendet haben, um diesen Bericht zu generieren. Das unterscheidet diesen Vorgang von einem echten Crash.

Schritt 2: Erstellen Sie eine Core-Datei

Erstellen Sie die Core-Datei mit einer der folgenden Optionen.

Erstellen einer Core-Datei und Beenden der Tableau Prep-Sitzung

1. Öffnen Sie das Terminal.

2. Führen Sie den Befehl sudo chmod 1777 /cores aus, um Schreibzugriff auf das Verzeichnis der Core-Dateien zu gewähren.

3. Führen Sie den Befehl ulimit -c unlimited aus, um die Größenbeschränkung der Core-Datei für die aktuelle Terminalsitzung aufzuheben.

4. Führen Sie den Befehl pgrep tabminerva | xargs kill -SEGV aus, um den Prozess zu beenden und die Core-Datei zu generieren.

5. Suchen Sie die Core-Datei in /cores/. Sie hat die Bezeichnung core.<process_id>.

Erstellen einer Core-Datei und Fortführen von Tableau Prep

Diese Option verwendet ein gcore-Dienstprogramm, um eine Absturzabbilddatei eines laufenden Prozesses zu erfassen, ohne ihn zu beenden. Für diesen Vorgang muss das Xcode-Befehlszeilentool installiert sein. Um zu überprüfen, ob Sie diese Option installiert haben, öffnen Sie Ihr Terminal und führen Sie Bash xcode-select --install aus.

1. Öffnen Sie das Terminal.

2. Führen Sie den folgenden Befehl aus: sudo gcore -o /tmp/tabminerva.core $(pgrep tabminerva)

   Dadurch wird die Core-Datei unter /tmp/tabminerva.core gespeichert. Tableau Prep wird weiterhin normal ausgeführt.

Häufige Fehler bei der Schemaausführung über die Befehlszeile

Statt Tableau Prep Builder zu öffnen und die einzelnen Schemas manuell auszuführen, können Sie Schemas auch über die Befehlszeile ausführen, um Ihre Ausgabedateien zu aktualisieren. Obwohl dieser Vorgang für Effizienz in Ihrem Schemaprozess sorgt, erhalten Sie bei der Ausführung dieses Prozesses Fehler, wenn Ihre Syntax falsch ist oder wenn Anmeldeinformationen für Ihre Verbindungen oder Ausgabespeicherorte fehlen.

Eine Liste aller in Tableau Prep unterstützten Befehlszeilenoptionen finden Sie in der Tableau Prep-Befehlszeilenreferenz(Link wird in neuem Fenster geöffnet).

In der folgenden Tabelle werden häufige Fehler und deren Behebung beschrieben. Informationen zum Ausführen von Schemata über die Befehlszeile finden Sie unter Aktualisieren von Schema-Ausgabedateien über die Befehlszeile(Link wird in neuem Fenster geöffnet).

Häufige Tableau Prep-Fehler

In der folgenden Tabelle werden einige häufige Fehler, die bei der Verwendung von Tableau Prep auftreten können, zusammen mit Lösungen beschrieben, die Sie ausprobieren können.

Andere Artikel in diesem Abschnitt