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.

  • Acesso a um SQL warehouse em execução.

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

  • Você está usando 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.

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 via Microsoft Marketplace.

O arquivo de suplemento é um pequeno arquivo de conexão que informa ao Excel exatamente como se conectar ao Databricks de forma segura. Ele funciona como um aperto de mãos 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 .

  1. Abra o arquivo do suplemento clicando no seguinte link:

    Arquivo de suplemento do Databricks para Excel

  2. Salve a página como um arquivo .xml em sua máquina local. Na maioria dos navegadores, clique com o botão direito do mouse na página e selecione Salvar como , ou pressione Ctrl+S (Windows) ou Command+S (macOS).

  3. 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://<instance1-id>.<region>.gcp.databricks.com</AppDomain>
       <AppDomain>https://<instance2-id>.<region>.gcp.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.

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

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​