Utilizzare ODBC per connettere Tableau a un endpoint SQL di flusso dati
Scaricare, installare e configurare ODBC su sistema operativo MAC o Windows 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.
-
Scaricare il driver ODBC.
- Nella barra di ricerca globale, cercare
Data Flow
e selezionare Servizio flusso dati. - Selezionare Endpoint SQL nella navigazione lato sinistro.
- Selezionare un endpoint SQL dalla lista. Viene visualizzata la pagina dei dettagli per l'endpoint SQL.
- In Connetti selezionare Driver.
- In ODBC selezionare Scarica driver ODBC.
- Selezionare Mac. Il download inizia.
- Al termine dello scaricamento, estrarre il file zip scaricato.
- Nella barra di ricerca globale, cercare
-
Fare doppio clic per installare il driver.
Viene visualizzata la finestra di installazione.
-
Selezionare Contina.
Leggere il contratto di licenza visualizzato.
- Selezionare Accetto.
- (Opzionale) Per modificare la directory di installazione dall'impostazione predefinita, selezionare Change install location, individuare la posizione da installare e selezionare OK.
- Selezionare Next per confermare la directory di installazione.
- Selezionare Install.
-
Al termine dell'installazione, selezionare Finish.
La directory di installazione del driver è:
/Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib
- (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.- Scaricare ODBC Manager dal sito di download.
- Fare doppio clic sul file
.dmg
scaricato. - Fare doppio clic sul file
ODBC Manager.pkg
. - 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).
-
Recupera il nome host per l'endpoint SQL a cui connettersi.
- Aprire la pagina Dettagli per l'endpoint SQL quando è attivo.
- Selezionare Driver.
- In Driver OBC, selezionare Mostra dettagli. Viene visualizzata una finestra popup.
- Selezionare Mostra nella stringa Nome host. Viene visualizzato il nome host completo.
- Selezionare Copia nella stringa Nome host. Il nome host completo viene copiato negli Appunti.
- Salvare il nome host per utilizzarlo in un secondo momento.
- (Facoltativo) Creare un DSN utilizzando ODBC Manager.
-
Avviare ODBC Manager.
-
Selezionare DSN utente o DSN di sistema in base alle esigenze.
-
Selezionare Aggiungi.
-
Selezionare
Simba OCI Spark ODBC Driver
. -
Selezionare OK.
-
Immettere il nome del DSN, ad esempio
Data Flow SQL Endpoint
e, facoltativamente, aggiungere una descrizione. -
Creare una coppia Valore parola chiave per ogni parametro DSN.
-
Selezionare Aggiungi per creare una coppia Valore parola chiave.
-
Selezionare Parola chiave e sostituirla con il nome del parametro.
-
Selezionare Valore e sostituirlo con il valore del parametro.
- Ripetere i passaggi da g a j per ogni parametro.
- Aggiungere i dettagli di autenticazione della connessione:
- Per connettersi a un endpoint SQL utilizzando una chiave di firma API non nella posizione predefinita
~/.oci/config
, aggiungere il parametro:
doveOCIConfigFile=ConfigFileLocation
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:
Se non viene specificato alcun profilo, il connettore tenta di utilizzare il profilo denominato DEFAULT:OCIProfile=<profile_to_use>
OCIProfile=<profile_to_use>
- Per la connessione a un endpoint SQL mediante un token (attraverso il browser), omettere il parametro
OCIConfigFile
dalla configurazione DSN.
- Per connettersi a un endpoint SQL utilizzando una chiave di firma API non nella posizione predefinita
-
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 fileodbc.ini
nella directory corrispondente per il tipo di DSN creato. Se si creano più DSN, ODBC Manager aggiunge le voci per ogni DSN al fileodbc.ini
esistente. Il fileodbc.ini
si trova nella directory~/Library/ODBC
per i DSN utente e/Library/ODBC
per i DSN di sistema. -
- (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 fileodbc.ini
esistente. Se si crea il primo DSN per il driver, creare manualmente il fileodbc.ini
e aggiungere la voce al file.- 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 fileodbc.ini
:[ODBC Data Sources]
-
Per ogni DSN, specificare quanto segue:
- 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
- Creare una sezione per la configurazione DSN, aggiungendo
[dsn_name]
in una nuova riga alla fine del file.[dsn_name]
- Nella sezione DSN creata specificare il percorso della directory del file del driver, nel formato:
Driver = /Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib
-
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:
doveOCIConfigFile=ConfigFileLocation
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 denominatoDEFAULT
:OCIProfile=PROFILE_TO_USE
- Per connettersi a un endpoint SQL utilizzando un token (basato su browser), è possibile omettere il parametro
OCIConfigFile
dalla configurazione DSN.
- Per la connessione all'endpoint SQL mediante una chiave di firma API (non nella posizione predefinita di
- Eventuali altri parametri sono specificati nella forma
<parameter_name> = <value>.
L'esempio riportato di seguito mostra un fileodbc.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
- In
- Verificare che il percorso del file di configurazione OCI per utilizzare la chiave di firma API per l'autenticazione sia corretto.
- Convalidare il percorso del file della chiave privata nella configurazione.
- Se si crea il primo DSN nel file
Download e installazione del driver ODBC in Windows
Seguire questi passaggi per scaricare e installare un driver ODBC da utilizzare con Tableau su Windows/
-
Scaricare il driver ODBC di Windows da .
- Nella barra di ricerca globale, cercare
Data Flow
e selezionare Servizio flusso dati. - Selezionare Endpoint SQL nella navigazione lato sinistro.
- Selezionare un endpoint SQL dalla lista. Viene visualizzata la pagina dei dettagli per l'endpoint SQL.
- In Connetti selezionare Driver.
- In ODBC selezionare Scarica driver ODBC.
- Selezionare Windows. Il download inizia.
- Al termine dello scaricamento, estrarre il file zip scaricato.
- Nella barra di ricerca globale, cercare
-
Estrarre il file
.zip
. -
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. - Selezionare Successivo.
- Accettare i termini del Contratto di licenza.
- Selezionare Successivo.
- (Opzionale) Per modificare la directory di installazione dall'impostazione predefinita:
- Selezionare Modifica....
- Cercare la directory richiesta.
- Selezionare OK.
- Per accettare la directory di installazione, selezionare Avanti.
- Selezionare Install.
- 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).
-
Recupera il nome host per l'endpoint SQL a cui connettersi.
- Aprire la pagina Dettagli per l'endpoint SQL quando è attivo.
- Selezionare Driver.
- In Driver OBC, selezionare Mostra dettagli. Viene visualizzata una finestra popup.
- Selezionare Mostra nella stringa Nome host. Viene visualizzato il nome host completo.
- Selezionare Copia nella stringa Nome host. Il nome host completo viene copiato negli Appunti.
- Salvare il nome host per utilizzarlo in un secondo momento.
-
Creare un DSN.
-
Aprire l'applicazione Origini dati ODBC.
-
Selezionare DSN utente o DSN di sistema in base alle esigenze.
-
Selezionare Aggiungi.
-
Selezionare
Simba OCI Spark ODBC Driver
. -
Selezionare Fine.
-
Immettere il nome del DSN, ad esempio
Data Flow SQL Endpoint
e, facoltativamente, aggiungere una descrizione. -
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
-
- Impostare File di configurazione OCI sul percorso assoluto del file di configurazione OCI da utilizzare per la connessione.
- 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
. - Selezionare Ignora SQL_DRIVER_NOPROMPT.
- 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.
- 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.
- 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. - Selezionare OK per salvare le impostazioni.
- Per eseguire il test del DSN, selezionare Test.
-
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.
- Apri Tableau.
-
Selezionare Altri database (ODBC).
Viene visualizzata una nuova finestra.
- Selezionare DSN.
-
Selezionare il DSN
Data Flow SQL Endpoint
dall'elenco.Tutti i parametri di connessione richiesti vengono popolati automaticamente. - Selezionare Accedi.