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.
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.
LogShark vereist dat de Prep-logboekbestanden die u verwerkt, gecomprimeerde (gezipte) bestanden zijn. Om de Prep-logboekbestanden te vinden, navigeert u naar de map Mijn Tableau Prep-opslagplaats. De locatie is /Users/<username>/Documents/My Tableau Prep Repository.
Zie Uw computer instellen voor LogShark (in het Engels) voor informatie over het installeren en uitvoeren van LogShark.
Veelvoorkomende fouten bij gebruik van de opdrachtregel om flows uit te voeren
U kunt flows vanaf de opdrachtregel uitvoeren om uw uitvoerbestanden programmatisch 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.
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. |
Fout: 'Er zijn functies gevonden waardoor dit bestand niet kan worden gebruikt door deze versie van de applicatie'
Als u een flow die in versie 2018.2.1 of later is gemaakt, opent in een eerdere versie van Tableau Prep Builder, ziet u mogelijk de volgende foutmelding:
Flows met functies die niet in eerdere releases worden ondersteund, resulteren in deze incompatibiliteitsfout. U kunt de fout oplossen door de flow in de latere versie te openen en een kopie van de flow zonder de aangegeven functies op te slaan. Verwijder in het bovenstaande voorbeeld het null-filter uit het veld waar het is toegepast.
Open vervolgens de kopie zonder de functie in de eerdere versie van Tableau Prep Builder.
Fout: 'U gebruikt serverversie: null...' bij het aanmelden bij een SSL-compatibele Tableau Server vanuit Tableau Prep
Wanneer u zich vanuit Tableau Prep Builder aanmeldt bij een SSL-compatibele Tableau Server, moet een rootcertificaat zijn geïnstalleerd op de computer waarop Tableau Prep Builder is geïnstalleerd. Als het certificaat niet is geïnstalleerd, ziet u mogelijk de volgende foutmelding:
U gebruikt serverversie null maar de minimaal compatibele versie is 10.0. Voer een upgrade uit naar een compatibele versie
Als u deze fout ziet, neem dan contact op met uw IT-afdeling of systeembeheerder om het vereiste rootcertificaat te installeren op de computer waarop Tableau Prep Builder is geïnstalleerd. Zie Systeemvereisten(Link wordt in een nieuw venster geopend) (in het Engels) in de Implementatiegids voor Tableau Desktop en Tableau Prep Builder voor meer informatie.