Elenchi di SharePoint (JDBC)

Questo documento descrive come connettere Tableau al driver di Elenchi di SharePoint (JDBC) e configurare l’origine dati.

Nota: il connettore Elenchi di SharePoint per JDBC richiede Tableau 2022.3 o versioni successive e il driver JDBC corrispondente.

Preparare la connessione

Prima di iniziare, raccogli queste informazioni di connessione:

  • URL al sito SharePoint contenente gli elenchi a cui desideri connetterti

  • Edizione del server SharePoint: locale o SharePoint Online

  • Metodo di autenticazione: Azure AD, Single Sign-On di terze parti o autenticazione integrata

  • Nome utente o indirizzo e-mail, password e dominio SSO, se necessario

Autorizzazioni API obbligatorie

In SharePoint, concedi a Tableau le seguenti autorizzazioni API (Application Programming Interface):

  • profile
  • openid
  • e-mail
  • AllSites.Manage
  • offline_access
  • User.Read

Utilizzare un client OAuth personalizzato

Tableau consiglia di configurare un client OAuth personalizzato, in modo da poter controllare completamente la configurazione OAuth in base alle proprie policy IT. L’opzione per l’utilizzo di un client OAuth personalizzato evita inoltre di essere vincolati ai cicli di rilascio di Tableau e alla pianificazione della rotazione del client OAuth di Tableau. Per informazioni su come configurare un client OAuth personalizzato, consulta Configurare OAuth personalizzato per un sito.

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.

Configurare Elenchi di SharePoint (JDBC) su Tableau Server

Se stai utilizzando Tableau Server, sia il connettore che il driver devono essere prima installati su ciascun nodo del server.

  1. Scarica il file del connettore Tableau (TACO) dagli Elenchi di Sharepoint (JDBC) compressi in pacchetto o "cdata.sharepoint.taco" da Tableau Exchange(Il collegamento viene aperto in una nuova finestra).
  2. Sposta il file .taco nella seguente directory in ogni nodo delle tue istanze Tableau Server.
  • Windows: C:\ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Connectors
  • Linux: [Directory di installazione di Tableau Server]/data/tabsvc/vizqlserver/Connectors
  1. Scarica e installa il driver Elenchi di SharePoint (JDBC) da Centro Tableau Driver(Il collegamento viene aperto in una nuova finestra). Il driver JDBC (data.tableau.sharepoint.jar) deve essere posizionato nella seguente directory su ciascun nodo di un’istanza Tableau Server:
  • Windows: C:\Programmi\Tableau\Drivers
  • Linux: /opt/tableau/tableau_driver/jdbc
  1. Riavvia Tableau Server.
  2. Se prevedi di utilizzare OAuth con Elenchi di SharePoint (JDBC), è inoltre necessaria una configurazione aggiuntiva di Tableau Server. Per maggiori informazioni, consulta Configurare Azure AD per OAuth e l’autenticazione moderna.

Effettuare la connessione e impostare l’origine dati

  1. Avvia Tableau e in Connetti seleziona Elenchi di SharePoint (JDBC).
  2. Nella casella di testo Server immetti l’URL SharePoint.
  3. Seleziona l’edizione: Locale o SharePoint Online.
  4. Seleziona il metodo di autenticazione: Azure AD, Nome utente e password, NTLM, ADFS o Basic.
  5. Se scegli Azure AD, seleziona Accedi.
  6. Per altri metodi di autenticazione, immetti le informazioni richieste, quindi seleziona Accedi.

Quindi, 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.

  1. Per avviare l’analisi, seleziona la scheda del foglio.

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.

Entrambi i metodi di autenticazione, su un Mac, richiedono l’immissione del nome utente e della password per la connessione.

Aggiornare i dati

Tableau supporta solo le connessioni dell’estrazione per gli elenchi di SharePoint, non per le connessioni live. È possibile aggiornare i dati aggiornando l’estrazione; gli aggiornamenti incrementali non sono supportati. Per maggiori informazioni, consulta Aggiornare le estrazioni. Per informazioni sulle pianificazioni degli aggiornamenti, consulta Pianificare l’aggiornamento di un’estrazione quando si pubblica una cartella di lavoro.

 

Vedi anche