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

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.

Você precisa download e configurar 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 download e configurar o suplemento Databricks Excel e implantá-lo para outros usuários da sua organização. Baixe e instale o arquivo complementar fornecido nos Pré-requisitos.

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 complementos. Para obter mais informações sobre administradores globais no Microsoft 365, consulte a documentação da Microsoft.

  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. Selecione a opção "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 workspace com os usuários que utilizam o suplemento Databricks Excel .

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.

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 "Autenticação em andamento"​

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

Próximos passos​