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

Configure o suplemento do Databricks para Excel.

info

Visualização

Este recurso está em Pré-visualização Pública.

O suplemento Databricks Excel conecta seu workspace Databricks ao Microsoft Excel, trazendo dados gerenciados de casas à beira de lagos diretamente para suas planilhas, ajudando você a transformar dados em decisões mais rapidamente. O suplemento é totalmente compatível com as versões do Excel para a Web e para desktop, tanto para Windows quanto para macOS.

Esta página descreve os dois métodos disponíveis para configurar o suplemento Databricks para Excel no Microsoft Excel. Este complemento utiliza autenticação de login único (SSO) para conectar-se ao seu workspace Databricks e é compatível com Unity Catalog para governança de dados e controle de acesso.

Pré-requisitos​

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

  • Acesso a um workspace Databricks com Unity Catalog ativado.

  • Um administrador workspace deve ativar a pré-visualização do conectorExcel . Veja as prévias do Gerenciador Databricks.

  • O URL do seuworkspace Databricks para cada workspace ao qual Excel deve se conectar. URLs account personalizadas não são suportadas.

  • Você tem acesso ao Databricks SQL e, no mínimo, permissão PODE USAR em um SQL warehouse.

  • Permissões para ler dados das tabelas Unity Catalog em seu workspace.

  • Uma das seguintes versões do Excel:

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

  • Se você utiliza um firewall ou uma plataforma de segurança cloud , adicione à lista de permissões os URLs workspace Databricks incluídos no arquivo do complemento.

  • 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 administrativo ao aplicativo corporativo de logon único do Databricks antes que os usuários possam fazer login. Veja a mensagem "É necessária a aprovação do administrador" ao log in.

Configure o arquivo de suplemento.​

nota

Se você for um administrador que implantou o suplemento por meio do Microsoft Marketplace, ignore esta seção. A implementação marketplace usa PowerShell para configurar o acesso workspace em vez do arquivo de suplemento. Veja implantado através do marketplace Microsoft.

O arquivo de suplemento é um pequeno arquivo conector que informa ao Excel como se conectar com segurança ao Databricks. Funciona como o aperto de mão digital que garante que o suplemento seja carregado corretamente e permaneça atualizado sempre que você abrir o Excel.

Baixe e instale o arquivo de suplemento para usar o suplemento Databricks Excel .

A Databricks recomenda o uso do manifesto multi-workspace para que se possa ter um manifesto consolidado. Mas, se você é um cliente AWS GovCloud ou não puder usar login.databricks.com porque não tem o SSO em nível de conta configurado, então você deve usar o método de manifesto de workspace único.

  1. Faça o download do arquivo de suplemento do Excel do Databricks:

Baixe o arquivo de suplemento do Excel.

  1. Edite o arquivo de suplemento especificando o URL do seuworkspace como um <AppDomain> dentro da seção AppDomains . O URL do seu workspace é o URL base que você usa para acessar seu workspace Databricks em um navegador. Para alternar entre vários espaços de trabalho Databricks , adicione o URL de cada workspace ao arquivo de complemento.

    XML
    <AppDomains>
       
       <AppDomain>https://www.databricks.com</AppDomain>
       <AppDomain>https://login.databricks.com</AppDomain>
       
       
       <AppDomain>https://<workspace1-id>.cloud.databricks.com</AppDomain>
       <AppDomain>https://<workspace2-id>.cloud.databricks.com</AppDomain>
    </AppDomains>
nota

Cole o URL do seu workspace como texto simples, 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: Gerenciamento administrativo​

Como administrador global, você pode implantar o suplemento Databricks Excel para os usuários da 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 Databricks Excel como administrador do Microsoft 365, você deve ter a permissão global admin . Como administrador, você pode determinar quais usuários da sua organização podem usar suplementos. Para obter mais informações sobre administradores globais no Microsoft 365, consulte a documentação da Microsoft.

nota

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

Implantei o complemento usando um arquivo de manifesto personalizado. Baixe e instale o arquivo complementar fornecido nos Pré-requisitos.

  1. No centro de administração do Microsoft 365, acesse Configurações > Aplicativos integrados e clique no link Suplementos .
  2. Clique em "Inserir suplemento" e clique em "Avançar" .
  3. Clique em "Carregar aplicativos personalizados" para implantar um novo complemento.
  4. Selecione a opção para upload um manifesto. Clique em Escolher arquivo e upload o arquivo do suplemento.
  5. Escolha quais usuários devem ter acesso ao suplemento.
  6. Clique em implantar .

Para obter instruções detalhadas sobre como carregar o suplemento Databricks Excel , consulte a documentaçãoMicrosoft.

nota

Como administrador, compartilhe o nome account associada ao espaço de trabalho que você adicionou à lista de permissões com os usuários que planejam usar o suplemento do Databricks Excel . Consulte Entrar no suplemento.

Opção 2: Auto-serviço​

Os passos de instalação variam dependendo da sua plataforma Excel . Baixe e instale o arquivo complementar fornecido nos Pré-requisitos.

Para instalar e conectar o 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. Na tab Início, clique em Complementos > Avançado .
  3. Clique em "Carregar meu suplemento" .
  4. Faça o upload do arquivo complementar.
  5. Clique em "Enviar" .
  6. Localize e clique no suplemento Databricks no menu Suplementos .
  7. Faça login na sua account Databricks . Caso ocorra algum erro, certifique-se de ativar as janelas pop-up.
  8. Se você configurou vários URLs workspace , selecione o nome account Databricks desejada. Você só precisa selecionar um workspace específico se os URLs estiverem dentro da mesma account. Para obter mais informações sobre nomes account , consulte Localizar o ID da sua account.

Faça login no suplemento.​

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

  1. No Excel, na tab Inicial, clique no suplemento Databricks .
  2. Insira o URL do seuworkspace ou selecione um URL workspace usado anteriormente no menu suspenso. O suplemento memoriza os URLs workspace que você ou seu administrador configuraram.
  3. Clique em "Entrar" e conclua o processo de autenticação para obter acesso a todos os recursos do suplemento Databricks Excel .

Alterar workspace Databricks​

Se o seu arquivo de complemento especificar vários espaços de trabalho Databricks , você poderá alternar entre eles. Para obter mais informações, consulte Configurar o arquivo de suplemento.

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

  1. No canto superior direito do painel do suplemento Databricks , clique no menu de três pontos ao lado do seletor compute .
  2. Clique em Alterar workspace .
  3. Selecione a account na qual seu workspace está localizado, o workspace , se solicitado, e faça login.

Solução de problemas​

Mensagem "Autenticação em andamento" ao log in​

Se você vir uma janela "Autenticação em andamento" ao tentar log in no Databricks a partir do complemento, seu workspace pode não ter sido adicionado corretamente ao arquivo de complemento personalizado. Verifique se você configurou seu workspace corretamente em <AppDomains>.

Mensagem "É necessária a aprovação do administrador" ao log in​

A seguinte mensagem "Aprovação do administrador é necessária" aparece quando você log in no seu workspace Databricks a partir do suplemento do Excel porque o tenant Microsoft Entra está bloqueando o consentimento do usuário para o aplicativo Databricks . Caso o consentimento do administrador não seja concedido, Microsoft Entra ID continuará bloqueando o fluxo de login, mesmo que você tenha acesso direto workspace .

nota

Este problema afeta o aplicativo de área de trabalho do Excel na versão de junho de 2026.

É necessária uma mensagem de aprovação do administrador no suplemento do Excel.

Para resolver isso, um usuário do Microsoft Entra com as funções de administrador apropriadas deve conceder consentimento de administrador para todo o locatário ao aplicativo corporativo Databricks.

Solicite ao administrador do Microsoft Entra que visite o seguinte link. Substitua {TENANT_ID} por seu ID de 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 pode conceder o consentimento manualmente.

  1. No centro de administração do Microsoft Entra, acesse Entra ID > Aplicativos Empresariais > Todos os aplicativos e localize o aplicativo empresarial Databricks usado para logon único. Para identificar o aplicativo, pesquise pela ID do Aplicativo aaec40b0-c0ae-4211-a98b-6fc160abb71b.
  2. Conceda o consentimento do administrador para as permissões solicitadas pelo aplicativo Databricks Enterprise:
    1. Em Segurança , clique em Permissões .
    2. Clique em "Conceder consentimento de administrador" .

Para obter instruções detalhadas, consulte a documentação da Microsoft.

Erro do suplemento​

O seguinte erro pode aparecer ao autenticar seu workspace:

Text
ADD-IN ERROR

This add-in could not be started. Close this dialog to ignore the problem or click "Restart" to try again.

Se clicar em Reiniciar não funcionar, tente o seguinte:

  1. Clique com o botão direito na janela de autenticação e clique em Inspecionar .
  2. Feche a janela DevTools .
  3. Clique com o botão direito na janela de autenticação e clique em refresh .

O painel do suplemento do Databricks Excel deve carregar.

Solução alternativa de Inspecionar e refresh para o erro de startup do suplemento do Excel.

Não foi possível usar o recurso​

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

  • Excel para a Web : Reinicie a planilha ou altere o espaço de trabalho e log novamente no mesmo workspace. Consulte Alterar workspace Databricks.
  • Excel Desktop : Recarregue o suplemento clicando no ícone de informações no canto superior direito e selecionando Recarregar .

Próximos passos​

Nesta página