Problemen in Tableau Prep Builder oplossen

In dit artikel worden de problemen beschreven die u kunt tegenkomen bij het gebruik van Tableau Prep Builder. Ook worden suggesties voor het oplossen van deze problemen gegeven.

Wanneer u problemen met uw flow oplost, of u nu zelf fouten oplost of contact opneemt met de ondersteuning, moet u doorgaans de crashdump- en logboekbestanden verzamelen voor analyse en de stappen documenteren die nodig zijn om de fout te reproduceren. De beste manier om de ontwikkelaar of het ondersteuningsteam te helpen bij het vaststellen van het probleem is door de exacte stappen op te geven die u hebt uitgevoerd voordat de fout optrad en het flowbestand te verschaffen.

Logboek- en crashdumpbestanden verzamelen

De Tableau Prep-logboekbestanden zijn opgeslagen in de map Mijn Tableau Prep-opslagplaats. Dit is de standaardlocatie:

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

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

U dient alle logboekbestanden te verzamelen om het probleem goed te kunnen diagnosticeren. Als u Tableau Prep Builder gebruikt, hebt u alles in de map Mijn Tableau Prep-opslagplaats/Logboekbestanden nodig. Als u Tableau Prep uitvoert vanaf de opdrachtregel, voeg dan de logboekbestanden toe vanaf Mijn Tableau Prep-opslagplaats/Opdrachtregelopslagplaats/Logboeken.

In de volgende tabel worden de verschillende logboekbestanden beschreven die worden gegenereerd.

Naam logboekbestand	Proces dat het logboekbestand genereert	Beschrijving
app.log	Tableau Prep.exe	Logboekbestand van de gebruikersinterface. Dit wordt geproduceerd door de JavaScript-code die in het Electron-proces wordt uitgevoerd.
backendProcessManager.log	Tableau Prep.exe	Dit wordt geproduceerd door de JavaScript-code die het Java-proces opstart en monitort.
preprestapi.log	Java.exe	Dit is het logboekbestand dat door de Java-code wordt geproduceerd. Hier vindt u logboekvermeldingen met betrekking tot het gebruik van de REST API, compilatie, cachebeheer en het opstarten en afsluiten van het tabminerva-proces (voorheen prepservice).
Log.txt	prepservice.exe tabminerva.exe	Dit is het logboekbestand dat door de C++-code wordt geproduceerd. Dit logboekbestand bevat alle interactie met de gedeelde Tableau-technologiestack, zoals verbindingen met databases, query's, uitvoering, externe cachegeheugens, querypipeline, protocollen en meer.
tdeserver.txt	tdeserver64.exe	Dit is het logboekbestand dat door de oude Tableau-data-engine is gemaakt. Tableau Prep maakt nog steeds gebruik van Tableau-data-engine.
tabprotosrv.txt	tabprotosrv.exe	Het logboekbestand voor de protocolserver. Alle activiteiten waarvoor u een gehost databasestuurprogramma gebruikt, resulteren in logboekregels in dit bestand.
hyperd.log	hyperd.exe	Het hyperlogboekbestand. Hier vindt u query's en fouten met betrekking tot query's.

Vastleggen van query's inschakelen

Vanaf Tableau Prep Builder versie 2026.2 kunt u de instelling Vastleggen van query's inschakelen in het menu Help > Instellingen en prestaties inschakelen zonder dat u de toepassing opnieuw moet opstarten. Wanneer deze instelling is ingeschakeld, wordt er voor elke query die Tableau Prep Builder uitvoert een XML-querybestand gegenereerd. Dit kan handig zijn bij het diagnosticeren van problemen met uw flow. De logboekbestanden worden gegenereerd en opgeslagen in de map Query.

Help-menu in Tableau Prep met de opties in het menu Instellingen en Prestaties.

U vindt deze querylogbestanden in de volgende directory's:

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

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

LogShark uitvoeren

LogShark is een gratis opensource-opdrachtregelprogramma waarmee u informatie uit Prep-logboekbestanden kunt extraheren om problemen op te lossen en inzicht te krijgen in fouten en gebruik. Met de plugin Prep.twbx van LogShark kunt u werkmappen genereren met een fout- en flowdashboard waarmee u Prep-problemen kunt analyseren en visualiseren.

Zie Uw computer instellen voor LogShark (in het Engels) voor informatie over het installeren en uitvoeren van LogShark.

Crashdumpbestanden maken

Naast de logboekbestanden is het ook verstandig om crashdumpbestanden te verzamelen. Hier vindt u wellicht zaken die niet in de logboekbestanden staan en kunnen helpen bij het oplossen van problemen met het opstarten van de toepassing, met uitzonderingen of met het uitvoeren van query's op .hyper.

Het is nuttig om crashdumpbestanden te maken voor de volgende processen.

Proces	Beschrijving
tabminerva.exe (voorheen prepservice.exe)	Dit is het systeemeigen proces dat de rest van de Tableau Prep-bedrijfslogica host. Het is ook het proces dat de gedeelde systeemeigen Tableau-technologie bevat, zoals databaseconnectors.
hyperd.exe	Dit is het hyperdatabaseproces. Elke keer dat een query mislukt. Crashdumps van hyper kunnen handig zijn wanneer er een fout optreedt, omdat veel Tableau Prep-activiteiten te maken hebben met query's naar hyper.

Ga als volgt te werk om crashdumpbestanden te maken, afhankelijk van uw besturingssysteem.

Windows

Open Taakbeheer.
Klik met de rechtermuisknop op de kolomkop en selecteer Procesnaam en Opdrachtregel. Dan worden de verschillende processen weergegeven en kunt u het proces selecteren dat u wilt gebruiken om een crashdumpbestand te maken.
Klik met de rechtermuisknop op het proces tabminerva.exe (voorheen prepservice.exe).
Selecteer Dumpbestand maken.
Er verschijnt een dialoogvenster waarin de locatie van het crashdumpbestand in uw systeem wordt weergegeven.

MacOS

Op MacOS zijn er twee soorten diagnostische bestanden die handig zijn voor het oplossen van problemen met Tableau Prep:

Crashrapport: registreert de aanroepstack op het moment van de crash, vergelijkbaar met een stacktrace.
Kernbestand: een volledige momentopname van het geheugen van het proces op het moment van beëindiging.

In beide gevallen moet het Tableau Prep-proces worden beëindigd. Nadat u deze bestanden hebt verzameld, moet u Tableau Prep opnieuw starten.

Vereiste: u hebt beheerderstoegang nodig om kernbestanden te kunnen verzamelen.

Stap 1: maak een crashrapport

Open Terminal.
Voer deze opdracht uit: pgrep tabminerva | xargs kill -SEGV
Hiermee beëindigt u het tabminerva.exe-proces door er een signaal betreffende een segmentatiefout naartoe te sturen, waardoor MacOS automatisch een crashrapport genereert.
U vindt het opgeslagen crashrapport in: ~/Library/Logs/DiagnosticReports/
De bestandsnaam heeft de volgende indeling: tabminerva_JJJJ-MM-DD-UUMMSS_machinename.crash of tabminerva_JJJJ-MM-DD-UUMMSS_machinename.ips

Als u dit bestand naar de Tableau-ondersteuning of naar het ontwikkelingsteam verzendt, dient u te vermelden dat u opzettelijk een signaal betreffende een segmentatiefout hebt verzonden om het rapport te genereren. Dit onderscheidt dit rapport van een echte crash.

Stap 2: maak een kernbestand

Maak op een van de volgende manieren een kernbestand:

Een kernbestand maken en de Tableau Prep-sessie beëindigen

Open Terminal.
Voer de opdracht sudo chmod 1777 /cores uit om schrijftoegang te verlenen tot de directory met het kernbestand.
Voer de opdracht ulimit -c unlimited uit om de limiet voor de grootte van kernbestanden op te heffen voor de huidige Terminal-sessie.
Voer de opdracht pgrep tabminerva | xargs kill -SEGV uit om het proces te beëindigen en het kernbestand te genereren.
Zoek het kernbestand in /cores/ met de naam core.<process_id>.

Een kernbestand maken en zorgen dat Tableau Prep actief blijft

Deze optie benut een gcore-hulpprogramma om een kerndump van een actief proces vast te leggen zonder het proces te beëindigen. Voor dit proces moet de opdrachtregeltool Xcode zijn geïnstalleerd. Open uw Terminal en voer Bash xcode-select --install uit om te controleren of u deze optie hebt geïnstalleerd.

Open Terminal.
Voer deze opdracht uit: sudo gcore -o /tmp/tabminerva.core $(pgrep tabminerva)
Hiermee wordt het kernbestand opgeslagen in /tmp/tabminerva.core. Tableau Prep blijft normaal werken.

Veelvoorkomende fouten bij gebruik van de opdrachtregel om flows uit te voeren

U kunt flows vanaf de opdrachtregel uitvoeren om uw uitvoerbestanden te vernieuwen in plaats van Tableau Prep Builder te openen om elke flow handmatig uit te voeren. Hoewel dit proces de efficiëntie van uw flowproces vergroot, ontvangt u bij het uitvoeren van dit proces foutmeldingen als uw syntaxis onjuist is of als er referenties voor uw verbindingen of uitvoerlocaties ontbreken.

Zie Tableau Prep-opdrachtregelreferentie(Link wordt in een nieuw venster geopend) voor een lijst met alle opdrachtregelopties die in Tableau Prep worden ondersteund.

In de onderstaande tabel worden veelvoorkomende fouten beschreven, en de manier waarop u deze kunt oplossen. Zie Uitvoerbestanden van een flow vernieuwen vanaf de opdrachtregel(Link wordt in een nieuw venster geopend) voor informatie over het uitvoeren van flows vanaf de opdrachtregel.

Fout	Oorzaak	Oplossing
'Ontbrekende argumenten'	Een van de vereiste opdrachtregelargumenten ontbreekt.	Gebruik 'tableau-prep-cli -help' om een lijst met argumenten voor de opdrachtregel te weer te geven.
'Kan het verbindingenbestand niet lezen.'	Er zitten fouten in de syntaxis of indeling van het bestand credentials.json voor de invoerverbindingen.	Controleer de syntaxis voor de invoerverbindingen in het .json-bestand. Zie Uitvoerbestanden van een flow vernieuwen vanaf de opdrachtregel(Link wordt in een nieuw venster geopend) voor meer informatie en voorbeelden.
'De flow bevat fouten. Kan de flow niet uitvoeren. Controleer of het .json-bestand met referenties alle vereiste referenties bevat. Open de flow in Tableau Prep Builder om foutgegevens te bekijken.'	Er ontbreken referenties in het bestand credentials.json voor de invoerverbindingen, of de flow bevat fouten.	Controleer of het .json-bestand de referenties voor alle verbindingen bevat en open het flowbestand in Tableau Prep Builder om te zien of er fouten in de flow staan. Als de flow fouten bevat, moet u deze oplossen en de flow opnieuw publiceren naar Tableau Server. Probeer vervolgens nogmaals om het proces uit te voeren.
'Kan geen overeenkomst vinden voor <hostnaam van invoerverbindingen>'	Er ontbreekt een vermelding voor de hostnaam (servernaam) in het bestand credentials.json.	Zorg ervoor dat het bestand credentials.json de juiste referenties voor de hostnaam (servernaam) bevat. Zie Uitvoerbestanden van een flow vernieuwen vanaf de opdrachtregel(Link wordt in een nieuw venster geopend) voor meer informatie en voorbeelden.
'We hebben geen referenties voor alle verbindingen in het tfl-/tflx-bestand. De volgende verbindingen zijn niet gevonden: <hostnaam van invoerverbindingen>'	Het bestand credentials.json ontbreekt of bevat onjuiste referenties voor de hostnaam (servernaam) die in het foutbericht wordt weergegeven.	Zorg ervoor dat het bestand credentials.json de juiste referenties voor de hostnaam (servernaam) in het foutbericht bevat. Zie Uitvoerbestanden van een flow vernieuwen vanaf de opdrachtregel voor meer informatie en voorbeelden.
'Fout bij het aanmelden bij server <server-URL> als gebruiker <gebruikersnaam>. Controleer de referenties.'	Het bestand credentials.json bevat onjuiste referenties voor Tableau Server.	Zorg ervoor dat het bestand credentials.json alle juiste referenties en elementen voor de uitvoerverbinding bevat. Zie Uitvoerbestanden van een flow vernieuwen vanaf de opdrachtregel voor meer informatie en voorbeelden.
'Kan niet aanmelden als <gebruikersnaam> op server <server-URL> (<inhoud-URL>)'	Het bestand credentials.json bevat onjuiste referenties voor Tableau Server.	Zorg ervoor dat het bestand credentials.json alle juiste referenties en elementen voor de uitvoerverbinding bevat. Zie Uitvoerbestanden van een flow vernieuwen vanaf de opdrachtregel voor meer informatie en voorbeelden.
'We beschikken niet over de referenties voor Tableau Server om een extract te publiceren voor een of meer uitvoerknooppunten in het tfl-/tflx-bestand.'	Het bestand credentials.json is niet doorgegeven als opdrachtregelargument of bevat geen referenties voor de uitvoerverbinding.	Zorg ervoor dat het pad naar het bestand credentials.json is opgenomen in de opdrachtregel en controleer of het bestand credentials.json alle juiste referenties en elementen voor de uitvoerverbinding bevat. Zie Uitvoerbestanden van een flow vernieuwen vanaf de opdrachtregel voor meer informatie en voorbeelden.
'Loom REST API-server niet gestart'	De installatie of omgevingsconfiguratie is onjuist.	Zorg ervoor dat Tableau Prep Builder correct is geïnstalleerd en dat u de opdracht uitvoert als beheerder. Zie Tableau Desktop of Tableau Prep Builder installeren via de gebruikersinterface(Link wordt in een nieuw venster geopend) (in het Engels) voor informatie over het installeren van Tableau Prep Builder.
'Fout. Flowbestand bestaat niet.'	Het pad naar het flowbestand is onjuist.	Zorg ervoor dat het juiste pad naar het flowbestand in de opdrachtregel is opgenomen.
'Fout. Verbindingenbestand bestaat niet.'	Het pad naar het bestand credentials.json is onjuist.	Zorg ervoor dat het juiste pad naar het bestand credentials.json in de opdrachtregel is opgenomen.
'Kan geen overeenkomst vinden voor <mapr01:5181>,<mapr02:5181>,<mapr03:5181>'	U moet een specifieke poort-ID opgeven wanneer u verbinding maakt met Apache Drill via ZooKeeper.	Voeg een credentials.json-bestand toe aan de opdrachtregel die "port": 31010 specificeert voor de invoerreferenties.

Veelvoorkomende Tableau Prep-fouten

In de volgende tabel vindt u een beschrijving van enkele veelvoorkomende fouten die kunnen optreden als u Tableau Prep gebruikt en van de oplossingen die u kunt proberen.

Fout	Oorzaak	Oplossing	Kennisartikel
Kan niet verbinden met Tableau Server. Controleer of de server actief is en of de URL correct is. `tableauErrorCode=0xD5A9A6F9; tableauStatusCode=UNAUTHENTICATED; exceptionName=VizportalAuthenticationException`	Een proxy of firewall blokkeert de ingesloten browser van Tableau Prep Builder, zodat de Tableau Cloud-inloghandshake niet kan worden voltooid.	Vraag de IT-afdeling om Tableau Cloud-URL's via de proxy op een toelatingslijst te zetten. Meld u af en weer aan vanuit Tableau Prep Builder. Als u een automatisch script voor proxyconfiguratie hebt, controleer dan of dit verificatie verwerkt zonder om referenties te vragen.	Kan niet aanmelden bij Tableau Online vanuit Tableau Prep Builder in een proxy-omgeving waarvoor verificatie vereist is (in het Engels)(Link wordt in een nieuw venster geopend)
Het vereiste SSL-certificaat ontbreekt mogelijk of komt niet overeen met het Tableau Server-certificaat voor [serverhostname]. Wordt ook wel weergegeven als Unable to find requested certificate path for flow ID'(Kan aangevraagd certificaatpad voor flow-ID niet vinden) bij het uitvoeren van flows op de server.	Er ontbreekt een SSL-certificaatketenbestand in Tableau Server of het ketenbestand is niet geïnstalleerd op de computer waarop Tableau Prep Builder wordt uitgevoerd. Soms wordt het probleem veroorzaakt doordat een AWS-loadbalancer gebruikmaakt van incompatibel TLS-beleid.	Controleer of het SSL-certificaatketenbestand is geüpload naar Tableau Server. Installeer het certificaat op de computer waarop Prep Builder wordt uitgevoerd (als na dubbelklikken op en selectie van Certificaat installeren het bericht 'The file is invalid for use as the following: Security Certificate' (Het bestand is ongeldig voor gebruik als het volgende: Beveiligingscertificaat) wordt geretourneerd, is het certificaatbestand zelf wellicht corrupt. Exporteer in samenwerking met de IT-afdeling een geldig ketenbestand. Als u achter een AWS loadbalancer werkt, downgrade het beleid dan naar ELBSecurityPolicy-TLS-1-2-2017-01.	Fout: Het vereiste SSL-certificaat ontbreekt mogelijk of komt niet overeen met het Tableau Server-certificaat - aanmelden vanuit Tableau Prep (in het Engels)(Link wordt in een nieuw venster geopend)
Tableau Prep Builder wordt niet uitgevoerd omdat een onderliggend proces onverwachts is gestopt. Installeer het product opnieuw als het probleem aanhoudt.	Dit kan worden veroorzaakt door meerdere factoren: VPN-/netwerkconfiguratie (bevestigd met Cato Network VPN die localhost-communicatie blokkeert), interferentie door antivirussoftware of een beschadigd poortbestand bij het openen van een specifiek .tfl-bestand. Opmerking: Tableau Prep Builder mag nooit op een Tableau Server-knooppunt worden geïnstalleerd. Dat is een bekende oorzaak van deze fout.	Installeer het programma opnieuw, controleer AV-uitsluitingen, controleer localhost IPv4/IPv6-communicatie Als het om een VPN-specifiek probleem gaat, test dan met een alternatief VPN om het probleem te isoleren. Vraag het netwerkteam om te controleren op localhost-blokkades Als het probleem optreedt bij een specifiek .tfl-bestand, verzamelt u de Prep-logboekbestanden en IPS-dumps om gecrashte tabminerva-processen te onderzoeken Controleer of Tableau Prep Builder niet op een Tableau Server-knooppunt is geïnstalleerd.	Fout: Tableau Prep is beëindigd omdat een onderliggend proces onverwachts is gestopt bij het starten van Tableau Prep (in het Engels)(Link wordt in een nieuw venster geopend)
'AqlProcessor evaluation failed: Canceled' (AqlProcessor-evaluatie mislukt: Geannuleerd): flow mislukt na een stap voor draaien	Bekend probleem bij het wijzigen van de waarde van een gedraaide kolom na de stap voor draaien.	Opmerking: deze correctie is van toepassing op versie 2022.2 en later. Voer een upgrade uit naar een versie waarop deze correctie van toepassing is. Als tijdelijke oplossing voor oudere versies laat u de waarden van gedraaide kolommen in stappen downstream van het draaipunt ongewijzigd.	Fout: systeemfout - Er treedt een fout op tijdens de communicatie met de databron (LoomDataSource) wanneer de waarde van een gedraaide kolom na de stap voor draaien wordt gewijzigd (in het Engels)(Link wordt in een nieuw venster geopend)
'Unable to publish the data source' (Kan de databron niet publiceren): de flow wordt lokaal of bij uitvoer naar een .hyper-bestand probleemloos uitgevoerd, maar mislukt bij het publiceren naar Tableau Cloud.	De flow mislukt omdat de grootte van het tijdelijke bestand de Tableau Cloud-limieten overschrijdt. Dit komt ook voor wanneer een flow mislukt vanwege geheugengerelateerde SQL-fouten (bijv. grote JOIN-bewerkingen) die alleen in Tableau Cloud en niet lokaal voorkomen.	Schakel de uitvoer over naar een lokaal .hyper-bestand om te bevestigen dat het probleem alleen voorkomt in Cloud. Verlaag de complexiteit van de flow, splits deze op in kleinere flows, verwijder ongebruikte kolommen of gebruik liveverbindingen.	N.v.t.
Prep Builder kan niet worden geopend in Windows. In de foutopsporingslogboeken wordt een fout vermeld die verband houdt met een relatief pad naar een tijdelijke map.	De Windows TEMP-omgevingsvariabele is ingesteld op een relatief pad (bijvoorbeeld `%USERPROFILE%\AppData\Local\Temp`) of bevat een dubbele padvermelding. Voor Tableau Prep Builder is een absoluut pad vereist.	Controleer of de Windows TEMP-omgevingsvariabele is ingesteld op een absoluut pad (bijvoorbeeld `C:\Users[username]\AppData\Local\Temp`) Verwijder eventuele dubbele vermeldingen uit de TEMP-variabele.	N.v.t.

Andere artikelen in deze sectie

Terug naar boven

Bedankt voor uw feedback.

De feedback is verzonden. Dank u wel.

Help voor Tableau Prep