Partilhar via

Consultar os dados do Azure Databricks no Google Sheets

Importante

Este recurso está no Public Preview.

Esta página descreve como consultar dados do seu espaço de trabalho Azure Databricks e importá-los para o Google Sheets usando o Databricks Connector para o Google Sheets. Podes selecionar tabelas diretamente, escrever consultas SQL, adicionar parâmetros e criar tabelas dinâmicas. O conector guarda automaticamente todas as consultas como importações para que possas atualizar os resultados e reutilizar consultas existentes.

Pré-requisitos

Escolha um método de importação

Pode importar dados do Azure Databricks para o Google Sheets selecionando uma tabela ou escrevendo uma consulta SQL. Depois que os dados são importados, a consulta é vinculada à planilha. Alterar o nome da planilha quebra o mapeamento. Para obter informações sobre como lidar com alterações de nome, consulte Limitações.

Importante

Se estiver a usar "Select data" para importar vistas de métricas do Unity Catalog, elas só podem ser importadas como tabelas dinâmicas porque as métricas do Unity Catalog representam dados em formato de tabela dinâmica.

Escolha um método de importação para começar:

Selecionar dados

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

  1. Na barra lateral do Google Sheets Databricks Connector, em Dados, para o método Importar, selecione Selecionar dados.
  2. Em Catálogo, usa os menus suspensos de catálogo, esquema e tabela para procurar a tabela que queres importar.
  3. Opcionalmente, atualize o Nome do Ativo para alterar o nome desta importação.
  4. Opcionalmente, em Campos, escolha quais colunas incluir ou excluir.
  5. Podes, opcionalmente, importar como tabela dinâmica.
  6. Para adicionar um filtro, clique em + Filtrar em Filtros. Selecione a Coluna para aplicar o filtro e o tipo de Filtro.
  7. Opcionalmente, verifique Limitar linhas para definir um limite para o número de linhas a importar.
  8. Em Destino de Saída, escolha se quer guardar os resultados da consulta numa nova folha ou na folha atual.
    • Se você escolher a planilha atual, especifique em qual célula começar a adicionar os dados.
  9. Clique em Guardar e Importar para preencher a folha.

Escreva uma consulta SQL

Para escrever uma nova consulta SQL, faça o seguinte:

  1. Na barra lateral do Google Sheets Databricks Connector, em Data, selecione Escrever SQL.
  2. O Databricks recomenda inserir um nome para sua consulta para que ela seja identificável.
  3. Você pode navegar por catálogos, esquemas e tabelas.
  4. Em Texto da consulta, insira sua consulta SQL.
  5. Pode, opcionalmente, adicionar parâmetros de consulta.
  6. Em Destino de Saída, escolha se quer guardar os resultados da consulta numa nova folha ou na folha atual.
    • Se você escolher a planilha atual, especifique em qual célula começar a adicionar os dados.
  7. Clique em Salvar & Importar para executar a consulta e preencher a planilha.

Observação

A execução da consulta termina após três minutos. Se a sua consulta ultrapassar esse limite, é automaticamente cancelada. Para conjuntos de resultados grandes, as primeiras 1.000 linhas são escritas imediatamente, com os dados restantes recolhidos progressivamente. Se a obtenção de dados for interrompida, os resultados parciais permanecem na sua folha e podem ser apagados reexecutando a consulta.

Folhas preenchidas com resultados de consulta

Adicionar parâmetros de consulta (opcional)

Para adicionar parâmetros de consulta à sua consulta SQL:

  1. Verifique se sua consulta tem pelo menos um parâmetro de consulta, no formato de :parameter_name. Para mais informações sobre parâmetros de consulta, veja Usar marcadores de parâmetros nomeados.

  2. Clique em + Adicionar parâmetro.

  3. Insira o parâmetro na primeira caixa. Verifique se o nome do parâmetro corresponde ao que você inseriu no editor de consultas.

  4. Introduza o nome da folha e a localização da célula onde se encontra o valor do parâmetro na segunda caixa, incluindo o ponto de exclamação após o nome da folha.

  5. Para adicionar mais parâmetros de consulta, clique em + Adicionar parâmetro novamente.

    Por exemplo, a consulta a seguir inclui o parâmetro :trip_distance query, que é definido na planilha sheet_1, célula H1.

    Consulta com parâmetros de consulta

Importar como tabela dinâmica (opcional)

Para importar os seus dados como tabela dinâmica, faça o seguinte:

  1. Para importar dados usando o método Selecionar dados, selecione a caixa de seleção Tabela Dinâmica.
  2. Em Configuração Dinâmica, selecione as Linhas e Colunas para as dimensões da sua tabela dinâmica.
  3. Especifique os valores a agregar. Clique em + Adicionar Valor e selecione a coluna e o método de agregação.
  4. Opcionalmente, adicione filtros clicando em + Adicionar Filtro e selecione o tipo Coluna e Filtro.
  5. Clique em Guardar e Importar para importar os resultados como tabela dinâmica. As tabelas dinâmicas de importação são automaticamente importadas para uma nova folha.

Configure uma tabela dinâmica no Databricks Connector

Gerir dados importados

Para gerir os dados que importa do Azure Databricks, faça o seguinte:

  1. Clique no pestana Importações na barra lateral do conector.
  2. Para atualizar uma importação, clique no ícone de atualização ao lado do nome da consulta.
  3. Para ver a qual planilha uma importação está conectada, clique no ícone do menu Kebab.> Vá para Planilha ao lado do nome da consulta.
  4. Para editar uma importação, clique no ícone do menu Kebab.> Edite ao lado do nome da consulta.
  5. Para excluir uma importação, clique no ícone do menu Kebab.> Excluir ao lado do nome da consulta. Isso exclui a consulta, não os dados importados para o Planilhas Google. Você deve excluir manualmente os dados importados.

Gerir dados Databricks importados no Google Sheets

Partilha de implicações

O complemento não afeta sua capacidade de compartilhar sua Planilha Google. No entanto, a maneira como você compartilha o arquivo afeta as ações que seus destinatários podem executar usando o complemento.

  • Os destinatários com a função Visualizador ou Comentarista não podem acessar o complemento.
  • Os destinatários com a função Editor e acesso a ativos de dados equivalentes podem usar o complemento com sua Conta do Google. Eles podem usar o conector assim como o proprietário.
  • Os destinatários com a função Editor e o mesmo acesso aos recursos subjacentes podem atualizar as importações se estiverem conectados ao mesmo espaço de trabalho do Azure Databricks.

Limitações

  • Renomear ou eliminar uma folha que está associada a uma importação existente impede-te de atualizar a importação. Para corrigir isso, siga um destes procedimentos:

    • Recrie a folha com o mesmo nome.
    • Crie uma nova importação escolhendo Selecionar uma Consulta como origem, reutilizando a importação e clicando em Salvar como Novo.

  • Se duas consultas mapearem para intervalos iguais ou sobrepostos, o complemento mostra os resultados da consulta mais recentemente executada. Isso substitui dados importados anteriormente.

Passos seguintes

  • Last updated on