Utilizzare ODBC per connettere Tableau a un endpoint SQL di flusso dati

Download e installazione del driver ODBC su Mac OS

Segui questi passaggi per scaricare e installare un driver ODBC da utilizzare con Tableau su Mac OS.

  1. Scaricare il driver ODBC.
    1. Nella barra di ricerca globale, cercare Data Flow e selezionare Servizio flusso dati.
    2. Selezionare Endpoint SQL nella navigazione lato sinistro.
    3. Selezionare un endpoint SQL dalla lista. Viene visualizzata la pagina dei dettagli per l'endpoint SQL.
    4. In Connetti selezionare Driver.
    5. In ODBC selezionare Scarica driver ODBC.
    6. Selezionare Mac. Il download inizia.
    7. Al termine dello scaricamento, estrarre il file zip scaricato.
  2. Fare doppio clic per installare il driver.
    Viene visualizzata la finestra di installazione.
  3. Selezionare Contina.
    Leggere il contratto di licenza visualizzato.
  4. Selezionare Accetto.
  5. (Opzionale) Per modificare la directory di installazione dall'impostazione predefinita, selezionare Change install location, individuare la posizione da installare e selezionare OK.
  6. Selezionare Next per confermare la directory di installazione.
  7. Selezionare Install.
  8. Al termine dell'installazione, selezionare Finish.
    La directory di installazione del driver è:
    /Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib
  9. (Facoltativo) Installare ODBC Manager.
    ODBC Manager è uno strumento per configurare i driver e creare e gestire DSN. Lo strumento è facoltativo perché è anche possibile creare i DSN manualmente modificando il file odbc.ini appropriato.
    1. Scaricare ODBC Manager dal sito di download.
    2. Fare doppio clic sul file .dmg scaricato.
    3. Fare doppio clic sul file ODBC Manager.pkg.
    4. Seguire i prompt per installarlo.

Configurazione del driver ODBC su Mac OS

Segui questi passaggi per configurare il driver ODBC su Mac OS.

È possibile creare DSN utente (accessibili solo dall'utente che lo ha creato sulla workstation) o DSN di sistema (accessibili da qualsiasi utente connesso alla workstation).

  1. Recupera il nome host per l'endpoint SQL a cui connettersi.
    1. Aprire la pagina Dettagli per l'endpoint SQL quando è attivo.
    2. Selezionare Driver.
    3. In Driver OBC, selezionare Mostra dettagli. Viene visualizzata una finestra popup.
    4. Selezionare Mostra nella stringa Nome host. Viene visualizzato il nome host completo.
    5. Selezionare Copia nella stringa Nome host. Il nome host completo viene copiato negli Appunti.
    6. Salvare il nome host per utilizzarlo in un secondo momento.
  2. (Facoltativo) Creare un DSN utilizzando ODBC Manager.
    1. Avviare ODBC Manager.

    2. Selezionare DSN utente o DSN di sistema in base alle esigenze.

    3. Selezionare Aggiungi.

    4. Selezionare Simba OCI Spark ODBC Driver.

    5. Selezionare OK.

    6. Immettere il nome del DSN, ad esempio Data Flow SQL Endpoint e, facoltativamente, aggiungere una descrizione.

    7. Creare una coppia Valore parola chiave per ogni parametro DSN.

    8. Selezionare Aggiungi per creare una coppia Valore parola chiave.

    9. Selezionare Parola chiave e sostituirla con il nome del parametro.

    10. Selezionare Valore e sostituirlo con il valore del parametro.

    11. Ripetere i passaggi da g a j per ogni parametro.
    12. Aggiungere i dettagli di autenticazione della connessione:
      1. Per connettersi a un endpoint SQL utilizzando una chiave di firma API non nella posizione predefinita ~/.oci/config, aggiungere il parametro:
        OCIConfigFile=ConfigFileLocation
        dove ConfigFileLocation è il percorso assoluto del file di configurazione OCI da utilizzare con la connessione.
        Facoltativamente, impostare il campo OCIProfile sul nome del profilo OCI nel file di configurazione da utilizzare con la connessione:
        OCIProfile=<profile_to_use>
                                                        
        Se non viene specificato alcun profilo, il connettore tenta di utilizzare il profilo denominato DEFAULT:
        OCIProfile=<profile_to_use>
                                                        
      2. Per la connessione a un endpoint SQL mediante un token (attraverso il browser), omettere il parametro OCIConfigFile dalla configurazione DSN.
    13. Selezionare OK per creare il DSN.

    Nota

    Se si crea il primo DSN utente o di sistema per il driver ODBC, ODBC Manager crea il file odbc.ini nella directory corrispondente per il tipo di DSN creato. Se si creano più DSN, ODBC Manager aggiunge le voci per ogni DSN al file odbc.ini esistente. Il file odbc.ini si trova nella directory ~/Library/ODBC per i DSN utente e /Library/ODBC per i DSN di sistema.
  3. (Facoltativo) Creare un DSN aggiungendo una voce a odbc.ini.
    Se per il driver è già stato creato un DSN utente o un DSN di sistema, aggiungere la nuova voce al file odbc.ini esistente. Se si crea il primo DSN per il driver, creare manualmente il file odbc.ini e aggiungere la voce al file.
    1. Se si crea il primo DSN nel file odbc.ini vuoto, creare una sezione per le origini dati ODBC (solo per la prima volta), aggiungendo la riga seguente al file odbc.ini:
      [ODBC Data Sources]
    2. Per ogni DSN, specificare quanto segue:

      1. In [ODBC Data Sources] specificare il nome DSN e il nome del driver ODBC (ovvero il driver ODBC Simba OCI Spark), nel formato <dsn_name> = <driver_name>. Ad esempio:
        [ODBC Data Sources]dsn_name = Simba OCI Spark ODBC Driver
      2. Creare una sezione per la configurazione DSN, aggiungendo [dsn_name] in una nuova riga alla fine del file.
        [dsn_name]
      3. Nella sezione DSN creata specificare il percorso della directory del file del driver, nel formato:
        Driver = /Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib
      4. Fornire i parametri di connessione quali host e file di configurazione. I parametri di connessione aggiunti al DSN non devono essere specificati nella stringa di connessione ODBC.

        • Per la connessione all'endpoint SQL mediante una chiave di firma API (non nella posizione predefinita di ~/.oci/config), aggiungere il parametro:
          OCIConfigFile=ConfigFileLocation
          dove ConfigFileLocation è il percorso assoluto del file di configurazione OCI da utilizzare per la connessione.

          Facoltativamente, impostare il campo OCIProfile sul nome del profilo OCI nel file di configurazione da utilizzare per la connessione. Se non viene specificato alcun profilo, il connettore tenta di utilizzare il profilo denominato DEFAULT:

          OCIProfile=PROFILE_TO_USE
        • Per connettersi a un endpoint SQL utilizzando un token (basato su browser), è possibile omettere il parametro OCIConfigFile dalla configurazione DSN.
      5. Eventuali altri parametri sono specificati nella forma <parameter_name> = <value>. L'esempio riportato di seguito mostra un file odbc.ini che configura le origini dati mediante la chiave API.
        [ODBC Data Sources]
        Data Flow SQL Endpoint = Simba OCI Spark ODBC Driver
        [Data Flow SQL Endpoint]
        Driver = /Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib
        Description = Description of the connection
        Host = amaaaaaaezym32iajmhpmxybehc7plnvpxsmjhleiav37x5rm7pjx476ewqa.interactive.dataflowclusters.us-ashburn-1.oci.oc-test.com
        OCIConfigFile = /Users/username/.oci/config
        OCIProfile = OCIProfileToUse
        OCIIgnoreDriverNoPrompt = 1
    3. Verificare che il percorso del file di configurazione OCI per utilizzare la chiave di firma API per l'autenticazione sia corretto.
    4. Convalidare il percorso del file della chiave privata nella configurazione.

Download e installazione del driver ODBC in Windows

Seguire questi passaggi per scaricare e installare un driver ODBC da utilizzare con Tableau su Windows/

  1. Scaricare il driver ODBC di Windows da .
    1. Nella barra di ricerca globale, cercare Data Flow e selezionare Servizio flusso dati.
    2. Selezionare Endpoint SQL nella navigazione lato sinistro.
    3. Selezionare un endpoint SQL dalla lista. Viene visualizzata la pagina dei dettagli per l'endpoint SQL.
    4. In Connetti selezionare Driver.
    5. In ODBC selezionare Scarica driver ODBC.
    6. Selezionare Windows. Il download inizia.
    7. Al termine dello scaricamento, estrarre il file zip scaricato.
  2. Estrarre il file .zip.
  3. Fare doppio clic sul programma di installazione a 32 bit, Simba OCI Spark 2.6 32-bit.msi, se il sistema è a 32 bit, oppure fare doppio clic sul programma di installazione a 64 bit, Simba OCI Spark 2.6 64-bit.msi, se il sistema è a 64 bit.
  4. Selezionare Successivo.
  5. Accettare i termini del Contratto di licenza.
  6. Selezionare Successivo.
  7. (Opzionale) Per modificare la directory di installazione dall'impostazione predefinita:
    1. Selezionare Modifica....
    2. Cercare la directory richiesta.
    3. Selezionare OK.
  8. Per accettare la directory di installazione, selezionare Avanti.
  9. Selezionare Install.
  10. Al termine dell'installazione, selezionare Finish.

Configurazione del driver ODBC in Windows

Per configurare il driver ODBC in Windows, attenersi alla procedura riportata di seguito.

È possibile creare DSN utente (accessibili solo dall'utente che lo ha creato sulla workstation) o DSN di sistema (accessibili da qualsiasi utente connesso alla workstation).

  1. Recupera il nome host per l'endpoint SQL a cui connettersi.
    1. Aprire la pagina Dettagli per l'endpoint SQL quando è attivo.
    2. Selezionare Driver.
    3. In Driver OBC, selezionare Mostra dettagli. Viene visualizzata una finestra popup.
    4. Selezionare Mostra nella stringa Nome host. Viene visualizzato il nome host completo.
    5. Selezionare Copia nella stringa Nome host. Il nome host completo viene copiato negli Appunti.
    6. Salvare il nome host per utilizzarlo in un secondo momento.
  2. Creare un DSN.
    1. Aprire l'applicazione Origini dati ODBC.

    2. Selezionare DSN utente o DSN di sistema in base alle esigenze.

    3. Selezionare Aggiungi.

    4. Selezionare Simba OCI Spark ODBC Driver.

    5. Selezionare Fine.

    6. Immettere il nome del DSN, ad esempio Data Flow SQL Endpoint e, facoltativamente, aggiungere una descrizione.

    7. Per l'autenticazione, è possibile utilizzare una chiave di firma API per connettersi a un endpoint SQL oppure utilizzare un token (basato su browser) per connettersi a un endpoint SQL.

      Per utilizzare una chiave di firma API
      1. Impostare File di configurazione OCI sul percorso assoluto del file di configurazione OCI da utilizzare per la connessione.
      2. Facoltativamente, impostare il campo Profilo OCI sul nome del profilo OCI da utilizzare per la connessione. Se non viene specificato alcun profilo, il connettore tenta di utilizzare il profilo denominato DEFAULT.
      3. Selezionare Ignora SQL_DRIVER_NOPROMPT.
      4. Selezionare OK per salvare le impostazioni.
      Per utilizzare un token (basato su browser)
      È possibile scegliere di non impostare completamente le opzioni DFI e di eseguire solo il test del DSN (passaggio iv) oppure selezionare Opzioni DFI e continuare con i passi riportati di seguito.
      1. Impostare il campo File di configurazione OCI su un percorso che non contiene un file di configurazione OCI per utilizzare l'autenticazione basata su token.
      2. Per visualizzare un browser Web utilizzato per completare il flusso di autenticazione basato su token anche quando è abilitato SQL_DRIVER_NOPROMPT, selezionare Ignora SQL_ DRIVER_NOPROMPT.
      3. Selezionare OK per salvare le impostazioni.
      4. Per eseguire il test del DSN, selezionare Test.
    8. Selezionare OK per creare il DSN.

Connessione di Tableau a un endpoint SQL di flusso dati mediante ODBC

Attenersi alla procedura riportata di seguito per connettere Tableau a un endpoint SQL di flusso dati mediante ODBC.

  1. Apri Tableau.
  2. Selezionare Altri database (ODBC).
    Viene visualizzata una nuova finestra.
  3. Selezionare DSN.
  4. Selezionare il DSN Data Flow SQL Endpoint dall'elenco.
    Tutti i parametri di connessione richiesti vengono popolati automaticamente.
  5. Selezionare Accedi.