Configurar o suplemento do Azure Databricks para Excel

O suplemento Azure Databricks Excel conecta seu espaço de trabalho Azure Databricks ao Microsoft Excel, trazendo dados controlados do Lakehouse diretamente para suas planilhas para ajudá-lo a transformar dados em decisões mais rapidamente. O suplemento é totalmente compatível com o Excel para a web e com as versões de área de trabalho para ambos Windows e macOS.

Esta página descreve os dois métodos disponíveis para configurar o complemento Azure Databricks para o Microsoft Excel. Esse suplemento utiliza autenticação de logon único (SSO) para conectar-se ao workspace do Azure Databricks e oferece suporte ao Unity Catalog para governança de dados e controle de acesso.

Pré-requisitos

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

• Acesso a um workspace do Azure Databricks com o Unity Catalog habilitado.
• O URL do workspace do Azure Databricks para cada workspace ao qual o Excel deve se conectar. Não há suporte para URLs de conta personalizada.
• Acesso a um sql warehouse em execução.
• Permissões para ler dados de tabelas do Unity Catálogo em seu ambiente de trabalho.
• Uma das seguintes versões do Excel:
  • Excel 2019 ou posterior no Mac
  • Excel em Windows (Microsoft 365)
  • Excel na Web
  • Excel no Mac (Microsoft 365)
• Se você usar um firewall ou uma plataforma de segurança de nuvem, adicione os URLs do workspace do Azure Databricks à lista de permissões incluída no arquivo de suplemento.

Configurar o arquivo de suplemento

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

Baixe e configure o arquivo de suplemento para usar o suplemento Azure Databricks Excel.

1. Abra o arquivo de complemento clicando no seguinte link:

   arquivo do complemento do Azure Databricks Excel

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

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

   <AppDomains>
      <!-- DO NOT CHANGE -->
      <AppDomain>https://www.databricks.com</AppDomain>
      <AppDomain>https://login.databricks.com</AppDomain>
      <!-- ADD WORKSPACE URLS AS SHOWN BELOW; PUT EACH WORKSPACE URL IN ITS OWN <AppDomain> TAG  -->
      <!-- EXAMPLE -->
      // highlight-next-line
      <AppDomain>https://adb-<workspace1-id>.<random-number>.azuredatabricks.net</AppDomain>
      // highlight-next-line
      <AppDomain>https://adb-<workspace2-id>.<random-number>.azuredatabricks.net</AppDomain>
   </AppDomains>
   

   Observação

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

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

Opção 1: Gerenciado pelo administrador

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

Para instalar o suplemento Azure Databricks Excel, como 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 Microsoft.

Implantar como um aplicativo personalizado

Implante o complemento usando um arquivo de manifesto personalizado. Baixe e configure o arquivo de suplemento fornecido nos pré-requisitos.

1. No Microsoft 365 admin center, acesse Settings > aplicativos integrados e clique no link Add-ins.
2. Clique em Implantar Suplemento e clique em Avançar.
3. Clique em Carregar aplicativos personalizados como a opção para implantar um novo complemento.
4. Selecione a opção para carregar um manifesto. Clique em Escolher Arquivo e carregue o arquivo de complemento.
5. Escolha quais usuários devem ter acesso ao suplemento.
6. Clique em Implantar.

Para obter etapas detalhadas sobre como carregar o suplemento Azure Databricks Excel, consulte a documentação Microsoft.

Implantar do Microsoft Marketplace

Instale o suplemento do Microsoft Marketplace e use o PowerShell para configurar o acesso ao espaço de trabalho.

Pré-requisitos

• O PowerShell está instalado em seu computador.
• Você deve executar Windows PowerShell como administrador.

Instalar o suplemento

1. No Microsoft 365 admin center, acesse Settings > aplicativos integrados e clique no link Get Apps.
2. Pesquise por "Azure Databricks Add-in para Excel".
3. Clique em Obtê-lo agora.
4. Implante o suplemento para si mesmo selecionando Apenas eu em Atribuir Usuários.
5. Clique em Implantar.

Para obter etapas detalhadas sobre como implantar o suplemento Azure Databricks Excel do Microsoft Marketplace, consulte a documentação Microsoft.

Configurar o acesso ao workspace

Depois de instalar o suplemento, use o PowerShell para permitir na lista de permissões as URLs do workspace do Azure Databricks.

1. Abra o PowerShell e execute como administrador. Para obter mais informações, consulte a documentação Microsoft.

2. Instale e importe o módulo de implantação centralizado Office 365:

   Install-Module -Name O365CentralizedAddInDeployment
   Import-Module O365CentralizedAddInDeployment
   

3. Conecte-se e faça logon no locatário Office 365 como administrador:

   Connect-OrganizationAddInService
   

4. Confirme se o suplemento foi implantado. O suplemento Azure Databricks para Excel deve aparecer na lista.

   Get-OrganizationAddIn
   

   Se o suplemento não aparecer, talvez seja necessário reimplantar ou talvez ainda esteja sendo implantado.

5. Lista de permissões Azure Databricks URLs do workspace. Substitua cada <workspace-url> pela URL de um espaço de trabalho que você deseja permitir. Você pode incluir quantas URLs de workspace forem necessárias.

   Set-OrganizationAddInOverrides -ProductId d75dbea5-bf93-49b8-9a49-bdf4e9d6f052 `
     -AppDomains "https://adb-<workspace1-id>.<random-number>.azuredatabricks.net", "https://adb-<workspace2-id>.<random-number>.azuredatabricks.net"
   

   A ID do produto para Azure Databricks é d75dbea5-bf93-49b8-9a49-bdf4e9d6f052.

6. Confirme a lista de permissões correta. As URLs do workspace que você permitiu na lista devem aparecer na AppDomains seção.

   Get-OrganizationAddInOverrides -ProductId d75dbea5-bf93-49b8-9a49-bdf4e9d6f052
   

Testar o suplemento

1. Em Microsoft Excel, encontre o suplemento Azure Databricks.
2. Entre e conecte-se a um dos espaços de trabalho que você colocou na lista de permitidos.

Implantar em sua organização

1. No Microsoft 365 admin center, vá para Settings > aplicativos integrados.
2. Selecione o suplemento Azure Databricks que você instalou e configurou.
3. Clique na guia Usuários e escolha se deseja implantar em toda a sua organização ou em um grupo específico de usuários.

Opção 2: Autoatendimento

As etapas de instalação variam dependendo da plataforma Excel. Baixe e configure o arquivo de suplemento fornecido nos pré-requisitos.

Excel para a web

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

1. Abra Excel for the web e crie ou abra uma pasta de trabalho.
2. Na guia Página Inicial, clique em Suplementos>Avançado.
3. Clique em Carregar Meu Suplemento.
4. Carregue o arquivo de suplemento.
5. Clique em Carregar.
6. Encontre e clique no complemento Azure Databricks no menu Add-ins.
7. Entre em sua conta do Azure Databricks. Se houver um erro, habilite as caixas de diálogo pop-up.
8. Se você configurou várias URLs de workspace, selecione o nome da conta de Azure Databricks desejado. Você só precisará selecionar um workspace específico se as URLs estiverem dentro da mesma conta. Para obter mais informações sobre nomes de conta, consulte Localizar sua ID da conta.

Área de Trabalho do Excel (Windows)

Para instalar o complemento do Excel para Desktop no Windows, faça o seguinte:

1. Crie uma pasta nomeada Manifest em sua unidade local (por exemplo, C:\Manifest).
2. Copie o arquivo de suplemento para a C:\Manifest pasta.
3. Abra as propriedades da pasta e compartilhe a pasta:
   1. Clique com o botão direito do mouse na Manifest pasta e selecione Propriedades.
   2. Clique em Compartilhar>Compartilhamento e adicione-se como um usuário com permissões de leitura e gravação.
4. Abra Excel Desktop.
5. Configure Excel para confiar na pasta de manifesto:
   1. Clique em Arquivo>Opções>Central de Confiabilidade>Configurações da Central de Confiabilidade.
   2. Na barra lateral, clique em Catálogos de Suplementos Confiáveis.
   3. Na URL do Catálogo, insira o caminho para a pasta compartilhada em que o arquivo de suplemento está localizado (por exemplo, \\YourComputerName\Manifest).
   4. Clique em Adicionar catálogo.
   5. Marque a caixa de seleção Mostrar no Menu .
   6. Clique em OK para salvar suas alterações.
6. Reinicie Excel Desktop.
7. Clique em Suplementos>Mais Suplementos>Pasta Compartilhada.
8. Selecione o conector Azure Databricks e clique em Add.
9. Clique no Add-in do Azure Databricks e conclua o processo de entrada na sua conta do Azure Databricks.
10. Se você configurou várias URLs de workspace, selecione o nome da conta de Azure Databricks desejado. Você só precisará selecionar um workspace específico se as URLs estiverem dentro da mesma conta. Para obter mais informações sobre nomes de conta, consulte Localizar sua ID da conta.

Área de Trabalho do Excel (macOS)

Para instalar o suplemento do Excel no Excel Desktop para macOS, faça o seguinte:

1. Localize sua pasta do Microsoft Office Add-ins. Por padrão, o diretório é:

   /Users/<your-username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef
   

2. Copie o arquivo de complemento para esta pasta.

3. Abra ou reinicie Excel Desktop.

4. Na barra de navegação, clique em Suplementos>Meus Suplementos.

5. Clique no complemento Azure Databricks.

6. Conclua o processo de entrada em sua conta Azure Databricks.

7. Se você configurou várias URLs de workspace, selecione o nome da conta de Azure Databricks desejado. Você só precisará selecionar um workspace específico se as URLs estiverem dentro da mesma conta. Para obter mais informações sobre nomes de conta, consulte Localizar sua ID da conta.

Entrar no complemento

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

1. Em Excel, na guia Página Inicial, clique no Suplemento Azure Databricks.
2. Insira a URL do workspace ou selecione uma URL do workspace usada anteriormente na lista suspensa. O complemento lembra as URLs do workspace configuradas por você ou pelo administrador.
3. Clique em Sign in e conclua o processo de autenticação para obter acesso a todos os recursos do Suplemento Azure Databricks Excel.

Alterar espaço de trabalho do Azure Databricks

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

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

1. No canto superior à direita do painel de complemento do Azure Databricks, clique no menu de três pontos ao lado do seletor de computação.
2. Clique Alterar área de trabalho.
3. Selecione a conta na qual o workspace está localizado, o workspace, se solicitado, e faça login.

Solução de problemas

Mensagem "Autenticação em andamento" no logon

Se você vir uma janela "Autenticação em andamento" ao tentar fazer login no Azure Databricks pelo suplemento, é possível que o seu workspace não tenha sido corretamente adicionado ao arquivo de suplemento personalizado. Verifique se você configurou corretamente o seu ambiente de trabalho sob <AppDomains>.

Mensagem "Precisa de aprovação do administrador" no logon

A mensagem "Precisa de aprovação do administrador" a seguir é exibida quando você faz logon no workspace do Azure Databricks a partir do complemento do Excel porque o tenant do Microsoft Entra está impedindo o consentimento do usuário para o aplicativo Azure Databricks. Se o consentimento do administrador não for concedido, Microsoft Entra ID continuará bloqueando o fluxo de logon mesmo se você tiver acesso direto ao workspace.

Para resolver isso, um usuário Microsoft Entra com funções de administrador apropriadas deve conceder consentimento de administrador em todo o locatário ao aplicativo Azure Databricks empresarial:

1. No Microsoft Entra admin center, acesse Entra ID>Enterprise apps>All applications e localize o aplicativo empresarial Azure Databricks usado para logon único.
2. Conceda consentimento do administrador para as permissões solicitadas pelo Azure Databricks aplicativo empresarial:
   1. Em Segurança, clique em Permissões.
   2. Clique em Conceder consentimento do administrador.

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

Não é possível usar recursos

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

• Excel for the web: reinicie a planilha ou altere os workspaces e faça logon novamente no mesmo workspace. Consulte Alterar espaço de trabalho do Azure Databricks.
• Excel Desktop: recarregue o suplemento clicando no ícone de informações no canto superior direito e selecionando Reload.

Próximas Etapas 

• Importar e consultar dados usando o complemento Azure Databricks para Excel