SAP HANA

Applicabile a: Tableau Desktop, Tableau Prep

Questo articolo illustra come connettere Tableau a un database SAP HANA e impostare l’origine dati.

Nota: questo connettore utilizza driver JDBC per Mac, Linux e Windows. Il driver JDBC per Windows è una novità in Tableau versione 2021.1. La versione del driver JDBC 2.3.4 è la versione consigliata.

Prima di iniziare

Prima di iniziare, raccogli queste informazioni di connessione:

  • Stai effettuando una connessione a nodo singolo o multinodo?
    • Nodo singolo: nome e numero di porta del server di database.
    • Multinodo: nome, nome host e numeri di porta del server di database.
  • Autenticazione:
    • Autenticazione di Windows (solo Windows)
    • Kerberos (solo Mac)
    • Nome utente e password
    • OAuth 2.0/OIDC. Per ulteriori informazioni su come configurarlo, vedere OAuth esterno per SAP HANA.
  • Ti stai connettendo a un server SSL?
  • Statement SQL iniziale da eseguire a ogni connessione Tableau

Driver necessario

Questo connettore richiede un driver per comunicare con il database. Se il driver non è installato sul computer, Tableau visualizza un messaggio nella finestra di dialogo di connessione con un link alla pagina di download dei driver(Il collegamento viene aperto in una nuova finestra) dove si trovano i link del driver e le istruzioni di installazione.

Effettuare la connessione e impostare l’origine dati

  1. Avvia Tableau e, in Connetti, seleziona SAP HANA.

    1. Seleziona il tipo di connessione:

      • Nodo singolo: immetti il nome del server che ospita il database a cui desideri connetterti, oltre al numero di porta, se non ne utilizzi una predefinita.

      • Multinodo: immetti il nome host e il numero di porta di ogni server, separati da una virgola. Ad esempio:

        host1:30015,host2:30015,host3:30015

    2. Seleziona la modalità di accesso al server:

      Windows:

      • Seleziona Usa autenticazione Windows se l’ambiente supporta l’accesso Single Sign-On (SSO).
      • Seleziona Usa un nome utente e una password specifici se il server è protetto da password e non sei in un ambiente Kerberos, devi immettere il nome utente e la password.
      • Seleziona Accesso con OAuth per utilizzare OAuth 2.0/OIDC per federare l'identità da un IdP esterno a HANA e seleziona il provider OAuth che hai configurato. Per ulteriori informazioni su come configurarlo, vedere OAuth esterno per SAP HANA.

      Mac:

      • Seleziona Kerberos
      • Seleziona Usa un nome utente e una password specifici.
      • Seleziona Accesso con OAuth per utilizzare OAuth 2.0/OIDC per federare l'identità da un IdP esterno a HANA e seleziona il provider OAuth che hai configurato. Per ulteriori informazioni su come configurarlo, vedere OAuth esterno per SAP HANA.

    3. Quando ti connetti a un server SSL, seleziona l’opzione Richiedi SSL.

    4. (Facoltativo) Seleziona SQL iniziale per specificare un comando SQL da eseguire all’inizio di ogni connessione, ad esempio quando apri la cartella di lavoro, aggiorni un estrazione, accedi o pubblichi su Tableau Server. Per ulteriori informazioni, consulta Eseguire le istruzioni SQL iniziali.

    5. Seleziona Accedi.

      Se Tableau non riesce a effettuare la connessione, verifica che le tue credenziali siano corrette. Se ancora non riesci a connetterti, significa che il tuo computer ha problemi a localizzare il server. Per ulteriore assistenza, contatta l’amministratore di rete o l’amministratore del database.

  2. Nella pagina dell’origine dati, esegui le seguenti operazioni:

    1. (Facoltativo) Seleziona il nome dell’origine dati predefinita nella parte superiore della pagina, quindi immetti un nome univoco per l’origine dati da utilizzare in Tableau. Ad esempio, utilizza una convenzione di denominazione dell’origine dati che aiuti gli altri utenti a capire a quale origine dati connettersi.

    2. Dall’elenco a discesa Schema, seleziona l’icona di ricerca o immetti il nome dello schema nella casella di testo e seleziona l’icona di ricerca, quindi seleziona lo schema.

    3. Dall’elenco a discesa Tabella, seleziona l’icona di ricerca o immetti il nome della tabella e seleziona l’icona di ricerca, quindi seleziona la tabella.

      Tableau Desktop supporta anche la connessione alle funzioni per le tabelle di SAP HANA, visualizzate sotto Stored procedure nel riquadro di sinistra della pagina Origine dati.

    4. Trascina la tabella sul canvas, quindi seleziona la scheda foglio per avviare l’analisi.

      La visualizzazione predefinita è costituita dalle etichette delle colonne.

      Utilizza una query SQL personalizzata per connetterti a una query specifica piuttosto che all’intera origine dati. Per maggiori informazioni, consulta Connettersi a una query SQL personalizzata.

      Nota: quando crei un join interno con una vista analitica e una delle tabelle contiene variabili, verifica che la tabella con variabili sia a sinistra. In caso contrario, il join potrebbe non restituire i risultati previsti.

Accedere su Mac

Se usi Tableau Desktop su un Mac, quando inserisci il nome del server per connetterti, usa un nome di dominio pienamente qualificato, come mydb.test.ourdomain.lan, invece di un nome di dominio relativo, come mydb o mydb.test.

In alternativa, aggiungi il dominio all’elenco dei domini di ricerca per il computer Mac. In questo modo, quando ti connetterai, dovrai specificare solo il nome del server. Per aggiornare l’elenco dei domini di ricerca, vai su Preferenze di sistema > Rete > Avanzate, quindi apri la scheda DNS.

Convertire una gerarchia di livelli SAP HANA in una gerarchia utenti

Quando crei un’origine dati o una cartella di lavoro SAP HANA, puoi creare una gerarchia personalizzata per l’utilizzo in Tableau. Tableau supporta le gerarchie di livelli create in SAP HANA a partire dalla versione 2019.4. Quando connetti Tableau a una vista di calcolo SAP HANA con una gerarchia di livelli, nel riquadro Dati viene visualizzata la struttura della gerarchia di livelli SAP HANA. Se desideri modificare la gerarchia di livelli SAP HANA in Tableau, devi convertirla in una gerarchia utenti.

Avviso: dopo aver convertito una gerarchia di livelli SAP HANA in una gerarchia utenti, l’operazione non è reversibile. Se decidi di utilizzare la gerarchia di livelli SAP HANA anziché la gerarchia utenti, dovrai ricominciare dall’inizio.

Per eseguire la conversione in una gerarchia utenti, procedi come segue:

  1. Nel riquadro Dati seleziona la gerarchia.
  2. Nel menu a discesa, seleziona Converti in gerarchia utenti.

Personalizzare le connessioni JDBC

Su Mac e Linux, SAP HANA utilizza una connessione JDBC. Puoi personalizzare la connessione JDBC tramite un file .properties. Per maggiori informazioni, consulta Customize JDBC Connections Using a .properties File(Il collegamento viene aperto in una nuova finestra) nella Community di Tableau.

Installare certificati SSL attendibili su Mac

Se desideri utilizzare SSL/TLS per crittografare le comunicazioni tra Tableau Desktop e il tuo database, è necessario aggiungere certificati all’archivio dei certificati attendibili di Java. Questo è obbligatorio se il database utilizza certificati autofirmati. Per connettere Tableau Desktop al database utilizzando SSL/TLS, procedi come segue:

  1. Avvia l’applicazione Terminale e passa alla home directory di Java. È disponibile in /Library/Internet Plug-Ins/JavaAppletPlugin.plugin/Contents/Home, a meno che tu non abbia installato JDK o impostato la variabile di ambiente JAVA_HOME.

  2. Esegui questo comando:

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

Nota: a partire da Tableau versione 2020.2, è possibile importare un certificato personalizzato nel portachiavi "Sistema". Per informazioni dettagliate, consulta SSL unidirezionale per le connessioni JDBC.

Selezionare le variabili e i parametri di input

Se la tabella utilizzata include variabili o parametri obbligatori o facoltativi, si apre la finestra di dialogo Variabili e parametri di input.

  • Le variabili e i parametri necessari visualizzano il loro valore attuale o *Necessario.

  • Le variabili e i parametri facoltativi visualizzano il loro valore attuale o sono vuoti.

  • Richiedi la variabile all’apertura della cartella di lavoro selezionando la casella di controllo in Prompt.

Seleziona una variabile o un parametro e digita o seleziona un valore corrispondente. Ripeti l’operazione per tutti i valori necessari e per ogni valore facoltativo che desideri includere, quindi seleziona OK.

Nota: puoi utilizzare messaggi di richiesta SAP HANA basati su query SQL.

Supporto per l’accesso Single Sign-On (SSO) di SAP HANA

Puoi accedere ai dati, pubblicare origini dati e pubblicare cartelle di lavoro in Tableau Server senza dover reinserire nome utente e password configurando SAP HANA per il supporto dell’accesso Single Sign-On (SSO). Per utilizzare SSO, devi pubblicare origini dati e cartelle di lavoro in Tableau Server con l’autenticazione Credenziali Viewer. Per abilitare l’autenticazione Credenziali Viewer, è necessario connettersi a SAP HANA utilizzando l’autenticazione Windows su un computer Windows o Kerberos su un Mac. Per maggiori informazioni, consulta Pubblicare sul server.

Accedere al server

Puoi accedere al server SAP HANA immettendo il nome del server. In alternativa, puoi selezionare Usa autenticazione di Windows su un computer Windows o Kerberos su un Mac. Per eseguire l’accesso, seleziona Accedi.

Pubblicare sul server

Non è necessario immettere le credenziali per accedere a un’origine dati o a una cartella di lavoro, se questa è pubblicata in Tableau Server con SSO abilitato. Per abilitare l’accesso SSO quando pubblichi un’origine dati o cartella di lavoro su Tableau Server, procedi come segue:

  1. Seleziona Server, Pubblica origine dati oppure Server, Pubblica cartella di lavoro.

  2. In Origini dati seleziona Modifica.

  3. Nella finestra di dialogo Gestisci origini dati, procedi come segue:

    • Seleziona il tipo di pubblicazione: Cartella di lavoro incorporata o Pubblicato separatamente.

    • Seleziona Credenziali visualizzatore per l' autenticazione.

  4. Scegli Pubblica.

Come aggiornare le estrazioni HANA con l’accesso SSO

Puoi utilizzare l’utilità di estrazione dati Tableau per automatizzare l’attività di aggiornamento dell’estrazione. Ad esempio, il comando seguente aggiorna un’estrazione SAP HANA pubblicata denominata "mydatasource". Questo comando specifica quanto segue:

  • Il nome del tuo Tableau Server

  • Il nome dell’origine dati da aggiornare

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

Per maggiori informazioni sull’utilità, consulta Utilità a riga di comando per l’estrazione di dati di Tableau.

Suggerimenti sulle prestazioni

Puoi migliorare le prestazioni abilitando l’associazione di parametri di query.

Utilizzare le variabili di associazione

Per migliorare le prestazioni, Tableau può utilizzare variabili di associazione per le query SAP HANA.

  • Query: HANA può compilare una query una sola volta ed eseguirla più volte.
  • Distribuzioni HANA multi-nodo: le query con parametri vengono instradate in modo ottimale al nodo corretto.

Per abilitare questa funzionalità, l’amministratore di Tableau Server può aggiungere la funzionalità CAP_ODBC_QUERY_USE_PREPARE_PARAMETER_MARKER in un file TDC.

Nota: questa funzionalità richiede Tableau 2018.3 o versione successiva.
Puoi utilizzare CAP_ODBC_QUERY_USE_PREPARE_PARAMETER_MARKER con JDBC e ODBC.

Utilizzare la raccolta di metadati delle colonne

Tableau supporta la raccolta di metadati delle colonne, che può contribuire a migliorare il tempo di caricamento per alcune viste.

Quando Tableau legge i metadati delle colonne per una tabella o una vista, per impostazione predefinita utilizza una query preparata nella tabella.

Nota: la raccolta dei metadati delle colonne è in genere l’opzione più accurata, ma l’elaborazione può richiedere più tempo.

Puoi disabilitare i metadati della query preparata utilizzando un file TDC. Quando utilizzi la raccolta dei metadati delle colonne, Tableau utilizza l’API ODBC SQLColumns. Anche se questo metodo è più veloce, potrebbe non essere altrettanto accurato. Utilizza questa opzione con cautela e solo quando sembra un approccio valido per i dati. Utilizza le funzionalità seguenti per abilitare i metadati delle colonne tramite SQLColumns:

  • CAP_ODBC_METADATA_SUPPRESS_EXECUTED_QUERY
  • CAP_ODBC_METADATA_SUPPRESS_PREPARED_QUERY

 

Nota: per applicare queste funzionalità alle tabelle temporanee, devi installare Tableau Server 2019.3.6 o versione successiva.

Esempio di file TDC per SAP HANA

Il file TDC dovrebbe essere simile a quello nell’esempio seguente.

<?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>

Per maggiori informazioni sull’utilizzo dei file TDC, consulta "Creare un file TDC" nell’argomento Personalizzare e ottimizzare le connessioni ODBC. Consulta anche l’articolo della Knowledge Base Utilizzo di un file TDC con Tableau Server.

Importante: assicurati di includere enabled='true' nella riga di personalizzazione della connessione.

Vedi anche

Torna in alto
Grazie per il tuo feedback.Il tuo feedback è stato inviato. Grazie!