Personalizzare e ottimizzare una connessione
È possibile personalizzare i parametri di una stringa di connessione e le funzionalità della connessione utilizzando un file TDC. Ciò si applica sia alle connessioni ODBC che JDBC.
Se stai personalizzando una connessione basata su JDBC, puoi anche modificare i parametri di una stringa di connessione in un file properties. Per informazioni dettagliate, consulta Utilizzare un file properties per personalizzare una connessione JDBC.
Importante: i file TDC possono essere utilizzati per personalizzare la funzionalità di una connessione o per diagnosticare e risolvere problemi relativi alla connessione ai dati. Tableau non è in grado di verificare in dettaglio ogni potenziale modifica che potresti apportare a questi file. La creazione e l'utilizzo dei file TDC richiedono modifiche manuali ed è fondamentale sottoporli ad accurati test prima di distribuirli in un ambiente di produzione.
Utilizzare un file TDC per personalizzare una connessione
Nota: è possibile avere un solo file TDC per connettore. Se sono presenti più file TDC che fanno riferimento allo stesso connettore, ne verrà applicato solo uno.
I file TDC (Tableau Datasource Customization) sono file XML con estensione ".tdc". Questi file vengono utilizzati per personalizzare le impostazioni specifiche di Tableau. Per una connessione basata su ODBC, puoi anche utilizzare un file TDC per definire parti degli standard ODBC e SQL supportate dal driver ODBC.
Un file TDC contiene il nome del fornitore, il nome del driver e la sezione <connection-customization> (include anche la classe). Per un connettore integrato, il nome del fornitore e il nome del driver devono corrispondere al nome della classe del connettore. In genere, il nome del fornitore corrisponde al nome del driver. Per i connettori Altri database vengono utilizzati due nomi di classe generici:
- Per il connettore Altri database (JDBC) il nome della classe è "genericjdbc".
- Per il connettore Altri database (ODBC) il nome della classe è "genericodbc".
Se un file di cartella di lavoro o di origine dati esistente dispone già di una sezione di personalizzazione abilitata, Tableau utilizza solo le personalizzazioni definite da tale sezione, non quelle nel file TDC.
Struttura di un file TDC
Ogni file TDC presenta la seguente struttura di base:
<connection-customization class=DSCLASS enabled='true' version='10.0'>
<vendor name=VENDOR />
<driver name=DRIVER />
<customizations>
<customization name='CAP_FAST_METADATA' value='yes'/>
<customization name='CAP_SOMETHING_ELSE' value='yes'/>
...
</customizations>
</connection-customization>Un file TDC contiene tre sezioni principali:
- Variabili di personalizzazione della connessione
- Nome del fornitore e del driver
- Le personalizzazioni stesse
La sezione connection-customization comprende quanto segue:
- class: l’origine dati che desideri connettere e personalizzare.
- enabled: specifica se vengono applicate le personalizzazioni della connessione del file TDC. Nel file TDC, sempre impostato su "true".
- version: Tableau ignora il numero di versione.
La sezione successiva è fondamentale perché identifica il nome del fornitore e il nome del driver del fornitore del database per l’origine dati del file TDC. Ogni file TDC può eseguire il binding di un solo tipo di origine dati. Per le nostre origini dati native, entrambi questi nomi devono corrispondere al nome della classe dell’origine dati, ad esempio "teradata" per le connessioni Teradata. Per le origini dati ODBC, il nome del fornitore e il nome del driver del file TDC devono corrispondere a quanto segnalato a Tableau dal database e dal driver, ad esempio "SQLite" e "SQLite3 ODBC Driver", rispettivamente.
Nella sezione finale sono elencate le personalizzazioni effettive della connessione.
Ecco due file TDC di esempio: il primo, una connessione ODBC generica e il secondo, una modifica a una connessione Salesforce nativa. Si noti che questi sono solo a scopo esemplificativo e le personalizzazioni elencate non sono selezionate per ottenere un obiettivo specifico.
<?xml version='1.0' encoding='utf-8' ?>
<connection-customization class='genericodbc' enabled='true' version='8.10'>
<vendor name='Gen_ODBC_Vendor'/>
<driver name='Gen_Driver'/>
<customizations>
<customization name='CAP_FAST_METADATA' value='yes' />
<customization name='CAP_ODBC_BIND_FORCE_MAX_STRING_BUFFERS' value='yes' />
<customization name='CAP_ODBC_BIND_PRESERVE_BOM' value='yes' />
</customizations>
</connection-customization>
<?xml version='1.0' encoding='utf-8' ?>
<connection-customization class='salesforce' enabled='true' version='8.10'>
<vendor name='salesforce'/>
<driver name='salesforce'/>
<customizations>
<customization name='CAP_ODBC_EXPORT_CONTINUE_ON_ERROR' value='yes' />
<customization name='CAP_ODBC_EXPORT_FORCE_SINGLE_ROW_BINDING' value='yes' />
<customization name='CAP_ODBC_EXPORT_SUPPRESS_STRING_WIDTH_VALIDATION' value='no' />
</customizations>
</connection-customization>Per maggiori informazioni sulle personalizzazioni disponibili, consulta:
Utilizzare un file properties per personalizzare una connessione JDBC
I file properties vengono utilizzati da JDBC e passati direttamente al driver JDBC. Si tratta di file di testo normale con estensione ".properties". Contengono coppie chiave-valore per ogni parametro di connessione.
L’utilizzo di un file properties con una connessione JDBC è simile all’utilizzo del parametro odbc-connect-string-extras in un file TDC per le connessioni ODBC.
Nota: un file properties deve essere in formato Latin-1 (consulta https://en.wikipedia.org/wiki/.properties(Il collegamento viene aperto in una nuova finestra)). Tuttavia, purché includa solo caratteri ASCII, puoi salvare il file in formato UTF-8 senza byte order mark (BOM).
Nel file, inserisci ogni coppia chiave-valore su una riga distinta senza delimitatore. Assegna al file lo stesso nome del connettore corrispondente, ma con l’estensione ".properties". Ad esempio, il file properties per il connettore SAP HANA sarà "saphana.properties".
Installazione dei file tdc e properties
Una volta creato un file di personalizzazione (TDC o properties), è necessario posizionarlo in specifiche directory "Origini dati" affinché possa essere scoperto e utilizzato dai prodotti Tableau. Ad esempio, se gli utenti pubblicheranno contenuti da Tableau Desktop a Tableau Server, le personalizzazioni dovranno essere copiate in entrambe le directory del prodotto.
Dopo aver copiato il file nelle directory appropriate, Tableau (inclusi tutti i nodi se si utilizza Tableau Server) deve essere riavviato affinché le modifiche vengano riconosciute. Di seguito è riportato il percorso della directory in un'installazione predefinita.
Percorsi dell'applicazione Tableau Desktop
- Desktop/Windows:
C:\Users\myuser\My Tableau Repository\Datasources - Desktop/Mac:
~/Documents/My Tableau Repository/Datasources - Prep Builder/Windows:
C:\Users\myuser\Documents\My Tableau Prep Repository\Datasource - Prep Builder/Mac:
~/Documents/My Tableau Prep Repository/Datasources - Bridge/Windows:
C:\Users\myuser\Documents\My Tableau Bridge Repository\Datasources - Bridge/Linux:
/root/Documents/My_Tableau_Bridge_Repository/Datasources/
Percorso di Tableau Server
Nota: i file di personalizzazione devono essere copiati nella directory appropriata per ogni nodo del server in uso.
- Windows:
- Server:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources
C:\Program Files\Tableau\Tableau Server\packages\bin.<build number> - Connessioni virtuali:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\minerva\Datasources - Flussi di Prep:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowprocessor\Datasources - Web authoring di Prep:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowminerva\Datasources - Linux:
- Server:
/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/ - Connessioni virtuali:
/var/opt/tableau/tableau_server/data/tabsvc/minerva/Datasources/ - Flussi di Prep:
/var/opt/tableau/tableau_server/data/tabsvc/flowprocessor/Datasources/ - Web authoring di Prep:
/var/opt/tableau/tableau_server/data/tabsvc/flowminerva/Datasources/
Dopo aver salvato il file TDC o properties nel percorso corretto e riavviato le applicazioni, verranno applicate a tutte le connessioni per lo stesso tipo di origine dati.