Importar e consultar uso de dados com o suplemento Databricks Excel

info

Visualização

Este recurso está em Pré-visualização Pública.

O suplemento do Databricks para Excel conecta seu workspace do Databricks ao Microsoft Excel, trazendo dados governados do Lakehouse diretamente para suas planilhas.

Esta página descreve como usar o suplemento Databricks para Excel para importar e analisar dados do Databricks no Excel. Você pode navegar e importar tabelas do Databricks por meio de uma interface intuitiva, sem necessidade de conhecimento em SQL. Embora o complemento ofereça a flexibilidade de executar consultas SQL personalizadas, isso é opcional.

nota

No GovCloud, você pode importar dados apenas com funções personalizadas. Os outros métodos de importação não estão disponíveis.

Pré-requisitos

• Antes de usar o suplemento do Excel, verifique se ele está configurado corretamente.
• Você tem acesso ao Databricks SQL e pelo menos a permissão CAN USE em um SQL warehouse.

Selecione um SQL warehouse

Escolha qual SQL warehouse usar:

1. No canto superior direito do painel do suplemento Databricks no Excel, clique no menu suspenso.
2. Selecione qual SQL warehouse você deseja usar.

Importar dados do Databricks

Importe dados do Databricks para o Excel selecionando uma tabela, escrevendo uma consulta SQL ou importando uma tabela dinâmica.

nota

Você pode importar a visualização de métricas Unity Catalog usando tabelas dinâmicas, consultas SQL e funções personalizadas.

Criar tabelas dinâmicas

Para criar uma tabela dinâmica a partir das tabelas Unity Catalog e visualizá-la no Excel:

1. No painel do suplemento Databricks para Excel , na tab Nova importação , selecione Selecionar dados como o método de importação .

2. Em Catálogo , selecione a tabela a partir da qual deseja criar uma tabela dinâmica e clique em Selecionar .

3. Selecione a caixa de seleção "Dados dinâmicos" .

4. Configure **Linha**, **Coluna** e **Valor** arrastando cada campo para a área correta.

5. (Opcional) Adicione um Filtro . Para obter mais informações sobre filtros, consulte Filtrar dados importados.

6. (Opcional) Para ver um exemplo da importação, clique em Visualizar .

7. (Opcional) Defina um limite de linhas para sua importação.

8. Importe seus resultados. Escolha uma das seguintes opções:

   • Clique em Salvar e importar para salvar a consulta para reutilização na planilha do Excel e importar os resultados.
   • Clique na seta para baixo e, em seguida, clique em Importar resultados para importar os resultados sem salvar a consulta. Use esta opção quando quiser continuar editando uma importação.

nota

As tabelas dinâmicas só podem ser importadas para uma nova planilha.

Ao trabalhar com métricas do Unity Catalog em tabelas dinâmicas, você pode ver Sum(measure) exibido nos resultados. Este é o comportamento esperado e nenhuma agregação adicional ocorre. O Excel exige que os valores tenham uma função de agregação, mas como os dados contêm valores únicos, nenhuma agregação ocorre.

Selecionar tabelas

Os dados são importados como um objeto de tabela do Excel. Você pode mover a tabela ou renomear a planilha, e o suplemento Excel atualizará os dados no novo local.

Para importar dados de uma tabela do Databricks, faça o seguinte:

1. No painel do suplemento Databricks para Excel , na tab Nova importação , selecione Selecionar dados como o método de importação .
2. Selecione uma tabela para importar no explorador de catálogo. Você pode filtrar o catálogo por proprietário, status de certificação e outras propriedades usando filtro.
3. Clique em Selecionar .
4. Em Colunas , clique na seta para baixo e desmarque as colunas que não deseja importar ou deixe todas as colunas selecionadas para importar a tabela inteira.
5. (Opcional) Adicione um Filtro . Para obter mais informações sobre filtros, consulte Filtrar dados importados.
6. (Opcional) Para ver um exemplo da importação, clique em Visualizar .
7. (Opcional) Defina um limite de linhas para restringir o número de linhas importadas.
8. (Opcional) Para identificar seus dados importados, insira um Nome da importação .
9. Em Destino de Saída , escolha importar os dados para uma nova planilha ou para a planilha atual. Se você importar para a planilha atual, os dados começarão na referência de célula que você inserir (por default , A1).
10. Importe seus resultados. Escolha uma das seguintes opções:
    • Clique em Salvar e importar para salvar a consulta para reutilização na planilha do Excel e importar os resultados.
    • Clique na seta para baixo e, em seguida, clique em Importar resultados para importar os resultados sem salvar a consulta. Use esta opção quando quiser continuar editando uma importação.

Escreva consultas SQL

O método de importação Write SQL oferece suporte a funções SQL e procedimentos armazenados.

Para executar consultas SQL personalizadas em seu workspace Databricks , faça o seguinte:

1. No painel do suplemento Databricks para Excel , na tab Nova importação , selecione Escrever SQL como o método de importação .

2. Insira um nome para sua consulta para identificá-la posteriormente.

3. Escreva uma nova consulta ou utilize uma consulta existente do seu workspace Databricks .

   • Escreva sua consulta SQL no editor. Você pode consultar qualquer tabela no Unity Catalog à qual você tenha permissão de acesso.

     • Clique Explore o catálogo para view seus esquemas e tabelas.

   • Para usar uma consulta do seu workspace Databricks ou uma consulta existente no Excel, clique em a pasta. Se você usar uma consulta existente do seu workspace Databricks , as edições feitas no Excel não serão refletidas no Databricks.

nota

É necessário que as queries sejam explicitamente salvas no Databricks usando o botão Salvar no canto superior direito do editor de queries antes de aparecerem no Excel.

4. (Opcional) Para adicionar parâmetros de consulta, clique em +Adicionar ao lado de Parâmetros . Clique no parâmetro e insira o Nome do Parâmetro e o Valor do Parâmetro .

   • Para o valor do parâmetro, você pode inserir um valor específico ou clicar na caixa e no botão de seta para especificar uma referência de célula. Selecione uma célula ou um intervalo de células e clique na seta para preencher automaticamente o valor do parâmetro.

5. Em Destino de Saída , escolha importar os dados para uma nova planilha ou para a planilha atual. Se você importar para a planilha atual, os dados começarão na referência de célula que você inserir (por default , A1).

6. Para pré-visualizar os resultados da sua consulta, clique em execução .

7. Importe seus resultados. Escolha uma das seguintes opções:

   • Clique em Salvar e importar para salvar a consulta para reutilização na planilha do Excel e importar os resultados.
   • Clique na seta para baixo e, em seguida, clique em Importar resultados para importar os resultados sem salvar a consulta. Use esta opção quando quiser continuar editando uma importação.

Você também pode usar funções personalizadas para adicionar parâmetros de consulta. Consulte Escrever SQL.

Filtrar dados importados

Ao importar dados selecionando uma tabela ou criando uma tabela dinâmica, você pode aplicar filtros para restringir os resultados.

Os filtros de strings não diferenciam maiúsculas de minúsculas e são em cascata. Ao aplicar mais de um filtro, os valores disponíveis para cada filtro dependem das seleções nos filtros anteriores a ele. Por exemplo, se você filtrar por país e, em seguida, adicionar um filtro por cidade, o filtro de cidade oferecerá apenas cidades dentro do país selecionado.

Para definir filtros, clique em + ao lado de Filtros , selecione a coluna à qual deseja aplicar um filtro e insira a condição do filtro. Para filtros que exigem um valor, é possível fazer uma das seguintes ações:

• Insira o valor.

• Para gerar uma lista de até 5.000 valores de filtro distintos, você pode usar:

  1. Clique em Valores e, em seguida, em Obter valores de filtro .
  2. Clique na seta para baixo e selecione um ou mais valores na lista.

• Para usar uma referência de célula:

  1. Clique em Células .
  2. Selecione uma célula ou intervalo de células.
  3. Clique no cursor .

A tabela a seguir descreve cada filtro disponível e sua entrada esperada.

Filtrar	Entrada esperada	Descrição
IS NULL	Nenhuma	Encontra as linhas onde o valor da coluna é nulo.
IS NOT NULL	Nenhuma	Encontra as linhas onde o valor da coluna não é nulo.
EQUALS	Uma sequência de números ou textos	Encontra as linhas onde o valor da coluna corresponde exatamente ao valor especificado.
NOT EQUALS	Uma sequência de números ou textos	Encontra linhas onde o valor da coluna não corresponde ao valor especificado.
STARTS WITH	Uma sequência de texto	Encontra as linhas onde o valor da coluna começa com o texto especificado.
ENDS WITH	Uma sequência de texto	Encontra as linhas onde o valor da coluna termina com o texto especificado.
CONTAINS	Uma sequência de texto	Encontra as linhas onde o valor da coluna contém o texto especificado em qualquer lugar nas strings.

Filtrar	Entrada esperada	Descrição
IS NULL	Nenhuma	Encontra as linhas onde o valor da coluna é nulo.
IS NOT NULL	Nenhuma	Encontra as linhas onde o valor da coluna não é nulo.
EQUALS	Uma sequência de números ou textos	Encontra as linhas onde o valor da coluna corresponde exatamente ao valor especificado.
NOT EQUALS	Uma sequência de números ou textos	Encontra linhas onde o valor da coluna não corresponde ao valor especificado.
STARTS WITH	Uma sequência de texto	Encontra as linhas onde o valor da coluna começa com o texto especificado.
ENDS WITH	Uma sequência de texto	Encontra as linhas onde o valor da coluna termina com o texto especificado.
CONTAINS	Uma sequência de texto	Encontra as linhas onde o valor da coluna contém o texto especificado em qualquer lugar nas strings.

Usar funções personalizadas do Databricks no Excel

O suplemento para Excel fornece funções personalizadas que você pode usar em fórmulas do Excel para importar dados do Databricks.

Selecione uma tabela

A função DATABRICKS.Table importa dados de uma tabela Unity Catalog .

Sintaxe:

Text

=DATABRICKS.Table(catalog_name.schema_name.table_name, [column1, ...], [limit])

Parâmetros:

• catalog_name.schema_name.table_name (Obrigatório): O nome completo da tabela.
• columns (opcional): Uma matriz de nomes de colunas para importar. Omita este parâmetro para importar todas as colunas.
• limit (opcional): O número máximo de linhas a importar. Omita este parâmetro para importar todas as linhas, até o limite de 10 MB.

Exemplo:

Text

=DATABRICKS.Table("main.default.customers", {"customer_id", "customer_name"}, 100)

Esta fórmula importa as colunas customer_id e customer_name da tabela main.default.customers , limitada a 100 linhas.

Escreva SQL

A função DATABRICKS.SQL executa uma consulta SQL que usa parâmetros de consulta e retorna os resultados.

Sintaxe:

Especifique os parâmetros usando valores.

Text

=DATABRICKS.SQL("query_text", {parameter1_name, parameter1_value; ...})

Especifique os parâmetros usando um intervalo de células. Defina os parâmetros de nome e valor em células que estão na mesma linha.

Text

=DATABRICKS.SQL("query_text", {param_name_cell: param_value_cell; ...})

Parâmetros:

• query_text (Obrigatório): A consulta SQL a ser executada.
• parameters (Obrigatório): Um mapeamento dos valores dos parâmetros a serem substituídos na consulta.

Exemplo:

Text

=DATABRICKS.SQL("SELECT * FROM samples.bakehouse.sales_suppliers WHERE longitude > :long_param AND latitude > :lat_param LIMIT 10", {"long_param",20; "lat_param",10})

=DATABRICKS.SQL("SELECT * FROM samples.bakehouse.sales_suppliers WHERE city = :city", M4:N4)

Esta fórmula executa uma consulta que filtra os dados de vendas por longitude e latitude, usando os valores de parâmetro fornecidos.

registrar consultas

Gerencie suas importações existentes na página Importações.

Editar uma importação existente

Para editar uma importação existente:

1. No painel do suplemento Databricks no Excel, clique na tab Importações .
2. Localize a importação que deseja editar.
3. Clique no menu de três pontos ao lado de "Importar".
4. Clique em Editar para editar sua importação.

atualizar dados

O Add-in do Excel não faz refresh dos dados automaticamente. Como fazer refresh dos dados depende de como eles foram importados. Dados importados usando um método de importação (selecionar uma tabela, escrever uma query SQL ou criar uma tab dinâmica) refresh da tab Importações . Dados importados usando uma função personalizada devem ser recalculados.

Atualize as importações com os valores mais recentes da Databricks. O Add-in executa a consulta original ou a seleção de tabela novamente e atualiza a sua planilha com dados atualizados:

• Para refresh de uma única importação:

  1. No painel do suplemento Databricks no Excel, clique na tab Importações .
  2. Clique refresh ao lado da importação que deseja refresh.

• Para refresh de todas as importações:

  1. Clique em "Atualizar tudo" no painel do suplemento Databricks .

importante

Ao atualizar os dados, o suplemento do Excel limpa todos os dados existentes na tabela especificada e recarrega os dados mais recentes do Databricks. Quaisquer colunas personalizadas que você tenha adicionado à tabela serão excluídas durante o processo refresh .

Os dados importados de funções personalizadas, como DATABRICKS.Table e DATABRICKS.SQL, não refresh quando você reabre uma pasta de trabalho. Para refresh os dados importados de funções personalizadas, entre no Add-in do Databricks e, em seguida, recalcule a pasta de trabalho ou altere um valor que a função personalizada referencia.

compartilhamento implicações

Ao compartilhar uma pasta de trabalho do Excel que contenha dados do Databricks, considere as seguintes implicações de acesso e segurança de dados:

Visibilidade dos dados importados

Quando um destinatário atualiza uma importação, o Add-in usa as permissões Unity Catalog do destinatário. Se eles não tiverem acesso aos dados subjacentes, a refresh falhará.

Para pastas de trabalho onde a privacidade dos dados é uma preocupação, você pode usar a seguinte solução alternativa:

1. Crie uma planilha com todas as fórmulas e importações necessárias.
2. Exclua os dados importados da planilha.
3. Compartilhe a apostila com o destinatário.
4. Peça ao destinatário refresh os dados.

O destinatário vê apenas os dados aos quais tem acesso com base nas suas permissões Unity Catalog .

Acesso ao espaço de trabalho e aos dados ativos

• Usuários sem acesso aos objetos Unity Catalog referenciados na planilha não podem refresh os dados. Para refresh os dados, os usuários devem ter permissões de leitura nas tabelas subjacentes e na visualização no Unity Catalog.
• Os usuários precisam ter acesso à tabela subjacente no Databricks para editar as importações existentes.

Visibilidade da consulta

Usuários com permissão de edição na planilha podem view as consultas usadas para gerar os dados por meio do complemento Databricks , mesmo que não tenham acesso aos dados subjacentes no Unity Catalog.

Alternativa para salvar como um padrão

O Suplemento do Databricks Excel não oferece suporte para salvar uma pasta de trabalho como um padrão, mas você pode compartilhar uma pasta de trabalho para que outros usuários possam ver as consultas importadas. Consulte Implicações de compartilhamento para acesso a dados e considerações de segurança.

Para contornar o compartilhamento de um workbook como um padrão, siga um destes procedimentos:

• Compartilhe o arquivo local com outro usuário. O destinatário pode renomear o arquivo e ver as queries salvas.
• No SharePoint, compartilhe a pasta de trabalho com outro usuário. Quando outro usuário faz download do arquivo, as importações salvas são preservadas.

Limitações

• Funções personalizadas : Para funções personalizadas, os resultados da consulta são limitados a 25 MiB devido às limitações da API de execução SQL.
• Carregamento de dados : O carregamento de dados pode falhar se alguma célula da planilha estiver em modo de edição.
• Limite de linhas do Excel Desktop : O Excel Desktop suporta um máximo de 1.048.576 linhas por planilha.
• Limite de tamanho de arquivo do Excel para a Web : O Excel para a Web suporta um tamanho máximo de arquivo de pasta de trabalho de aproximadamente 25 MB para visualização e edição.