Configure o suplemento do Databricks para Excel.
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.
- 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.
-
Clique no link a seguir para download o arquivo instantaneamente:
-
Edite o arquivo de suplemento especificando o URL do seuworkspace como um
<AppDomain>dentro da seçãoAppDomains. 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>
Cole o URL do seu workspace como texto simples (sem formatação) pressionando Ctrl+Shift+V ou Command+Shift+V.
- Salve o arquivo. Verifique se 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.
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.
o passo 1: registrar o add-in
Os administradores do escritório devem primeiro adicionar o suplemento ao tenant para registrar o ID do produto no centro de administração.
- No centro de administração do Microsoft 365, acesse Configurações > Aplicativos integrados e clique no link Suplementos .
- Clique em "Inserir suplemento" e clique em "Avançar" .
- Selecione a opção "Carregar aplicativos personalizados" para implantar um novo complemento.
- Selecione a opção para upload um manifesto, clique em Escolher arquivo e upload o arquivo do complemento.
- Na página Configurar suplemento , em Atribuir usuários, selecione Somente eu .
- Clique em Implantar para concluir o cadastro inicial.
o passo 2: Configurar domínios de workspace
Configura os URLs workspace como AppDomains:
-
Instale o Microsoft PowerShell, caso ainda não esteja instalado.
-
Instale o módulo Microsoft PowerShell
O365CentralizedAddInDeployment. -
Abra PowerShell e conecte-se ao seu tenant do Office 365:
PowerShellConnect-OrganizationAddInService -
Inicie sessão com a sua conta de administrador do Microsoft 365.
-
Registre todos os domínios workspace executando o seguinte comando:
PowerShellSet-OrganizationAddInOverrides -ProductId 8a512e2b-c04e-4c06-9235-11b6cd59f584 -AppDomains "[https://workspace-1.databricks.com](https://workspace-1.databricks.com)", "[https://workspace-2.databricks.com](https://workspace-2.databricks.com)", "[https://workspace-3.databricks.com](https://workspace-3.databricks.com)", "[https://workspace-4.databricks.com](https://workspace-4.databricks.com)"
o passo 3: implantado na organização
Após configurar os domínios, atribua o suplemento a outros usuários da sua organização.
- Retorne à página Configurações > Aplicativos integrados > Suplementos no centro de administração do Microsoft 365.
- Selecione o suplemento Databricks na lista.
- Edite os usuários atribuídos.
- Altere a atribuição de "Somente eu" para "Usuários/grupos específicos" ou selecione "Organização inteira" .
- Clique em Salvar.
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.
- Excel for the web
- Excel Desktop (Windows)
- Excel Desktop (macOS)
Para instalar e conectar o suplemento do Excel no Excel para a Web, faça o seguinte:
- Abra o Excel para a Web e crie ou abra uma pasta de trabalho.
- Na tab Início, clique em Complementos > Avançado .
- Clique em "Carregar meu suplemento" .
- Faça o upload do arquivo complementar.
- Clique em "Enviar" .
- Localize e clique no suplemento Databricks no menu Suplementos .
- Faça login na sua account Databricks . Caso ocorra algum erro, certifique-se de ativar as janelas pop-up.
- 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.
Para instalar o suplemento do Excel no Excel Desktop para Windows, faça o seguinte:
-
Crie uma pasta chamada
Manifestem sua unidade local (por exemplo,C:\Manifest). -
Copie o arquivo de complemento para a pasta
C:\Manifest. -
Abra as propriedades da pasta e compartilhe-a:
- Clique com o botão direito do mouse na pasta
Manifeste selecione Propriedades . - Clique em Compartilhar > Compartilhar e adicione-se como um usuário com permissões de leitura e gravação.
- Clique com o botão direito do mouse na pasta
-
Abra o Excel Desktop.
-
Configure o Excel para confiar na pasta de manifestos:
- Clique em Arquivo > Opções > Central de Confiabilidade > Configurações da Central de Confiabilidade .
- Na barra lateral, clique em Catálogos de suplementos confiáveis .
- Em URL do catálogo , insira o caminho para a pasta compartilhada onde o arquivo do suplemento está localizado (por exemplo,
C:\\YourComputerName\Manifest). - Clique em Adicionar catálogo .
- Selecione a caixa de seleção "Mostrar no menu" .
- Clique em OK para salvar as alterações.
-
Reinicie o Excel Desktop.
-
Clique em Complementos > Mais Complementos > Pasta Compartilhada .
-
Selecione o conector Databricks e clique em Adicionar .
-
Clique no complemento Databricks e conclua o processo de login na sua account Databricks .
-
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.
Para instalar o suplemento do Excel no Excel Desktop para macOS, faça o seguinte:
-
Localize a pasta de suplementos do Microsoft Office. Por default, o diretório é:
/Users/<your-username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef -
Copie o arquivo complementar para esta pasta.
-
Abra ou reinicie o Excel Desktop.
-
Na barra de navegação, clique em Complementos > Meus Complementos .
-
Clique no suplemento Databricks.
-
Conclua o processo de login na sua account Databricks .
-
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:
- No canto superior direito do painel do suplemento Databricks , clique no menu de três pontos ao lado do seletor compute .
- Clique em Alterar workspace .
- Selecione a account na qual seu workspace está localizado, o workspace , se solicitado, e faça login.