SAP HANA

In dit artikel wordt beschreven hoe u Tableau verbindt met een SAP HANA-database en de databron instelt.

Opmerking: deze connector maakt gebruik van JDBC-stuurprogramma's voor Mac, Linux en Windows. Het JDBC-stuurprogramma voor Windows is nieuw in Tableau-versie 2021.1. JDBC-stuurprogrammaversie 2.3.4 is de aanbevolen versie.

Voordat u begint

Verzamel de volgende verbindingsinformatie voordat u begint:

  • Maakt u verbinding met één of meerdere knooppunten?
    • SingleNode: naam en poortnummer van de databaseserver.
    • MultiNode: naam van de databaseserver, hostnaam en poortnummers.
  • Verificatie:
    • Windows-verificatie (alleen Windows)
    • Kerberos (alleen Mac)
    • Gebruikersnaam en wachtwoord
    • OAuth 2.0-/ OIDC. Zie Externe OAuth voor SAP HANA voor meer informatie over hoe u dit kunt configureren.
  • Maakt u verbinding met een SSL-server?
  • (Optioneel) Initiële SQL-statement die elke keer wordt uitgevoerd wanneer Tableau verbinding maakt

Stuurprogramma vereist

Voor deze connectors is een stuurprogramma vereist om met de database te communiceren. Als het stuurprogramma niet op uw computer is geïnstalleerd, geeft Tableau in het verbindingsdialoogvenster een bericht weer met een koppeling naar de pagina Stuurprogramma downloaden(Link wordt in een nieuw venster geopend), waar u stuurprogrammalinks en installatie-instructies kunt vinden.

De verbinding maken en de databron instellen

  1. Start Tableau en selecteer onder Verbinding maken de optie SAP HANA.

    1. Selecteer het type verbinding:

      • SingleNode: voer de naam in van de server waarop de database staat waarmee u verbinding wilt maken. Als u een andere poort dan de standaardpoort gebruikt, voert u ook het poortnummer in.

      • MultiNode: voer de hostnaam en het poortnummer van elke server in, gescheiden door een komma. Bijvoorbeeld:

        host1:30015,host2:30015,host3:30015

    2. Selecteer hoe u wilt aanmelden bij de server:

      Windows:

      • Selecteer Windows-verificatie gebruiken als uw omgeving eenmalige aanmelding (SSO) ondersteunt.
      • Selecteer Specifieke gebruikersnaam en wachtwoord gebruiken. Als de server met een wachtwoord is beveiligd en u zich niet in een Kerberos-omgeving bevindt, moet u de gebruikersnaam en het wachtwoord invoeren.
      • Selecteer Aanmelden met OAuth als u OAuth 2.0/OIDC wilt gebruiken om de identiteit van een externe IdP te federeren naar HANA, en selecteer de OAuth-provider die u hebt geconfigureerd. Zie Externe OAuth voor SAP HANA voor meer informatie over hoe u dit kunt configureren.

      Mac:

      • Selecteer Kerberos
      • Selecteer Specifieke gebruikersnaam en wachtwoord gebruiken.
      • Selecteer Aanmelden met OAuth als u OAuth 2.0/OIDC wilt gebruiken om de identiteit van een externe IdP te federeren naar HANA, en selecteer de OAuth-provider die u hebt geconfigureerd. Zie Externe OAuth voor SAP HANA voor meer informatie over hoe u dit kunt configureren.
    3. Selecteer de optie SSL vereisen bij het verbinden met een SSL-server.

    4. Selecteer Initiële SQL om een SQL-opdracht op te geven die aan het begin van elke verbinding moet worden uitgevoerd. Bijvoorbeeld wanneer u de werkmap opent, een extract vernieuwt, zich aanmeldt bij Tableau Server of naar Tableau Server publiceert (optioneel). Zie Initiële SQL uitvoeren voor meer informatie.

    5. Selecteer Aanmelden.

      Als Tableau de verbinding niet tot stand kan brengen, controleer dan of uw referenties kloppen. Als u nog steeds geen verbinding kunt maken, heeft uw computer problemen met het lokaliseren van de server. Neem contact op met uw netwerk- of databasebeheerder voor hulp.

  2. Op de pagina Databron doet u het volgende:

    1. (Optioneel) Selecteer de standaard databronnaam boven aan de pagina en voer vervolgens een unieke databronnaam in voor gebruik in Tableau. Gebruik bijvoorbeeld een naamgevingsconventie voor databronnen waarmee andere gebruikers van de databron kunnen bepalen met welke databron ze verbinding moeten maken.

    2. Selecteer in de vervolgkeuzelijst Schema het zoekpictogram of voer de schemanaam in het tekstvak in en selecteer het zoekpictogram. Selecteer vervolgens het schema.

    3. Selecteer in het tekstvak Tabel het zoekpictogram of voer de tabelnaam in, selecteer het zoekpictogram en selecteer vervolgens de tabel.

      Tableau Desktop ondersteunt ook het verbinden met SAP HANA-tabelfuncties. Deze worden weergeven in het linkerdeelvenster van de pagina Databron onder Opgeslagen procedures.

    4. Sleep de tabel naar het canvas en selecteer vervolgens het tabblad Blad om uw analyse te starten.

      Kolomlabels worden standaard weergegeven.

      Gebruik aangepaste SQL om verbinding te maken met een specifieke query in plaats van met de hele databron. Zie Verbinding maken met een aangepaste SQL-query voor meer informatie.

      Opmerking: wanneer u een self-join met analytische weergave maakt en een van de tabellen variabelen bevat, moet de tabel met variabelen aan de linkerkant staan. Anders kan het zijn dat de join niet de verwachte resultaten oplevert.

Aanmelden op een Mac

Als u Tableau Desktop op een Mac gebruikt, moet u bij het invoeren van de servernaam om verbinding te maken een volledig gekwalificeerde domeinnaam gebruiken, zoals mydb.test.ourdomain.lan, in plaats van een relatieve domeinnaam, zoals mydb of mydb.test.

U kunt het domein ook toevoegen aan de lijst met zoekdomeinen voor de Mac-computer. Wanneer u dan verbinding maakt, hoeft u alleen de servernaam op te geven. Als u de lijst met zoekdomeinen wilt bijwerken, gaat u naar Systeemvoorkeuren > Netwerk > Geavanceerd en opent u het tabblad DNS.

Een SAP HANA-niveauhiërarchie converteren naar een gebruikershiërarchie

Wanneer u een SAP HANA-databron of -werkmap maakt, kunt u uw eigen hiërarchie maken voor gebruik in Tableau. Tableau ondersteunt niveauhiërarchieën die in SAP HANA zijn gemaakt vanaf versie 2019.4. Wanneer u Tableau verbindt met een SAP HANA-berekeningsweergave met een niveauhiërarchie, wordt de structuur van de SAP HANA-niveauhiërarchie weergegeven in het deelvenster Data. Als u de SAP HANA-niveauhiërarchie in Tableau wilt wijzigen, moet u de SAP HANA-niveauhiërarchie converteren naar een gebruikershiërarchie.

Waarschuwing: nadat u een SAP HANA-niveauhiërarchie naar een gebruikershiërarchie hebt geconverteerd, kunt u dit niet meer ongedaan maken. Als u besluit dat u de SAP HANA-niveauhiërarchie wilt gebruiken in plaats van de gebruikershiërarchie, moet u opnieuw beginnen.

Om naar een gebruikershiërarchie te converteren, voert u de volgende stappen uit:

  1. Selecteer in het deelvenster Data de hiërarchie.
  2. Selecteer in het vervolgkeuzemenu Converteren naar gebruikershiërarchie.

JDBC-verbindingen aanpassen

Op Mac en Linux gebruikt SAP HANA een JDBC-verbinding. U kunt de JDBC-verbinding aanpassen met een eigenschappenbestand (.properties). Zie JDBC-verbindingen aanpassen met een eigenschappenbestand(Link wordt in een nieuw venster geopend) in Tableau Community voor meer informatie.

Vertrouwde SSL-certificaten installeren op een Mac

Als u SSL/TLS wilt gebruiken om de communicatie tussen Tableau Desktop en uw database te versleutelen, moet u certificaten toevoegen aan de vertrouwensopslag van het Java-certificaat. Dit is vereist als uw database zelfondertekende certificaten gebruikt. Voer de volgende stappen uit om Tableau Desktop met uw database te verbinden via SSL/TLS:

  1. Start de Terminal-toepassing en ga naar uw Java Startpagina-directory. Deze bevindt zich in /Library/Internet Plug-Ins/JavaAppletPlugin.plugin/Contents/Home, tenzij u de JDK hebt geïnstalleerd of de omgevingsvariabele JAVA_HOME hebt ingesteld.

  2. Voer de volgende opdracht uit:

    bin/keytool -importcert -keystore cacerts -alias <certificate name>  -file <path to certificate file>

Opmerking: vanaf Tableau versie 2020.2 kunt u een aangepast certificaat importeren in de sleutelketen 'Systeem'. Zie Eenzijdige SSL voor JDBC-verbindingen voor details.

Variabelen en invoerparameters selecteren

Als de tabel die u gebruikt vereiste of optionele variabelen of parameters bevat, wordt het dialoogvenster Variabelen en invoerparameters geopend.

  • Vereiste variabelen en parameters geven hun huidige waarde weer of *Vereist.

  • Optionele variabelen en parameters geven hun huidige waarde weer of zijn leeg.

  • Vraag om de variabele wanneer de werkmap wordt geopend door het selectievakje onder Prompt te selecteren.

Selecteer een variabele of parameter en typ of selecteer een waarde. Herhaal dit voor alle vereiste waarden en alle optionele waarden die u wilt opnemen en selecteer vervolgens OK.

Opmerking: u kunt op SQL-query's gebaseerde SAP HANA-prompts gebruiken.

Ondersteuning voor eenmalige aanmelding (SSO) bij SAP HANA

U kunt toegang krijgen tot data, databronnen publiceren en werkmappen publiceren naar Tableau Server, zonder dat u uw gebruikersnaam en wachtwoord opnieuw hoeft in te voeren. Dit kunt u verzorgen door SAP HANA te configureren voor ondersteuning van eenmalige aanmelding (SSO). Om SSO te gebruiken, moet u databronnen en werkmappen publiceren naar Tableau Server met de verificatie Referenties voor Viewer. Om de verificatie Referenties voor Viewer in te schakelen, moet u verbinding maken met SAP HANA via Windows-verificatie op een Windows-computer of Kerberos op een Mac. Zie Publiceren naar de server voor meer informatie.

Aanmelden op de server

U kunt zich aanmelden bij de SAP HANA-server door de servernaam in te voeren. Of u kunt Windows-verificatie gebruiken selecteren op een Windows-computer of Kerberos op een Mac. Selecteer Aanmelden om te voltooien.

Publiceren naar de server

U hoeft geen aanmeldreferenties in te voeren voor toegang tot een databron of een werkmap als u deze publiceert op Tableau Server met SSO ingeschakeld. Voer de volgende stappen uit om SSO in te schakelen wanneer u een databron of werkmap publiceert naar Tableau Server:

  1. Selecteer Server, Databron publiceren of Server, Werkmap publiceren.
  2. Kies onder Databronnen de optie Bewerken.

  3. Voer het volgende uit in het dialoogvenster Databronnen beheren:

    • Selecteer het Publicatietype: Ingesloten in werkmap of Afzonderlijk gepubliceerd.

    • Selecteer Referenties voor Viewer voor Verificatie.

  4. Kies Publiceren.

HANA-extracten vernieuwen wanneer u SSO gebruikt

U kunt het Tableau-hulpprogramma voor data-extractie gebruiken om de extractvernieuwingstaak te automatiseren. Met de volgende opdracht vernieuwt u bijvoorbeeld een gepubliceerd SAP HANA-extract met de naam 'mydatasource'. Met deze opdracht wordt het volgende gespecificeerd:

  • De naam van uw Tableau Server

  • De naam van de te vernieuwen databron

C:\Program Files\Tableau\Tableau 10.2\bin>tableau refreshextract --server https://mytableauserver --datasource mydatasource

Zie Tableau-opdrachtregelhulpprogramma voor data-extractie voor meer informatie over het hulpprogramma.

Prestatietips

U kunt de prestaties verbeteren door binding voor queryparameters in te schakelen.

Bindingsvariabelen gebruiken

Om de prestaties te verbeteren, kan Tableau bindingsvariabelen gebruiken voor uw SAP HANA-query's.

  • Query's: HANA kan een query één keer compileren en deze meerdere keren uitvoeren.
  • Implementaties van HANA met meerdere knooppunten: query's met parameters worden optimaal naar het juiste knooppunt gerouteerd.

Om deze functie in te schakelen, kan uw Tableau Server-beheerder de mogelijkheid CAP_ODBC_QUERY_USE_PREPARE_PARAMETER_MARKER toevoegen aan een TDC-bestand.

Opmerking: voor deze functie is Tableau 2018.3 of hoger vereist.
U kunt CAP_ODBC_QUERY_USE_PREPARE_PARAMETER_MARKER gebruiken met JDBC en ODBC.

Verzamelen van kolommetadata gebruiken

Tableau ondersteunt het verzamelen van kolommetadata, wat de laadtijd voor sommige weergaven kan verbeteren.

Wanneer Tableau de kolommetadata voor een tabel of weergave leest, wordt standaard een voorbereide query op de tabel gebruikt.

Opmerking: het verzamelen van kolommetadata is doorgaans de meest nauwkeurige optie, maar de verwerking hiervan kan langer duren.

U kunt voorbereide querymetadata uitschakelen met een TDC-bestand. Wanneer u verzamelen van kolommetadata gebruikt, gebruikt Tableau de ODBC API, SQLColumns. Deze methode is weliswaar sneller, maar mogelijk niet zo nauwkeurig. Gebruik deze optie met zorg en alleen als deze een goede aanpak lijkt voor uw data. Gebruik de volgende mogelijkheden om kolommetadata via SQLColumns in te schakelen:

  • CAP_ODBC_METADATA_SUPPRESS_EXECUTED_QUERY
  • CAP_ODBC_METADATA_SUPPRESS_PREPARED_QUERY

 

Opmerking: om deze mogelijkheden op tijdelijke tabellen toe te passen, moet u Tableau Server 2019.3.6 of hoger installeren.

TDC-voorbeeld voor SAP HANA

Uw TDC-bestand zou er als volgt uit moeten zien.

<?xml version='1.0' encoding='utf-8' ?>
<connection-customization class='saphana' enabled='true' version='9.3'>
<vendor name='saphana' />
<driver name='saphana' />
<customizations>
<customization name='CAP_ODBC_QUERY_USE_PREPARE_PARAMETER_MARKER' value='yes' />
</customizations>
</connection-customization>

Zie 'Een TDC-bestand maken' in het onderwerp ODBC-verbindingen aanpassen en afstemmen voor meer informatie over het gebruik van TDC-bestanden. Zie ook het Knowledgebase-artikel met de titel Een TDC-bestand gebruiken met Tableau Server.

Belangrijk: neem enabled='true' in uw verbindingsaanpassingsregel op.

Zie ook

Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.