Pular para o conteúdo principal
Última atualização em

Configure o suplemento do Databricks para Excel

O suplemento do Databricks para Excel conecta o workspace do Databricks ao Microsoft Excel, trazendo dados governados do Lakehouse diretamente para suas planilhas. O suplemento é totalmente compatível com o Excel para a web e versões para desktop para Windows e macOS.

This page describes the two methods available to set up the Databricks Excel Add-in in Microsoft Excel. This add-in uses single sign-on (SSO) authentication to connect to your Databricks workspace and supports Unity Catalog for governança de dados and access control.

Prerequisites​

Antes de instalar o suplemento do Excel, verifique se você tem o seguinte:

  • Acesso a um workspace do Databricks com o Unity Catalog habilitado.

  • Certifique-se de que um administrador do workspace tenha ativado a visualização do Excel Connector . Consulte Gerenciar prévias do Databricks.

  • Sua URL do workspace da Databricks para cada workspace ao qual o Excel deve se conectar.

  • Você tem acesso ao Databricks SQL e pelo menos a permissão CAN USE em um SQL warehouse.

  • Permissões para ler dados de tabelas do Unity Catalog no seu workspace.

  • Uma das seguintes versões do Excel:

    • Excel 2019 ou posterior no Mac
    • Excel on Windows (Microsoft 365)
    • Excel na web
    • Excel no Mac (Microsoft 365)

  • Se você usar um firewall ou uma plataforma de segurança em cloud, adicione à lista de permissões as URLs do workspace do Databricks incluídas no arquivo do suplemento.

  • Se o seu tenant do Microsoft Entra bloquear o consentimento do usuário para aplicativos de terceiros, um administrador do Microsoft Entra deverá conceder o consentimento de administrador ao aplicativo corporativo de single sign-on do Databricks antes que os usuários possam fazer login com o seletor de contas. Isso não será necessário se os usuários fizerem login inserindo diretamente uma URL do workspace. Consulte "Need admin approval" message on log in.

Configure o arquivo de suplemento​

nota

Se você for um administrador implantando o suplemento por meio do Microsoft Marketplace, ignore esta seção. A implantação do marketplace usa o PowerShell para configurar o acesso ao workspace em vez do arquivo de suplemento. Consulte Deploy through Microsoft Marketplace.

O arquivo de suplemento é um pequeno arquivo de conector que indica ao Excel como se conectar com segurança ao Databricks. Ele atua como o handshake digital que garante que o suplemento seja carregado corretamente e permaneça atualizado sempre que você abrir o Excel.

Download e configure o arquivo de suplemento para usar o suplemento do Databricks para Excel. Um único arquivo de suplemento pode se conectar a vários Workspace do Databricks.

  1. Download o arquivo do suplemento do Databricks para Excel:

Download the Excel add-in file

  1. Edit the add-in file by specifying your workspace URL as an <AppDomain> within the AppDomains section. Your workspace URL is the base URL you use to access your Databricks workspace in a browser. To switch between multiple Databricks workspaces, add each workspace URL to the add-in file.

    Para fazer login com um URL personalizado, adicione o URL personalizado e o URL de workspace associado como entradas <AppDomain> separadas, conforme mostrado nos exemplos a seguir. O login pode redirecionar para qualquer um dos URLs.

    XML
    <AppDomains>
       
       <AppDomain>https://www.databricks.com</AppDomain>
       <AppDomain>https://login.databricks.com</AppDomain>
       
       
       <AppDomain>https://<instance1-id>.<region>.gcp.databricks.com</AppDomain>
       <AppDomain>https://<instance2-id>.<region>.gcp.databricks.com</AppDomain>
       
       <AppDomain>https://<custom-url>.databricks.com</AppDomain>
    </AppDomains>
nota

Cole a URL do seu workspace como texto sem formatação, sem formatação. Na maioria dos editores de texto, use Ctrl+Shift+V (Windows) ou Command+Shift+V (macOS).

  1. Salve suas alterações. Verifique se o arquivo está formatado corretamente como um arquivo .xml.

Opção 1: Implantar no centro de administração do Microsoft 365​

Como administrador global, você pode implantar o suplemento do Excel para Databricks para os usuários em sua organização. Você pode implantar o suplemento como um aplicativo personalizado usando o arquivo de suplemento ou instalá-lo a partir do Microsoft Marketplace.

Para instalar o suplemento do Databricks Excel como um administrador do Microsoft 365, você deve ter a permissão global admin. Como administrador, você pode determinar quais usuários em sua organização podem usar suplementos. Para obter mais informações sobre administradores globais no Microsoft 365, consulte a documentação da Microsoft.

Acesse o centro de administração do Microsoft 365 aqui.

nota

A Databricks recomenda implantar o suplemento do Databricks para Excel como um aplicativo personalizado.

Implante o suplemento usando um arquivo de manifesto personalizado. Download e configure o arquivo de suplemento fornecido em Pré-requisitos.

  1. In the Microsoft 365 admin center, go to Settings > Integrated apps and click the Add-ins link.
  2. Click Deploy Add-in and click Next .
  3. Click upload custom apps as the option para que um novo add-in seja implantado.
  4. Select the option to upload a manifest. Click Choose File and upload the add-in file.
  5. Escolha quais usuários devem ter acesso ao suplemento.
  6. Clique em Deploy .

Para obter os passos detalhados sobre o upload do suplemento do Databricks para Excel, consulte a documentação da Microsoft.

nota

Como administrador, compartilhe o nome da account associado aos Workspace que você colocou na lista de permissões com os usuários que planejam usar o suplemento do Databricks para Excel. Consulte Faça login no suplemento.

Opção 2: implantar como um usuário individual​

Os passos de instalação variam dependendo da sua plataforma do Excel. Download e configure o arquivo de suplemento fornecido em Pré-requisitos.

Para instalar e conectar-se ao suplemento do Excel no Excel para a web, faça o seguinte:

  1. Abra o Excel para a Web e crie ou abra uma pasta de trabalho.
  2. Under the Home tab, click Add-ins > Advanced .
  3. Clique em Upload My Add-in .
  4. Faça upload do arquivo de suplemento.
  5. Clique em Upload .
  6. Localize e clique no suplemento do Databricks no menu Suplementos .
  7. Faça login na sua account do Databricks. Se houver um erro, certifique-se de habilitar caixas de diálogo pop-up.
  8. Se você configurou vários URLs de workspace, selecione o nome da account do Databricks desejada. Você só precisa selecionar um workspace específico se os URLs estiverem dentro da mesma account. Para obter mais informações sobre os nomes de account, consulte Localize o ID da sua account.

Faça login no suplemento​

Se um administrador em sua organização tiver implantado o suplemento do Databricks para Excel, faça login e conecte-se ao seu workspace do Databricks a partir do Excel.

  1. No Excel, na tab Home, clique no suplemento do Databricks.

  2. Na primeira vez que você fizer login, conecte-se a um workspace usando uma das seguintes opções:

    • Insira um URL do workspace (recomendado) : insira seu URL do workspace do Databricks. Esta opção faz login usando o SSO do workspace. Para fazer login com um URL personalizado, verifique se tanto o URL personalizado quanto o URL do workspace associado foram adicionados ao arquivo do suplemento. Consulte Configurar o arquivo do suplemento.
    • Use o seletor de account : clique em Selecionar seletor de account para abrir login.databricks.com e, em seguida, selecione uma account e um Workspace permitidos.

  3. Clique em Sign in e conclua o processo de autenticação para obter acesso ao suplemento do Databricks para Excel.

Após o primeiro login, o suplemento memoriza seus Workspace. Em logins futuros, selecione um workspace no menu suspenso ou use uma das opções acima para se conectar a um workspace diferente.

Se você usar a autenticação do Microsoft Entra ID e a mensagem "Need admin approval" aparecer, um administrador do Microsoft Entra deverá aprovar o aplicativo corporativo do Databricks para que você possa fazer login. Consulte "Need admin approval" message on log in.

Alterar o workspace do Databricks​

Se o arquivo do seu suplemento especificar vários Workspace do Databricks, você poderá alternar entre esses Workspace. Para obter mais informações, consulte Configurar o arquivo do suplemento.

Para se conectar a um workspace do Databricks diferente, faça o seguinte:

  1. In the upper-right of the Databricks Add-in pane, click the three-dot menu next to the compute selector.
  2. Clique em Alterar workspace .
  3. Selecione a account em que seu workspace está, o workspace se for solicitado e faça login.

Solução de problemas​

"Authentication in progress" message on log in​

Se você vir a janela "Authentication in progress" ao tentar fazer log in no Databricks a partir do suplemento, talvez o seu workspace não tenha sido adicionado corretamente ao arquivo de suplemento personalizado. Verifique se você configurou o seu workspace corretamente em <AppDomains>.

Mensagem "Need admin approval" no log in​

A seguinte mensagem "Need admin approval" aparece quando você faz log in no seu workspace do Databricks a partir do suplemento do Excel porque o tenant do Microsoft Entra está bloqueando o consentimento do usuário para o aplicativo Databricks. Isso se aplica apenas quando você faz login com o seletor de account (login.databricks.com); para evitar isso, insira o URL do seu workspace diretamente ao fazer login. Se o consentimento do administrador não for concedido, o Microsoft Entra ID continuará bloqueando o fluxo de login, mesmo que você tenha acesso direto ao workspace.

Mensagem de necessidade de aprovação do administrador no suplemento do Excel

To resolve this, a Microsoft Entra user with appropriate administrator roles must grant tenant-wide administrator consent to the Databricks enterprise application.

Peça ao administrador do Microsoft Entra que visite o seguinte link. Substitua {TENANT_ID} pelo ID do tenant do Microsoft Entra:

Text
https://login.microsoftonline.com/{TENANT_ID}/adminconsent?client_id=aaec40b0-c0ae-4211-a98b-6fc160abb71b

Se o link falhar, o administrador poderá conceder consentimento manualmente:

  1. No Microsoft Entra admin center, vá para Entra ID > Enterprise apps > All applications e localize o aplicativo corporativo do Databricks usado para o single sign-on. Para identificar o aplicativo, procure pela Application ID aaec40b0-c0ae-4211-a98b-6fc160abb71b.
  2. Conceda o consentimento do administrador para as permissões solicitadas pelo aplicativo corporativo do Databricks:
    1. Em Segurança , clique em Permissões .
    2. Clique em Grant admin consent .

For detailed instructions, see the Microsoft documentation.

Não é possível usar recursos​

Se você não conseguir usar os recursos do Databricks, como SQL warehouses, no suplemento do Databricks, tente um dos seguintes métodos, dependendo da versão do Excel que você está usando:

  • Excel for the web : reinicie a planilha ou altere os Workspace e faça log in novamente no mesmo Workspace. Consulte Alterar o workspace do Databricks.
  • Excel Desktop : recarregue o suplemento clicando no ícone de informação no canto superior direito e selecionando Recarregar .

Próximos os passos​

Nesta página