Configurare il componente aggiuntivo Azure Databricks Excel

Il componente aggiuntivo Azure Databricks Excel connette l'area di lavoro Azure Databricks a Microsoft Excel, portando i dati di Lakehouse regolati direttamente nei fogli di calcolo per facilitare il passaggio dai dati alle decisioni più velocemente. Il componente aggiuntivo è completamente supportato sia su Excel per il web che nelle versioni desktop per Windows e macOS.

Questa pagina descrive i due metodi disponibili per configurare il componente aggiuntivo Azure Databricks Excel Microsoft Excel. Questo componente aggiuntivo usa l'autenticazione Single Sign-On (SSO) per connettersi all'area di lavoro Azure Databricks e supporta Unity Catalog per la governance dei dati e il controllo di accesso.

Prerequisiti

Prima di installare il componente aggiuntivo Excel, verificare di disporre degli elementi seguenti:

• Accesso a un'area di lavoro Azure Databricks con Il catalogo Unity abilitato.
• L'URL dell'area di lavoro di Azure Databricks workspace per ogni area di lavoro a cui Excel deve connettersi. Gli URL di account personalizzati non sono supportati.
• Accesso a un SQL warehouse in esecuzione.
• Autorizzazioni per leggere i dati dalle tabelle di Unity Catalog nell'area di lavoro.
• Una delle versioni seguenti di Excel:
  • Excel 2019 o versione successiva in Mac
  • Excel su Windows (Microsoft 365)
  • Excel sul web
  • Excel in Mac (Microsoft 365)
• Se si usa un firewall o una piattaforma di sicurezza cloud, consentire l'elenco degli URL dell'area di lavoro Azure Databricks inclusi nel file del componente aggiuntivo.

Configurare il file del componente aggiuntivo

Il file del componente aggiuntivo è un file connettore di piccole dimensioni che indica Excel esattamente come connettersi in modo sicuro a Azure Databricks. Funge da handshake digitale che garantisce che il componente aggiuntivo si carichi correttamente e resti aggiornato ogni volta che si apre Excel.

Scaricare e configurare il file del componente aggiuntivo per usare il componente aggiuntivo Azure Databricks Excel.

1. Aprire il file del componente aggiuntivo facendo clic sul collegamento seguente:

   File componente aggiuntivo Excel di Azure Databricks

2. Salvare la pagina come .xml file nel computer locale. Nella maggior parte dei browser fare clic con il pulsante destro del mouse sulla pagina e scegliere Salva come oppure premere Ctrl+S (Windows) o Command+S (macOS).

3. Modifica il file del componente aggiuntivo specificando l'URL dell'area di lavoro come <AppDomain> nella sezione AppDomains. L'URL dell'area di lavoro è l'URL di base usato per accedere all'area di lavoro Azure Databricks in un browser. Per passare da più aree di lavoro Azure Databricks, aggiungere ogni URL dell'area di lavoro al file del componente aggiuntivo.

   <AppDomains>
      <!-- DO NOT CHANGE -->
      <AppDomain>https://www.databricks.com</AppDomain>
      <AppDomain>https://login.databricks.com</AppDomain>
      <!-- ADD WORKSPACE URLS AS SHOWN BELOW; PUT EACH WORKSPACE URL IN ITS OWN <AppDomain> TAG  -->
      <!-- EXAMPLE -->
      // highlight-next-line
      <AppDomain>https://adb-<workspace1-id>.<random-number>.azuredatabricks.net</AppDomain>
      // highlight-next-line
      <AppDomain>https://adb-<workspace2-id>.<random-number>.azuredatabricks.net</AppDomain>
   </AppDomains>
   

   Annotazioni

   Incollare l'URL dell'area di lavoro come testo normale, senza formattazione. Nella maggior parte degli editor di testo usare Ctrl+Shift+V (Windows) o Command+Shift+V (macOS).

4. Salvare le modifiche. Verificare che il file sia formattato correttamente come .xml file.

Opzione 1: Gestito dall'amministratore

Gli amministratori globali possono distribuire il componente aggiuntivo Azure Databricks Excel agli utenti dell'organizzazione. È possibile distribuire il componente aggiuntivo come app personalizzata usando il file del componente aggiuntivo o installarlo da Microsoft Marketplace.

Per installare il componente aggiuntivo Azure Databricks Excel come Microsoft 365 Admin, è necessario disporre dell'autorizzazione global admin. Gli amministratori possono determinare quali utenti dell'organizzazione possono usare i componenti aggiuntivi. Per altre informazioni sugli amministratori globali su Microsoft 365, vedere la documentazione Microsoft.

Distribuire come app personalizzata

Distribuire il componente aggiuntivo usando un file manifesto personalizzato. Scaricare e configurare il file del componente aggiuntivo fornito in Prerequisiti.

1. Nella Microsoft 365 admin center passare a Impostazioni > App integrate e fare clic sul collegamento Aggiungi.
2. Fare clic su Distribuisci componente aggiuntivo e quindi su Avanti.
3. Fare clic su Carica app personalizzate come opzione per distribuire un nuovo componente aggiuntivo.
4. Selezionare l'opzione per caricare un manifesto. Fare clic su Scegli file e caricare il file del componente aggiuntivo.
5. Scegliere quali utenti devono avere accesso al componente aggiuntivo.
6. Fare clic su Distribuisci.

Per i passaggi dettagliati sul caricamento del componente aggiuntivo Azure Databricks Excel, vedere la documentazione di Microsoft.

Eseguire la distribuzione da Microsoft Marketplace

Installare il componente aggiuntivo dal marketplace Microsoft e usare PowerShell per configurare l'accesso all'area di lavoro.

Prerequisiti

• PowerShell è installato nel computer.
• È necessario eseguire Windows PowerShell come amministratore.

Installare il componente aggiuntivo

1. Nella Microsoft 365 admin center passare a Impostazioni > App integrate e fare clic sul collegamento Get Apps.
2. Cerca "Azure Databricks Componente aggiuntivo per Excel".
3. Fare clic su Scarica adesso.
4. Distribuire il componente aggiuntivo a se stessi selezionando Solo io in Assegna utenti (Assign Users).
5. Fare clic su Distribuisci.

Per i passaggi dettagliati sulla distribuzione del componente aggiuntivo Azure Databricks Excel da Microsoft Marketplace, vedere la documentazione Microsoft.

Configurare l'accesso all'area di lavoro

Dopo aver installato il componente aggiuntivo, usare PowerShell per mettere nella lista consentita gli URL dell'area di lavoro Azure Databricks.

1. Aprire PowerShell ed eseguire come amministratore. Per altre informazioni, vedere la documentazione Microsoft.

2. Installare e importare il modulo di distribuzione centralizzata Office 365:

   Install-Module -Name O365CentralizedAddInDeployment
   Import-Module O365CentralizedAddInDeployment
   

3. Connettersi e accedere al tenant Office 365 come amministratore:

   Connect-OrganizationAddInService
   

4. Verificare che il componente aggiuntivo sia stato distribuito. Il componente aggiuntivo Azure Databricks per Excel dovrebbe essere visualizzato nell'elenco.

   Get-OrganizationAddIn
   

   Se il componente aggiuntivo non viene visualizzato, potrebbe essere necessario ridistribuire o potrebbe essere ancora in fase di distribuzione.

5. Metti nella lista di permessi le URL dell'area di lavoro di Azure Databricks. Sostituire tutti i <workspace-url> con l'URL di un'area di lavoro che desideri consentire. È possibile includere tutti gli URL dell'area di lavoro necessari.

   Set-OrganizationAddInOverrides -ProductId d75dbea5-bf93-49b8-9a49-bdf4e9d6f052 `
     -AppDomains "https://adb-<workspace1-id>.<random-number>.azuredatabricks.net", "https://adb-<workspace2-id>.<random-number>.azuredatabricks.net"
   

   L'ID prodotto per Azure Databricks è d75dbea5-bf93-49b8-9a49-bdf4e9d6f052.

6. Confermare la corretta configurazione della lista di consentiti. Gli URL dell'area di lavoro consentiti devono essere visualizzati nella AppDomains sezione .

   Get-OrganizationAddInOverrides -ProductId d75dbea5-bf93-49b8-9a49-bdf4e9d6f052
   

Testare il componente aggiuntivo

1. In Excel trovare il componente aggiuntivo Azure Databricks.
2. Accedi e connettiti a uno degli spazi di lavoro che hai inserito nella lista di autorizzazione.

Distribuire nell'organizzazione

1. Nella Microsoft 365 admin center passare a Impostazioni > App integrate.
2. Selezionare il componente aggiuntivo Azure Databricks installato e configurato.
3. Fare clic sulla scheda Utenti e scegliere se eseguire la distribuzione nell'intera organizzazione o in un gruppo specifico di utenti.

Opzione 2: Servizio autonomo

I passaggi di installazione variano a seconda della piattaforma Excel. Scaricare e configurare il file del componente aggiuntivo fornito in Prerequisiti.

Excel per il web

Per installare e connettersi al componente aggiuntivo Excel Excel for the web eseguire le operazioni seguenti:

1. Aprire Excel for the web e creare o aprire una cartella di lavoro.
2. Nella scheda Home fare clic su Componenti aggiuntivi>avanzati.
3. Fare clic su Carica componente aggiuntivo.
4. Carica il file del componente aggiuntivo.
5. Fare clic su Carica.
6. Trovare e fare clic sul componente aggiuntivo Azure Databricks dal menu Aggiungi.
7. Accedi al tuo account Azure Databricks. Se si verifica un errore, assicurarsi di abilitare le finestre di dialogo popup.
8. Se sono stati configurati più URL dell'area di lavoro, selezionare il nome dell'account Azure Databricks desiderato. È sufficiente selezionare un'area di lavoro specifica se gli URL si trovano nello stesso account. Per ulteriori informazioni sui nomi degli account, vedere Trova il tuo ID account.

Excel Desktop (Windows)

Per installare il componente aggiuntivo Excel in Excel Desktop per Windows, eseguire i seguenti passaggi:

1. Creare una cartella denominata Manifest nell'unità locale, ad esempio C:\Manifest.
2. Copiare il file del componente aggiuntivo nella C:\Manifest cartella .
3. Aprire le proprietà della cartella e condividere la cartella:
   1. Fare clic con il pulsante destro del mouse sulla Manifest cartella e scegliere Proprietà.
   2. Fare clic su Condivisione>Condividi e aggiungi te stesso come utente con autorizzazioni di lettura e scrittura.
4. Aprire Excel Desktop.
5. Configurare Excel per considerare attendibile la cartella del manifesto:
   1. Fare clic sufile>Opzioni>Centro protezione>Impostazioni Centro protezione.
   2. Nella barra laterale fare clic su Cataloghi di componenti aggiuntivi attendibili.
   3. In URL catalogo immettere il percorso della cartella condivisa in cui si trova il file del componente aggiuntivo , ad esempio \\YourComputerName\Manifest.
   4. Fare clic su Aggiungi catalogo.
   5. Selezionare la casella di controllo Mostra nel menu .
   6. Fare clic su OK per salvare le modifiche.
6. Riavviare Excel Desktop.
7. Fare clic su Componenti aggiuntivi>Altri componenti aggiuntivi>Cartella condivisa.
8. Selezionare il connettore Azure Databricks e fare clic su Aggiungi.
9. Fare clic sul componente aggiuntivo Azure Databricks e completare il processo di accesso all'account Azure Databricks.
10. Se sono stati configurati più URL dell'area di lavoro, selezionare il nome dell'account Azure Databricks desiderato. È sufficiente selezionare un'area di lavoro specifica se gli URL si trovano nello stesso account. Per ulteriori informazioni sui nomi degli account, vedere Trova il tuo ID account.

Excel Desktop (macOS)

Per installare il componente aggiuntivo di Excel Desktop per macOS, seguire le operazioni seguenti:

1. Trova la cartella Microsoft Office Add-ins. Per impostazione predefinita, la directory è:

   /Users/<your-username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef
   

2. Copiare il file del componente aggiuntivo in questa cartella.

3. Aprire o riavviare Excel Desktop.

4. Nella barra di spostamento fare clic su Componenti aggiuntivi>I miei componenti aggiuntivi.

5. Fare clic sul componente aggiuntivo Azure Databricks.

6. Completare il processo di accesso all'account Azure Databricks.

7. Se sono stati configurati più URL dell'area di lavoro, selezionare il nome dell'account Azure Databricks desiderato. È sufficiente selezionare un'area di lavoro specifica se gli URL si trovano nello stesso account. Per ulteriori informazioni sui nomi degli account, vedere Trova il tuo ID account.

Accedere al componente aggiuntivo

Se un amministratore dell'organizzazione ha distribuito il componente aggiuntivo Azure Databricks Excel, accedere e connettersi all'area di lavoro Azure Databricks da Excel.

1. In Excel, nella scheda Home fare clic sul componente aggiuntivo Azure Databricks.
2. Immettere l'URL dell'area di lavoro o selezionare un URL dell'area di lavoro usato in precedenza dall'elenco a discesa. Il componente aggiuntivo memorizza gli URL dell'area di lavoro configurati dall'utente o dall'amministratore.
3. Fare clic su Accedi e completare il processo di autenticazione per ottenere l'accesso a tutte le funzionalità del componente aggiuntivo Azure Databricks Excel.

Modifica spazio di lavoro di Azure Databricks

Se il file del componente aggiuntivo specifica più aree di lavoro Azure Databricks, è possibile passare da un'area di lavoro all'altra. Per altre informazioni, vedere Configurare il file del componente aggiuntivo.

Per connettersi a un'area di lavoro Azure Databricks diversa, eseguire le operazioni seguenti:

1. In alto a destra del riquadro del componente aggiuntivo Azure Databricks fare clic sul menu a tre punti accanto al selettore di calcolo.
2. Fare clic su Cambia area di lavoro.
3. Seleziona l'account in cui si trova il tuo spazio di lavoro, l'area di lavoro se richiesto ed effettua l'accesso.

Risoluzione dei problemi

Messaggio "Autenticazione in corso" all'accesso

Se viene visualizzata una finestra "Autenticazione in corso" quando si tenta di accedere a Azure Databricks dal componente aggiuntivo, l'area di lavoro potrebbe non essere stata aggiunta correttamente al file del componente aggiuntivo personalizzato. Verificare di aver configurato correttamente l'area di lavoro in <AppDomains>.

Messaggio "Need admin approval" (Richiesta approvazione amministratore) all'accesso

Quando si accede all'area di lavoro di Azure Databricks dalla Excel add-in viene visualizzato il messaggio "Need admin approval" (È necessaria l'approvazione dell'amministratore) quando si accede all'area di lavoro Azure Databricks dall'Excel add-in perché il tenant Microsoft Entra blocca il consenso dell'utente per l'applicazione Azure Databricks. Se il consenso dell'amministratore non viene concesso, Microsoft Entra ID continua a bloccare il flusso di accesso anche se si dispone dell'accesso diretto all'area di lavoro.

Per risolvere questo problema, un utente Microsoft Entra con ruoli di amministratore appropriati deve concedere il consenso amministratore a livello di tenant all'applicazione aziendale Azure Databricks:

1. Nel Microsoft Entra admin center passare a Entra ID>Enterprise apps>Tutte le applicazioni e trovare l'applicazione aziendale Azure Databricks usata per l'accesso Single Sign-On.
2. Concedere il consenso amministratore per le autorizzazioni richieste dall'app aziendale Azure Databricks:
   1. In Sicurezza fare clic su Autorizzazioni.
   2. Fare clic su Concedi consenso amministratore.

Per istruzioni dettagliate, vedere la documentazione Microsoft.

Non è possibile usare le risorse

Se non è possibile usare le risorse di Azure Databricks, ad esempio SQL warehouses, nel componente aggiuntivo Azure Databricks, provare uno dei metodi seguenti, a seconda della versione di Excel in uso.

• Excel for the web: riavviare il foglio o modificare le aree di lavoro e accedere di nuovo alla stessa area di lavoro. Vedere Change Azure Databricks workspace.
• Excel Desktop: ricaricare il componente aggiuntivo facendo clic sull'icona delle informazioni nell'angolo superiore destro e selezionando Reload.

Passaggi successivi

• Importare ed eseguire query sui dati usando il componente aggiuntivo Azure Databricks Excel