Felsöka Tableau Prep Builder

Denna artikel listar problem du kan komma att stöta på när du använder Tableau Prep Builder och förslag på hur man löser dem.

När du felsöker problem med ditt flöde, oavsett om du felsöker själv eller kontaktar supporten, måste du i regel samla in loggfilerna och kraschdump-filerna för analys, samt dokumentera de steg som krävs för att återskapa felet. Det bästa sättet att hjälpa utvecklaren eller supportteamet att diagnostisera problemet är att tillhandahålla flödesfilen och de exakta stegen du vidtog innan felet inträffade.

Samla in logg- och kraschdump-filer

Tableau Prep-loggfilerna lagras i mappen Min Tableau Prep-lagringsplats. Standardplatser:

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

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

Du måste samla in alla loggfiler för att problemet ska kunna diagnostiseras. Om du kör Tableau Prep Builder finns allt i mappen ”Min Tableau Prep-lagringsplats” > ”Loggar”. Om du kör Tableau Prep från kommandoraden ska du inkludera loggfilerna från ”Min Tableau Prep-lagringsplats” > ”Kommandoradslagringsplats” > ”Loggar”.

I den här tabellen beskriver vi de olika loggfiler som genereras.

Loggfilens namn	Processen som genererar loggfilen	Beskrivning
app.log	Tableau Prep.exe	Loggfil för användargränssnitt. Filen skapas av JavaScript-koden som körs i Electron-processen.
backendProcessManager.log	Tableau Prep.exe	Filen skapas av JavaScript-koden som startar och övervakar Java-processen.
preprestapi.log	Java.exe	Det här är loggfilen som produceras av Java-koden. Loggposter om REST API-användning, kompilering, cachehantering och start och avstängning av tabminerva-processen (tidigare prepservice) ska finnas här.
log.txt	prepservice.exe tabminerva.exe	Den här loggen skapas av C++-koden. Den här loggfilen inkluderar all interaktion med den Tableau-delade teknikstacken, inklusive anslutningar till databaser, frågor, körning, extern cachelagring, frågepipeline, protokoll och mycket mer.
tdeserver.txt	tdeserver64.exe	Det här är loggfilen som skapades av Tableaus gamla datamotor. Tableau Prep använder fortfarande Tableaus datamotor.
tabprotosrv.txt	tabprotosrv.exe	Protokollserverns logg. Allt där du använder en värdbaserad databasdrivrutin kommer att producera loggrader i den här filen.
hyperd.log	hyperd.exe	Hyper-loggen. Frågor och fel relaterade till frågor finns här.

Aktivera frågeloggning

Från och med Tableau Prep Builder version 2026.2 kan du aktivera inställningen Aktivera frågeloggning i menyn Hjälp > Inställningar och prestanda utan att behöva starta om programmet. När den här inställningen är aktiverad genererar den en XML-frågefil för varje fråga som Tableau Prep Builder kör. Filen kan vara till hjälp när du diagnostiserar problem med flödet. Loggarna genereras och lagras i mappen Fråga.

Hjälpmenyn i Tableau Prep som visar menyalternativet Inställningar och prestanda.

Du hittar de här frågeloggarna i följande kataloger:

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

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

Köra LogShark

LogShark är ett kostnadsfritt kommandoradsverktyg med öppen källkod som kan användas för att extrahera information från Prep-loggfiler för att felsöka och få insikt om fel och användning. LogShark-tillägget Prep.twbx låter dig skapa arbetsböcker med en fel- och flödesinstrumentpanel som hjälper till att analysera och visualisera Prep-problem.

Se Konfigurera datorn för LogShark för information om att installera och köra LogShark.

Skapa kraschdump-filer

Utöver loggfilerna vill du även samla in kraschdump-filer. Allt som inte finns i loggfilerna kan beskrivas här och vara till hjälp vid felsökning av programstart, undantag eller problem med frågor till .hyper.

Det är användbart att skapa kraschdump-filer för följande processer.

Process	Beskrivning
tabminerva.exe (tidigare prepservice.exe)	Det här är den inbyggda processen som är värd för resten av Tableau Prep-logiken. Det är även den process som innehåller den delade inbyggda Tableau-tekniken, inklusive databaskopplingar.
hyperd.exe	Det här är Hyper-databasprocessen. Varje gång en fråga misslyckas. Kraschdump-filer för Hyper kan vara användbara när ett fel inträffar, eftersom mycket av det Tableau Prep gör involverar frågor till Hyper.

Gör följande för att skapa kraschdump-filer, beroende på operativsystem.

Windows

Öppna Aktivitetshanteraren.
Högerklicka på kolumnrubriken och välj Processnamn och Kommandorad. De olika processerna visas och du kan välja den process som du vill använda för att skapa en kraschdump-fil.
Högerklicka på tabminerva.exe-processen (tidigare prepservice.exe).
Välj Skapa dumpfil.
En dialogruta öppnas och visar platsen för kraschdump-filen i ditt system.

MacOS

På MacOS finns det två typer av diagnostikfiler som är användbara för felsökning av Tableau Prep:

Kraschrapport – registrerar anropsstacken vid tidpunkten för kraschen, ungefär som en stackspårning.
Kärnfil – en fullständig ögonblicksbild av processens minne vid tidpunkten för avslutandet.

Båda kräver att Tableau Prep-processen avslutas. Du måste starta om Tableau Prep när du har samlat in de här filerna.

Förutsättning: Administratörsåtkomst krävs för kärnfilinsamling.

Steg 1: Skapa en kraschrapport

Öppna Terminal.
Kör kommandot: pgrep tabminerva | xargs kill -SEGV
Detta avslutar tabminerva.exe-processen genom att skicka en signal om segmenteringsfel, vilket gör att MacOS genererar en kraschrapport automatiskt.
Kraschrapporten sparas i: ~/Library/Logs/DiagnosticReports/
Filnamnet har formatet tabminerva_ÅÅÅÅ-MM-DD-HHMMSS_datornamn.crash eller tabminerva_ÅÅÅÅ-MM-DD-HHMMSS_datornamn.ips.

När du skickar den här filen till Tableau Support eller utvecklingsteamet måste du vara noga med att ange att du avsiktligt skickade en signal om segmenteringsfel för att generera rapporten. Det skiljer den från en äkta krasch.

Steg 2: Skapa en kärnfil

Använd ett av följande alternativ för att skapa en kärnfil.

Skapa en kärnfil och avsluta Tableau Prep-sessionen

Öppna Terminal.
Kör kommandot sudo chmod 1777 /cores för att bevilja skrivbehörighet till kärnfilskatalogen.
Kör kommandot ulimit -c unlimited för att ta bort gränsen för kärnfilens storlek för den aktuella terminalsessionen.
Kör kommandot pgrep tabminerva | xargs kill -SEGV för att avsluta processen och generera kärnfilen.
Kärnfilen sparas i /cores/, med namnet core.<process_id>.

Skapa en kärnfil och håll igång Tableau Prep

Det här alternativet använder ett gcore-verktyg för att samla in en kärndump av en pågående process utan att avsluta den. Den här processen kräver att kommandoradsverktyget Xcode är installerat. Öppna Terminal och kör Bash xcode-select --install för att kontrollera om du har det här alternativet installerat.

Öppna Terminal.
Kör kommandot: sudo gcore -o /tmp/tabminerva.core $(pgrep tabminerva)
Kärnfilen sparas i /tmp/tabminerva.core. Tableau Prep fortsätter att köras normalt.

Vanliga fel när kommandoraden används för att köra flöden

Du kan köra flöden från kommandoraden för att uppdatera dina utdatafiler i stället för att öppna Tableau Prep Builder för att köra varje flöde manuellt. Även om denna process hjälper till att bygga effektivitet i din flödesprocess kommer du att få fel när du kör denna process om din syntax är felaktig eller om du saknar inloggningsuppgifter för dina anslutningar eller utmatningsplatser.

En lista över alla kommandoradsalternativ som stöds i Tableau Prep finns i Kommandoradsreferens för Tableau Prep(Länken öppnas i ett nytt fönster).

Följande tabell beskriver vanliga fel och hur man löser dem. Information om hur man kör flöden från kommandoraden finns i Uppdatera flödesutdatafiler från kommandoraden(Länken öppnas i ett nytt fönster).

Fel	Orsak	Så här fixar du det
”Argument saknas”	Ett av de erforderliga kommandoradsargumenten saknas.	Använd ”tableau-prep-cli -help” för att se en lista över argumenten för kommandoraden.
”Det går inte att läsa anslutningsfilen.”	Det finns fel i syntaxen eller formatet i credentials.json-filen för indataanslutningarna.	Kontrollera syntaxen för indataanslutningarna i .json-filen. Mer information och exempel finns i Uppdatera flödesutdatafiler från kommandoraden(Länken öppnas i ett nytt fönster).
”Det finns fel i flödet. Flödet kunde inte köras. Kontrollera att .json-filen för inloggningsuppgifter innehåller alla erforderliga inloggningsuppgifter. Öppna flödet i Tableau Prep Builder för att visa felinformation.”	Inloggningsuppgifter saknas i filen credentials.json för indataanslutningarna eller så innehåller flödet fel.	Kontrollera att .json-filen har behörighet för alla anslutningar och öppna sedan flödesfilen i Tableau Prep Builder för att se om det finns några fel i flödet. Om flödet har fel måste du åtgärda dem och publicera flödet på nytt i Tableau Server, och försök sedan köra processen igen.
”Kunde inte hitta matchning för<hostname of inputConnections >”	Filen credentials.json saknar en post för värdnamnet (servernamn).	Se till att filen credentials.json innehåller korrekta inloggningsuppgifter för värdnamnet (servernamn). Mer information och exempel finns i Uppdatera flödesutdatafiler från kommandoraden(Länken öppnas i ett nytt fönster).
”Vi har inte inloggningsuppgifter för alla anslutningar i tfl/tflx-filen. Följande anslutning(ar) hittades inte: <hostname of inputConnections>”	Filen credentials.json saknas eller har felaktiga inloggningsuppgifter för värdnamnet (servernamnet) som visas i felmeddelandet.	Se till att credentials.json-filen innehåller korrekta inloggningsuppgifter för värdnamnet (servernamnet) som anges i felmeddelandet. Mer information och exempel finns i Uppdatera flödesutdatafiler från kommandoraden.
”Fel vid inloggning i server <serverUrl> som användare <userName>. Vänligen kontrollera inloggningsuppgifterna.”	Filen credentials.json har felaktiga inloggningsuppgifter för Tableau Server.	Kontrollera att filen credentials.json innehåller alla korrekta inloggningsuppgifter och element för utdataanslutningen. Mer information och exempel finns i Uppdatera flödesutdatafiler från kommandoraden.
”Det gick inte att logga in <userName> på servern <serverUrl>(<contentUrl>)”	Filen credentials.json har felaktiga inloggningsuppgifter för Tableau Server.	Kontrollera att filen credentials.json innehåller alla korrekta inloggningsuppgifter och element för utdataanslutningen. Mer information och exempel finns i Uppdatera flödesutdatafiler från kommandoraden.
”Vi har inga inloggningsuppgifter för Tableau Server för att publicera extrakt för en eller flera utmatningsnoder i tfl/tflx-filen.”	Filen credentials.json skickades inte in som ett kommandoradsargument, eller också saknar den inloggningsuppgifter för utmatningsanslutningen.	Se till att sökvägen till credentials.json-filen ingår i kommandoraden och kontrollera att credentials.json-filen innehåller alla korrekta inloggningsuppgifter och element för utdataanslutningen. Mer information och exempel finns i Uppdatera flödesutdatafiler från kommandoraden.
”Loom rest API-server startades inte”	Installationen eller miljöinställningen är felaktig.	Se till att Tableau Prep Builder har installerats korrekt och att du kör kommandot som administratör. För information om hur du installerar Tableau Prep Builder, se Installera Tableau Desktop eller Tableau Prep Builder från användargränssnittet(Länken öppnas i ett nytt fönster).
”Fel. Filen finns inte.”	Sökvägen till flödesfilen är felaktig.	Kontrollera att rätt sökväg till flödesfilen finns med på kommandoraden.
”Fel. Anslutningsfilen finns inte.”	Sökvägen till filen credentials.json är felaktig.	Se till att rätt sökväg till credentials.json-filen ingår i kommandoraden.
”Kunde inte hitta matchning för <mapr01:5181>,<mapr02:5181>,<mapr03:5181>”	Du måste ange ett specifikt port-ID när du ansluter till Apache Drill med ZooKeeper.	Inkludera en credentials.json-fil i kommandoraden som anger ”port”: 31010 för inmatningsuppgifterna.

Vanliga Tableau Prep-fel

I följande tabell beskriver vi några vanliga fel som du kan stöta på när du använder Tableau Prep och lösningar att prova.

Fel	Orsak	Så här fixar du det	Kunskapsartikel
Det går inte att ansluta till Tableau Server. Kontrollera att servern är igång och att URL:en är korrekt. `tableauErrorCode=0xD5A9A6F9; tableauStatusCode=UNAUTHENTICATED; exceptionName=VizportalAuthenticationException`	En proxy eller brandvägg blockerar den inbäddade webbläsaren i Tableau Prep Builder från att slutföra handskakningen för Tableau Cloud-inloggning.	Samarbeta med IT-avdelningen för att godkännandelista Tableau Cloud-URL:er via proxyn. Logga ut från Tableau Prep Builder och in igen. Om det finns ett automatiskt proxykonfigurationsskript ska du kontrollera att det hanterar autentiseringen utan att fråga efter inloggningsuppgifter.	Det går inte att logga in i Tableau Online från Tableau Prep Builder i en proxymiljö som kräver autentisering(Länken öppnas i ett nytt fönster)
Det SSL-certifikat som krävs kanske saknas eller stämmer inte överens med Tableau Server-certifikatet för [serverhostname]. Visas även som ”Det går inte att hitta den begärda certifikatsökvägen för flödes-ID” när flöden körs på servern.	SSL-certifikatkedjefil saknas i Tableau Server eller så är kedjefilen inte installerad på datorn som kör Tableau Prep Builder. I vissa fall orsakas problemet av att en AWS-belastningsutjämnare använder en inkompatibel TLS-policy.	Kontrollera att SSL-certifikatkedjefilen är uppladdad i Tableau Server. Installera certifikatet på datorn som kör Prep Builder (om ”Filen är ogiltig för användning som följande: säkerhetscertifikat” returneras när du dubbelklickar och väljer ”Installera certifikat”, kan själva certifikatfilen vara felaktig). Samarbeta med IT-avdelningen för att exportera en giltig kedjefil. Om det är du som använder en AWS-belastningsutjämnare ska du nedgradera policyn till ELBSecurityPolicy-TLS-1-2-2017-01.	Fel – det SSL-certifikat som krävs kanske saknas eller stämmer inte överens med Tableau Server-certifikatet – inloggning från Tableau Prep(Länken öppnas i ett nytt fönster)
Tableau Prep Builder avslutades på grund av att en underliggande process oväntat avbröts. Om problemet kvarstår kan du testa att installera om produkten.	Det här felet kan utlösas av flera faktorer: VPN/nätverkskonfiguration (bekräftas med Cato Network VPN som blockerar localhost-kommunikation), antivirusstörningar eller en skadad portfil när en specifik .tfl-fil öppnas. Obs! Tableau Prep Builder ska aldrig installeras på en Tableau Server-nod. Det är en känd orsak till det här felet.	Installera om, kontrollera AV-undantag och verifiera localhost IPv4/IPv6-kommunikation. Om felet är VPN-specifikt kan du testa med en alternativ VPN för att isolera. Ta hjälp av nätverksteamet för att söka efter localhost-blockeringar. Om felet är knutet till en specifik .tfl-fil ska du samla in Prep-loggar och IPS-dumpar för att undersöka tabminerva-processkrascher. Kontrollera att Tableau Prep Builder inte är installerat på någon Tableau Server-nod.	Fel: Tableau Prep avslutades på grund av att en underliggande process oväntat avbröts när Tableau Prep startades(Länken öppnas i ett nytt fönster)
AqlProcessor-utvärdering misslyckades: avbruten – flödet misslyckas efter ett pivotsteg	Ett känt problem uppstod när värdet i en pivoterad kolumn ändrades efter pivotsteget.	Obs! Den här lösningen gäller för versionen 2022.2 och senare. Uppgradera till en version som omfattas av lösningen. Som en tillfällig lösning för äldre versioner kan du undvika att ändra pivoterade kolumnvärden i steg nedströms från pivoten.	Fel: systemfel – ett fel uppstod vid kommunikation med datakällan (LoomDataSource) eftersom värdet i en pivoterad kolumn ändrats efter pivotsteget(Länken öppnas i ett nytt fönster)
Det går inte att publicera datakällan – flödet körs lokalt eller vid utmatning till en .hyper-fil, men misslyckas vid publicering till Tableau Cloud.	Flödet misslyckas på grund av att temp-filens storlek överskrider Tableau Cloud-gränserna. Felet visas även när ett flöde misslyckas med minnesrelaterade SQL-fel (t.ex. stora JOIN-åtgärder) som bara dyker upp i Tableau Cloud, inte lokalt.	Växla utdata till en lokal .hyper-fil för att bekräfta att problemet är Cloud-specifikt. Minska flödets komplexitet, dela upp det i mindre flöden, ta bort oanvända kolumner eller använd liveanslutningar.	Ej tillämpligt
Prep Builder kan inte öppnas i Windows. Felsökningsloggar visar ett fel som är relaterat till en relativ sökväg för temp-mappen.	Windows TEMP-miljövariabeln är inställd på en relativ sökväg (t.ex. `%USERPROFILE%\AppData\Local\Temp`) eller innehåller en duplicerad sökvägspost. Tableau Prep Builder kräver en absolut sökväg.	Kontrollera att Windows TEMP-miljövariabeln är inställd på en absolut sökväg (t.ex. `C:\Users[username]\AppData\Local\Temp`). Ta bort alla dubblettposter från TEMP-variabeln.	Ej tillämpligt

Andra artiklar i det här avsnittet

Tillbaka till toppen

Tack för din feedback!

Din feedback har skickats in. Tack!

Tableau Prep-hjälp