Data Connect implementeren

Is van toepassing op: Tableau Cloud

Voordat u Data Connect in uw organisatie implementeert, moet u controleren of u aan de vereisten voldoet:

  • De persoon die of het team dat verantwoordelijk is voor de implementatie van Data Connect moet ervaring hebben met het Linux-besturingssysteem, shell-scripting, Docker en Kubernetes.

  • Minimale hardwarevereisten zoals gespecificeerd in Uw Data Connect-implementatie plannen.

  • Netwerkspecificatie en databasetoegang zoals gespecificeerd in Uw Data Connect-implementatie plannen.

Stap 1: Uw cluster instellen

Controleer de volgende connectiviteit en toegang:

  • Voor de infrastructuur, het cluster en de container van 'Data verbinden' zijn netwerktoegang tot de services van de indelingsprovider (nr. 2 in de afbeelding hierboven) en tot Tableau Cloud vereist (alleen uitgaand, nr. 5).

  • Voor de infrastructuur, het cluster, de container en de agent van 'Data verbinden' is netwerktoegang tot uw database vereist (nr. 6).

Zie Netwerkspecificaties.

Implementeren en configureren

Voer de volgende procedure uit op elke computer in uw organisatie waarop u het Kubernetes-cluster wilt uitvoeren.

  1. Verifieer dat secundaire volume niet is geformatteerd. Voer op het Linux-knooppunt de volgende opdracht uit:

    lsblk -f

    De volgende afbeelding toont een voorbeeld waarbij het extra volume nvme1n1 op een clusterknooppunt niet-geformatteerd is en FSTYPE leeg is:

  2. Klik op het tabblad Data Connect onder Pools op Nieuwe pool. Voer een naam in voor de pool in het dialoogvenster Nieuwe pool en klik daarna op Maken.

  3. Ga naar Cluster en knooppunten op het tabblad Data Connect en klik op Nieuw cluster. Voer een naam in voor het cluster in het venster Nieuw cluster en klik op daarna op Maken.

  4. Klik op het cluster dat u zojuist hebt gemaakt op de kolom Acties en klik vervolgens op Nieuw knooppunt. Klik in het venster Nieuw knooppunt toevoegen op Bestand downloaden.

    Een bestand cluster.tar wordt gedownload naar uw map Downloads. Dit bestand bevat de bootstrap-scripts die u op het knooppunt gaat uitvoeren.

  5. Kopieer het bestand cluster.tar naar uw computer. Het volgende voorbeeld laat zien hoe u het tar-bestand kopieert, de bestanden uitpakt, het script omzet in een uitvoerbaar bestand en het script vervolgens uitvoert. Het voorbeeld laat dit zien in de context van AWS. Wijzig de bestandspaden voor uw omgeving.

    Voer de volgende opdrachten als root of sudo-gebruiker uit, waarbij u <key-name> en <IP-address> door uw eigen waarden vervangt:

    > scp -i <key-name>.pem /Downloads/cluster.tar ec2-user@ip-<IP-address>.us-west-2compute.internal:~/

    > ssh -i <key-name>.pem ex2-user@ip-<IP-address>.us-west-2compute.internal

    > tar -xvf cluster.tar

    > chmod +x onboard_node.sh preflight_check.sh

    > ./onboard_node.sh

    Opmerking: bzip2 wordt standaard niet met Ubuntu geïnstalleerd. Als u dit wilt installeren, moet u het volgende uitvoeren: apt install bzip2 -y.

    Nadat het script is uitgevoerd, ziet u Successfully performed all operations in het terminalvenster, waarna het Tableau-team begint met het inrichtingsproces.

    Als u een fout tegenkomt, controleer dan of uw implementatie voldoet aan de minimale hardwarevereisten en netwerkspecificaties die worden beschreven in Uw Data Connect-implementatie plannen.

  6. Op het tabblad Data Connect voor uw site staat de pool die u in stap 2 hebt gemaakt. Klik onder de kolom Acties op Cluster toewijzen en selecteer vervolgens het cluster dat u in stap 3 hebt gemaakt.

  7. Klik op de chevron (⌄) van het cluster om de hostnaam en beschikbare acties te bekijken. Als deze informatie niet wordt weergegeven, moet u de pagina mogelijk opnieuw laden. Nadat u hebt bevestigd dat de hostnaam het doelknooppunt is, klikt u op Knooppunt accepteren en vervolgens op Bevestigen.

    Het clusterknooppunt krijgt vervolgens de inrichtingsstatus. De inrichting van het knooppunt kan een uur of langer duren.

  8. Wanneer de status op uw knooppunt verandert in Beschikbaar, navigeert u naar de pool waaraan u het cluster hebt toegewezen en klikt u op de actieknop (...). Klik vervolgens op Tokens vernieuwen. Controleer of de tokens voor de juiste pool worden vernieuwd, en klik vervolgens op Bevestigen.

  9. Wacht tot de tokens zijn vernieuwd. Zodra dit is voltooid, wordt de poolstatus ingesteld op Beschikbaar. Navigeer terug naar het cluster en klik op de chevron (⌄) om het gedeelte met de clusternaam samen te vouwen. Klik op de actieknop voor het cluster (...) en klik vervolgens op Informatie over container-register ophalen.

    • Als u bij deze stap een foutmelding krijgt, is het register nog niet geïmplementeerd en moet het inrichtingsproces mogelijk nog worden afgerond. Wacht een paar minuten en probeer het opnieuw.
    • Wanneer de registergegevens (servernaam, gebruikersnaam en wachtwoord) worden weergegeven, kopieert u deze voor de volgende stap.

Stap 2: De basis-image maken en publiceren

In deze stap bouwt u een basis-image met de benodigde stuurprogramma's, waarna u de image naar uw Docker-containerregister publiceert. Voordat u begint:

  • Ga na of u over de data van het Docker-containerregister uit de vorige stap beschikt.

  • Elke pool kan zijn eigen unieke basis-image en set met stuurprogramma's hebben.

  • Als u van plan bent om verbinding te maken met behulp van een TDC-bestand, moet u dit bestand opnemen in uw basis-image. De systeemgebruiker, tableau, moet leesrechten hebben voor dit bestand. Zie het Help-onderwerp van Tableau Desktop, Een verbinding aanpassen en afstemmen(Link wordt in een nieuw venster geopend) voor meer informatie over het maken en opslaan van dit bestand.

De container bouwen

De volgende procedure toont een voorbeeld van hoe een container wordt gebouwd. Mogelijk moet u pakketbeheertools of andere hulpprogramma's installeren die specifiek zijn voor uw implementatie. Houd er rekening mee dat de docker-image die u bouwt, afkomstig moet zijn van Red Hat, omdat het Tableau Bridge-installatieprogramma een Red Hat-installatieprogramma is (*.rpm-bestand).

  1. Log in op een willekeurig knooppunt in het Data Connect-cluster. Kopieer het bestand cluster.tar naar uw computer. Het volgende voorbeeld laat zien hoe u het tar-bestand kopieert, de bestanden uitpakt, het script omzet in een uitvoerbaar bestand en het script vervolgens uitvoert. Het voorbeeld laat dit zien in de context van AWS. Wijzig de bestandspaden voor uw omgeving.

    Voer de volgende opdrachten als root of sudo-gebruiker uit, waarbij u <key-name> en <IP-address> door uw eigen waarden vervangt:

    scp -i <key-name>.pem /Downloads/cluster.tar ec2-user@ip-<IP-address>.us-west-2compute.internal:~/
ssh -i <key-name>.pem ec2-user@ip-<IP-address>.us-west-2compute.internal
tar -xvf clustertar.tar
chmod +x onboard_node.sh preflight_check.sh
./onboard_node.sh

  2. Installeer Docker en de benodigde ondersteunende tools:

    #RedHat
sudo dnf install -y container-tools podman-docker
#Ubuntu
sudo apt-get update -y
sudo apt-get install -y docker.io

  3. Maak het Docker-bestand:

    touch Dockerfile

  4. Werk het Docker-bestand bij met de stuurprogramma's die uw verbindingen ondersteunen. De opdrachten die in dit Docker-bestand zijn opgegeven, worden uitgevoerd tijdens de buildtijd voor uw basis-image. Bijvoorbeeld:

    # example base 
FROM registry.access.redhat.com/ubi8
RUN yum -y update
WORKDIR /
# Go to https://tableau.com/support/drivers
# Follow the instructions to install your drivers for linux
CMD [“/bin/bash”]

    De doelmap voor stuurprogrammabestanden varieert. Zie Tableau-stuurprogramma downloaden(Link wordt in een nieuw venster geopend) voor meer informatie.

    Opmerking: Data Connect ondersteunt Exchange-connectors die een Linux-stuurprogramma hebben en die zijn aangemerkt als "Works with Tableau Cloud via Bridge.” Raadpleeg Tableau Exchange-connectors(Link wordt in een nieuw venster geopend) voor meer informatie.

    Voorbeeld van Dockerfile-code voor een openbaar JDBC-stuurprogramma, waarbij de curl-opdracht wordt gebruikt om het stuurprogramma te downloaden:

    RUN mkdir -p /opt/tableau/tableau_driver/jdbc
RUN curl --location --output /opt/tableau/tableau_driver/jdbc/<file> <URL>

    Voorbeeld van Dockerfile-code voor een niet-openbaar JDBC-stuurprogramma, met behulp van kopiëren:

    RUN mkdir -p /opt/tableau/tableau_driver/jdbc
COPY  <file> /opt/tableau/tableau_driver/jdbc

    Voorbeeld van Dockerfile-code voor een taco-stuurprogramma, met behulp van kopiëren:

    RUN mkdir -p /home/tableau/Documents/My_Tableau_Bridge_Repository/Connectors
COPY  <file> /home/tableau/Documents/My_Tableau_Bridge_Repository/Connectors

  5. Terwijl u nog steeds bent ingelogd op uw Kubernetes-clusterknooppunt, stelt u de variabele POOL_ID in met de waarde van uw bridgepool-id. Om de pool-id-waarde weer te geven, opent u het Data Connect-tabblad, en klikt u op de naam van de pool.

    • Stel de registerwaarde die u hebt gekopieerd in op de betreffende waarden.

      REGISTRY_HOSTNAME=registry_host_name_you_copied
REGISTRY_USERNAME=registry_user_name_you_copied
REGISTRY_PASSWORD=registry_password_you_copied

    • Stel de pool-ID-waarde in:

      POOL_ID=<pool_id_value>

  6. Maak de container, die als uw basis-image wordt gebruikt.

    docker build -f <path_to_dockerfile> -t $REGISTRY_HOSTNAME/bridge-base:$POOL_ID .

  7. Meld u aan bij uw bestaande Kubernetes-knooppunt en push de image naar het lokale containerregister.

    docker login --username $REGISTRY_USERNAME $REGISTRY_HOSTNAME
docker push $REGISTRY_HOSTNAME/bridge-base:$POOL_ID

  8. Klik onder de pool die u configureert op de actieknop (...) en klik op Basisimage vernieuwen. Hierdoor wordt er een implementatie van de basis-image gestart. Dit duurt maximaal 10 minuten.

    Opmerking: telkens wanneer er een nieuwe basis-image wordt gemaakt en vernieuwd, wordt er een nieuwe implementatie gemaakt. De Bridge-agent die voor de vorige basis-image is gebruikt, blijft als niet-toegewezen asset bestaan. Let op dat u niet-toegewezen Bridge-agents niet verwijderd.

Stap 3: Een domein toewijzen aan een pool

De domeinnamen die u in de toelatingslijst opgeeft, zijn de servernamen die worden gebruikt voor de databronverbinding.

  1. Selecteer op het tabblad Data Connect onder het gedeelte Pool en de toelatingslijst voor privénetwerken de pool die u hebt toegewezen en klik op Nieuw domein in de kolom Acties.

  2. Voer in het tekstvak Domein de URI van het domein in met behulp van de informatie die wordt beschreven in Regels voor toelatingslijstregister. De domein-URI die u opgeeft, is alleen van toepassing op de pool die u configureert.

  3. Bevestig dat onder Domeinmachtigingen het keuzerondje Toestaan is geselecteerd.

  4. Wanneer u klaar bent, klikt u op Opslaan.

Problemen met verbindingen oplossen

U dient uw netwerkinfrastructuur zo te configureren dat Data Connect alle vereiste databronnen kan bereiken waarmee u verbinding wilt maken. Voer de volgende curl-opdracht uit vanaf de knooppunten waarop Data Connect wordt uitgevoerd om te controleren of Data Connect uw databronnen kan bereiken:

$ curl -v $DB_HOSTNAME:$DB_PORT

Als u de verbinding goed hebt ingesteld, ziet u een verzameling reacties. Hier ziet u enkele voorbeelden:

  • Host $DB_HOSTNAME:$DB_PORT was resolved: bevestigt dat de DNS-servers de hostnaam zonder problemen hebben opgelost.

  • Connected to $DB_HOSTNAME: bevestigt dat het knooppunt een netwerkverbinding heeft.

  • Empty reply from server. Closing connection: dit is te verwachten aangezien curl geen databaseclient is.

  • Could not resolve host: $DB_HOSTNAME: er is een probleem met de DNS-resolutie.

  • Trying $DB_IP_ADDRESS:$DB_PORT: er is sprake van een netwerkprobleem als het proces na dit bericht vastloopt.

Als u een externe partij gebruikt voor de infrastructuur van Data Connect, moet u ervoor zorgen dat de netwerklogica niet door de externe partij wordt verstoord.

(Optioneel) Stap 4: Clusters delen tussen sites

Standaard worden Data Connect-clusters en de bijbehorende knooppunten alleen gebruikt door de site waar ze oorspronkelijk zijn gemaakt. Maar Data Connect-clusters kunnen worden gedeeld met alle sites binnen uw Tableau Cloud Manager-tenant. Door clusters te delen, kunnen query's op verschillende sites binnen de tenant dezelfde knooppuntinfrastructuur gebruiken.

Om de privacy van data op de sites te waarborgen, zijn er geen data over uw gedeelde cluster beschikbaar voor andere sites op uw tenant.

Opmerking: het delen van een cluster is een permanente bewerking. Als u een cluster niet meer wilt delen, moet u het cluster verwijderen en opnieuw installeren.

Clusters kunnen alleen worden gedeeld nadat ze zijn geaccepteerd op de oorspronkelijke site waar ze zijn gemaakt.

Een Data Connect-cluster delen:

  • Navigeer naar het cluster dat u wilt delen en klik op de actiepuntjes (...) en klik vervolgens op Delen.

Nadat u het cluster hebt gedeeld, kunnen sitebeheerders op andere sites binnen uw tenant het cluster gebruiken met alle pools die zij op hun site maken.

(Optioneel) Stap 5: Een pool op een gedeeld cluster maken als clusterontvanger

Voordat u uw pool als ontvanger op een gedeeld cluster maakt, moet u het volgende controleren:

  • Het gedeelde cluster heeft netwerkconnectiviteit met de databases die door uw site worden gebruikt

  • Alle databasestuurprogramma's die nodig zijn voor de database op uw site, moeten op het cluster worden geïnstalleerd

Om een gedeeld cluster als clusterontvanger te kunnen gebruiken, moet u contact opnemen met de clustereigenaar om de basis-image van uw pool aan het cluster toe te voegen:

  1. Klik op het tabblad Data Connect onder Pools op Nieuwe pool.

  2. Voer een naam in voor de pool in het dialoogvenster Nieuwe pool en klik daarna op Maken.

  3. Klik in de nieuwe pool op Cluster toewijzen, selecteer het gedeelde cluster, klik op de actiepuntjes (...) en klik vervolgens op Tokens vernieuwen.

  4. Controleer of de tokens voor de juiste pool worden vernieuwd, en klik vervolgens op Bevestigen.

  5. Wanneer de poolstatus op Beschikbaar staat, kopieert u de Pool_ID van uw pool. Om de Pool_ID-waarde weer te geven, klikt u op de poolnaam.

  6. Voeg een basis-image voor uw site toe. Stap 2: De basis-image maken en publiceren.

    De beheerder met toegang tot het cluster moet een nieuwe container maken met de Pool_ID-waarde als onderdeel van het toevoegen van de basis-image. U hebt ook de registerwaarden nodig op de site waar het cluster oorspronkelijk is gemaakt. Deze kunt u krijgen van de eigenaar van het cluster.

  7. Nadat de basis-image is gepubliceerd in het lokale containerregister, navigeert u naar de pool op de sharesite en klikt u vervolgens op Basis-image vernieuwen.

  8. Zie Stap 3: Een domein toewijzen aan een pool hierboven om de configuratie te voltooien.

Een knooppunt toevoegen vanuit een bestaand cluster

  1. Navigeer naar het cluster en klik op Nieuw knooppunt.

  2. Volg stap 4, 5, 7, 8, 9 in de bovenstaande procedure, Stap 1: Uw cluster instellen. Sla stap 6 over omdat u het cluster niet hoeft toe te wijzen.

  3. Nadat de stap voor het vernieuwen van het token is voltooid, gaat u naar de pool die aan het cluster is gekoppeld en klikt u op Basis-image vernieuwen.

Opmerking: wanneer er een nieuwe basis-image wordt gemaakt en vernieuwd, wordt er een nieuwe implementatie gemaakt. De Bridge-client die voor de vorige basis-image is gebruikt, blijft als niet-toegewezen asset bestaan. Let op dat u niet-toegewezen Bridge-clients niet verwijderd.

Een knooppunt uit een bestaand cluster verwijderen

Nadat een knooppunt uit een cluster is verwijderd, is de Bridge-client niet langer toegankelijk voor Tableau Cloud. Alle taken die op Data Connect worden uitgevoerd op het moment dat het knooppunt wordt verwijderd, mislukken. Er worden echter geen extra taken naar deze Bridge-clients doorgestuurd.

Om een knooppunt te verwijderen, navigeert u naar het cluster en klikt u op de actiepuntjes (...) en selecteert u Verwijderen.

Basis-images voor bestaande pools bijwerken

Als u besluit een nieuwe database te gebruiken of een stuurprogramma bij te werken die uw Data Connect-cluster gaat gebruiken, kunt u wijzigingen aanbrengen in bestaande basis-images om deze wijzigingen door te voeren. Om dit te doen, moet u het containerbestand bijwerken met de wijzigingen zoals uitgelegd in Stap 2: De basis-image maken en publiceren. Nadat u het containerbestand hebt bijgewerkt, klikt u op Basis-image vernieuwen. Het implementeren van de nieuwe basis-imager kan tot 15 minuten duren. Uw vorige basis-image wordt gebruikt tot de nieuwe basis-image is geïmplementeerd.

Problemen met de databaseconnectiviteit oplossen

Controleer eerst of uw domeinen voldoen aan de regels voor het toelatingslijstregister. Zie Pooling-activiteiten configureren.

Controleer vervolgens of u uw netwerkinfrastructuur zodanig hebt geconfigureerd dat Data Connect alle vereiste databronnen kan bereiken waarmee u verbinding wilt maken. Voer de volgende curl-opdracht uit vanaf de knooppunten waarop Data Connect wordt uitgevoerd om te controleren of Data Connect uw databronnen kan bereiken:

$ curl -v $DB_HOSTNAME:$DB_PORT

Als u de verbinding goed hebt ingesteld, ziet u een verzameling reacties. Hier ziet u enkele voorbeelden:

  • Host $DB_HOSTNAME:$DB_PORT was resolved: bevestigt dat de DNS-servers de hostnaam zonder problemen hebben opgelost.

  • Connected to $DB_HOSTNAME: bevestigt dat het knooppunt een netwerkverbinding heeft.

  • Empty reply from server. Closing connection: dit is te verwachten aangezien curl geen databaseclient is.

  • Could not resolve host: $DB_HOSTNAME: er is een probleem met de DNS-resolutie.

  • Trying $DB_IP_ADDRESS:$DB_PORT: er is sprake van een netwerkprobleem als het proces na dit bericht vastloopt.

Als u een externe partij gebruikt voor de infrastructuur van Data Connect, moet u ervoor zorgen dat de netwerklogica niet door de externe partij wordt verstoord.

Terug naar boven
Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.