Webbdatakopplingar i Tableau Server

Webbdatakopplingar (WDC:er) är webbsidor med en dataanslutning som kan nås via HTTP för datakällor som inte redan har en koppling i Tableau. Med webbdatakopplingar kan användare ansluta till nästan vilka data som helst som är tillgängliga över webben och skapa extrakt för sina arbetsböcker. Datakällor för en webbdatakoppling kan innefattar interna webbtjänster, JSON-data, REST API:er och andra källor som är tillgängliga över HTTP eller HTTPS. Användare kan skapa sin egen webbdatakoppling eller använda kopplingar som har skapats av andra användare.

Mer information om hur du använder en webbdatakoppling i Tableau Desktop finns i Webbdatakoppling(Länken öppnas i ett nytt fönster) i Tableau Desktop-dokumentationen.

Mer information om hur du skapar en webbdatakoppling finns i dokumentationen om webbdatakoppling (på engelska) i Github.

Innan du kör kopplingar i Tableau Server

Av säkerhetsskäl kör inte Tableau Server webbdatakopplingar om du inte godkänner kopplingen, vilket förklaras ytterligare i det här ämnet.

Obs! Du måste vara en serveradministratör för att kunna godkänna webbdatakopplingar för användning med Tableau Server.

Webbdatakopplingar måste godkännas av dig eftersom de innehåller körbar kod och ofta gör förfrågningar till tredjepartswebbplatser. Innan en användare kan använda en webbdatakoppling med Tableau Server måste du lägga till den domän och port som används av kopplingen i en godkännandelista. Du ska även inkludera de domäner som en koppling kan skicka förfrågningar till och få förfrågningar från i en sekundär godkännandelista. Innan du gör detta rekommenderar vi att du granskar och testar kopplingen, så att du vet vad kopplingen gör och vilka platser den ansluter till. Mer information finns i Testa och granska webbdatakopplingar.

När du lägger till en koppling i en godkännandelista konfigurerar du Tableau Server så att anslutningar tillåts till en viss URL där kopplingen finns och från en URL som kopplingen kan fråga. Det här är det enda sättet att tillåta att Tableau Server kör webbdatakopplingar. Kopplingarna kan sedan hanteras av en server i organisationens brandvägg eller på en extern domän. Det går inte att importera webbdatakopplingar i Tableau Server.

Hantera kopplingar i en godkännandelista

Du lägger till en webbdatakoppling i godkännandelistan med hjälp av kommandot tsm data-access web-data-connectors add. Med hjälp av det här kommandot och de relaterade kommandon som beskrivs nedan kan du utföra följande uppgifter:

  • Lägg till webbdatakopplingar i godkännandelistan och den sekundära godkännandelistan.

  • Tillåt eller avvisa alla webbdatakopplingar eller uppdateringar av webbdatakopplingar.

  • Ta bort en eller flera kopplingar från godkännandelistan.

  • Lägg till alla webbdatakopplingar i godkännandelistan och den sekundära godkännandelistan.

Uppdatering av godkännandelistan över webbdatakopplingar kräver omstart av servern

När du har kört några kommandon som gör ändringar i webbdatakopplingar måste du tillämpa väntande ändringar med hjälp av kommandot tsm pending-changes apply.

Om de väntande ändringarna kräver att servern startas om visar kommandot pending-changes apply en kommandotolk så att du vet att en omstart kommer att ske. Kommandotolken visas även om servern stoppas, men i så fall sker ingen omstart. Du kan utelämna tolken med alternativet --ignore-prompt, men det påverkar inte omstartsbeteendet. Om ändringarna inte kräver omstart används de utan någon kommandotolk. Du hittar mer information i tsm pending-changes apply.

Lägg till kopplingar i godkännandelistan och den sekundära godkännandelistan

Du lägger till en koppling i godkännandelistan och den sekundära godkännandelistan med hjälp av kommandot tsm data-access web-data-connectors add och genom att ange namnet, URL till godkännandelistan samt URL till den sekundära godkännandelistan. Du kan också hantera webbdatakopplingar med hjälp av web-data-connector-settings Entity. När du har kört det här kommandot måste du tillämpa väntande ändringar med hjälp av kommandot tsm pending-changes apply. Du får en varning om att kommandot startar om Tableau Server. Om Tableau Server är igång för tillfället startas det om, och om det har stoppats lämnas det i stoppat läge utan att startas om.

tsm data-access web-data-connectors add --name "USGS Earthquakes" --url https://tableau.github.io:443/webdataconnector/Examples/html/earthquakeUSGS.html --secondary https://tableau.github.io/.*,https://earthquake.usgs.gov/.*,https://maxcdn.bootstrapcdn.com/.*,https://ajax.googleapis.com/.*,https://connectors.tableau.com/.*

 

Anmärkningar om formatering:

  • Se till att använda raka (” och '), och inte typografiska (”), citattecken runt namnet på webbdatakopplingen. Använd dubbla citattecken (”) om namnet innehåller ett blanksteg.
  • För många webbdatakopplingar är den port som anges för alternativet --url 443 eller 80, men du kan kontrollera värdet för kopplingen genom att läsa information om datakällan i Tableau Server. Du måste ange portnumret som en del av URL:en om webbdatakopplingen använder SSL (HTTPS). Till exempel kan URL:en se ut enligt följande om du använder standardporten för HTTPS: https://example.com:443/WDC/.
  • En URL eller kommaavgränsad lista med URL:er måste anges för alternativet --secondary, som anger de domäner som tillhandahåller bibliotek och källor som webbdatakopplingen behöver komma åt. Det här alternativet kan inte utelämnas eller lämnas tomt, utom i de fall webbdatakopplingen inte använder några sekundära domäner. Om du inte vet om webbdatakopplingen använder sekundära domäner, eller vilka de sekundära domänerna är, kan du behöva kontakta dess utvecklare. Du kan också välja att använda webbadresser med jokertecken, http://.* och https://.*, för att tillåta alla domäner. Du bör emellertid använda mer specifika webbadresser för att öka säkerheten.
  • Du lägger till en hel domän i den sekundära godkännandelistan genom att avsluta domänens URL med ett jokertecken. Använd .* som jokertecken för att indikera hela domänen, som i följande exempel: https://example.com/.*.

Tillåta eller avvisa webbdatakopplingar eller extraktuppdateringar av webbdatakopplingar

Du tillåter eller avvisar webbdatakopplingar eller extraktuppdateringar av webbdatakopplingar med hjälp av kommandot tsm data-access web-data-connectors allow med något av alternativen -t eller -r. Som standard tillåts webbdatakopplingar och extraktuppdateringar av webbdatakopplingar. Om du ändrar den här inställningen måste du köra kommandot tsm pending-changes apply. Mer information om kommandot och kommandoalternativen finns i tsm data-access web-data-connectors allow.

Ta bort en eller flera webbdatakopplingar från godkännandelistan

Du tar bort en eller flera webbdatakopplingar från godkännandelistan med hjälp av kommandot tsm data-access web-data-connectors delete. Om du ändrar den här inställningen måste du köra kommandot tsm pending-changes apply. Mer information finns i tsm data-access web-data-connectors delete.

Lägga till alla webbdatakopplingar på godkännandelistan

Du lägger till alla webbdatakopplingar i godkännandelistan med hjälp av kommandot tsm data-access web-data-connectors list. Mer information finns i: tsm data-access web-data-connectors list.

Uppdatera extraktet för en koppling

När en användare skapar en arbetsbok som använder en webbdatakoppling skapar Tableau Server ett extrakt från data som returneras av kopplingen. Om användaren sedan publicerar arbetsboken skickar publiceringsprocessen arbetsboken och dataextraktet till servern.

Tableau kan uppdatera ett extrakt som skapades av en webbdatakoppling precis som det kan uppdatera ett extrakt. Om kopplingen kräver inloggningsuppgifter för inloggning till den webbaserade datakällan måste du säkerställa att inloggningsuppgifterna är inbäddade i datakällan och att webbdatakopplingen är på godkännandelistan för servern. Tableau Server kan inte uppdatera extraktet om kopplingen kräver inloggningsuppgifter och de inte är inbäddade i datakällan. Detta beror på att uppdateringen kan genomföras enligt ett schema eller i bakgrunden samt på att servern inte kan be om inloggningsuppgifter.

För tillfället finns det inget sätt att autentisera en datakälla på nytt direkt från Tableau Server. Om datakällan har inloggningsuppgifter som upphör att gälla eller publicerades utan att bädda in inloggningsuppgifterna måste arbetsboken och dataextraktet publiceras på nytt med de nya inbäddade inloggningsuppgifterna.

Om bakgrundsprocessen som utför uppdateringen misslyckas skapas en varning och en loggpost som beskriver problemet. Användare kan se att tidsstämpeln på extraktet inte ändras.

Du inaktiverar uppdatering för att webbdatakopplingar med hjälp av kommandot tsm data-access web-data-connectors allow -r false.

Felsökning

Om servern stöter på problem med att lägga till kopplingar i godkännandelistan kan du gå igenom loggfilerna. Se till att kontrollera loggfilerna på både den initiala servernoden och de andra noderna som kör gateway-processen. Mer information om loggfiler finns i Tableau-serverloggar och lagringsplatser för loggfiler.

Om problemet är att Tableau Server inte uppdaterar ett extrakt som skapades av en webbdatakoppling ska du säkerställa att konfigurationen webdataconnector.refresh.enabled har ställts in på true. Om den är inställd på false kör du följande kommando för att tillåta extraktuppdateringar för alla webbdatakopplingar på servern:

tsm data-access web-data-connectors allow -r true

Obs! Godkännandelistan är det enda sättet att tillåta att Tableau Server kör webbdatakopplingar. Import av webbdatakopplingar blev inaktuellt från och med version 10.5.

Tack för din feedback!Din feedback har skickats in. Tack!