Configurare il componente aggiuntivo Azure Databricks Excel

Il componente aggiuntivo Azure Databricks Excel connette l'area di lavoro di Azure Databricks a Microsoft Excel, portando i dati di Lakehouse regolati direttamente nei fogli di calcolo per facilitare lo spostamento dai dati alle decisioni più velocemente. Il componente aggiuntivo è completamente supportato in Excel per le versioni Web e desktop per Windows e macOS.

Questa pagina descrive i due metodi disponibili per configurare il componente aggiuntivo Azure Databricks Excel in Microsoft Excel. Questo componente aggiuntivo usa l'autenticazione Single Sign-On (SSO) per connettersi all'area di lavoro di 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 di Azure Databricks con Unity Catalog abilitato.
• Accesso a un SQL warehouse in esecuzione.
• Autorizzazioni per leggere i dati dalle tabelle di Unity Catalog nell'area di lavoro.
• Si usa una delle versioni seguenti di Excel:
  • Excel 2019 o versione successiva in Mac
  • Excel in 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 di Azure Databricks inclusi nel file del componente aggiuntivo.

Configurare il file del componente aggiuntivo

Il file dell'add-in è un piccolo file di connettore che indica a Excel esattamente come connettersi in modo sicuro ad Azure Databricks. Funge da handshake digitale che garantisce che il componente aggiuntivo venga caricato correttamente e rimanga 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 del componente aggiuntivo di Azure Databricks Excel

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 con nome 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 di Azure Databricks in un browser. Per passare da più aree di lavoro di 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 amministratore di Microsoft 365, è 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 in 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. Nell'interfaccia di amministrazione di Microsoft 365 passare a Impostazioni > App integrate e fare clic sul collegamento Componenti aggiuntivi .
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 Microsoft.

Distribuzione da Microsoft Marketplace

Installare il componente aggiuntivo da Microsoft Marketplace 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. Nell'interfaccia di amministrazione di Microsoft 365 passare a Impostazioni > App integrate e fare clic sul collegamento Recupera app .
2. Ricerca "Componente aggiuntivo di Azure Databricks 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 inserire nella lista consentita gli URL dell'area di lavoro di Azure Databricks.

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

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

   Install-Module -Name O365CentralizedAddInDeployment
   Import-Module O365CentralizedAddInDeployment
   

3. Connettersi e accedere al tenant di 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. Consenti gli 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. Nell'interfaccia di amministrazione di Microsoft 365 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 in Excel per il Web, eseguire le operazioni seguenti:

1. Aprire Excel per il 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 Componenti aggiuntivi .
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 le operazioni seguenti:

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 Excel in Excel Desktop per macOS, eseguire le operazioni seguenti:

1. Trovare la cartella Componenti aggiuntivi di Microsoft Office. 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 di 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 Di Azure Databricks Excel.

Modificare l'area di lavoro di Azure Databricks

Se il file del componente aggiuntivo specifica più aree di lavoro di 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 di Azure Databricks diversa, eseguire le operazioni seguenti:

1. Nell'angolo in alto a destra del riquadro Componente Aggiuntivo Azure Databricks, clicca 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 ad 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>.

Non è possibile usare le risorse

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

• Excel per il Web: riavviare il foglio o modificare le aree di lavoro e accedere di nuovo alla stessa area di lavoro. Vedere Modificare l'area di lavoro di Azure Databricks.
• Excel Desktop: ricaricare il componente aggiuntivo facendo clic sull'icona delle informazioni nell'angolo superiore destro e selezionando Ricarica.

Passaggi successivi

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