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.

nota

O suplemento Databricks para Excel não está disponível no AWS GovCloud nem no AWS GovCloud DoD.

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.

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

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

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

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 .

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

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

  1. No centro de administração do Microsoft Entra, acesse ID do Entra > Aplicativos corporativos > Todos os aplicativos e localize o aplicativo corporativo Databricks usado para logon único.
  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.

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