Pular para o conteúdo principal
Última atualização em

Consultar dados do Databricks no Google Sheets

O Databricks Connector for Google Sheets consulta dados do seu workspace do Databricks e os importa para o Planilhas do Google. Você pode selecionar tabelas diretamente, escrever queries SQL, adicionar parâmetros e criar tabelas dinâmicas. O conector salva automaticamente todas as queries como importações para que você possa refresh os resultados e reutilizar queries existentes.

Pré-requisitos​

Escolha um método de importação​

Você pode importar dados do Databricks para o Google Sheets selecionando uma tabela ou escrevendo uma consulta SQL. Após a importação dos dados, a consulta é vinculada à planilha. O conector suporta a importação de até 10 milhões de células, limite estabelecido pelo Google Sheets.

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 você estiver usando a opção "Selecionar dados" para importar a visualização de métricas Unity Catalog , elas só poderão ser importadas como tabelas dinâmicas, pois as métricas Unity Catalog representam dados dinâmicos.

atenção

Não remova nem modifique a formatação da tabela. O identificador da tabela do Google Sheets é usado para refresh a importação. Remover a formatação causa erros refresh .

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

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

  1. Na barra lateral do conector Databricks do Google Sheets, em Nova importação , para Método de importação , selecione Selecionar dados .

  2. Em Catálogo , use os menus suspensos de catálogo, esquema e tabela para pesquisar a tabela que deseja importar.

  3. Opcionalmente, atualize o Nome ativo para alterar o nome desta importação.

  4. Opcionalmente, em Campos , escolha quais colunas incluir ou excluir.

  5. Opcionalmente, você pode importar como uma tabela dinâmica.

  6. Para adicionar um filtro, clique em + Filtro em Filtros . Selecione a coluna à qual deseja aplicar o filtro e o tipo de filtro .

  7. Opcionalmente, ative a opção Limitar linhas para definir um limite para o número de linhas a serem importadas. O limite está ativado por default e definido para 1.000 linhas.

  8. Em Destino da saída , selecione se deseja salvar os resultados da consulta em uma nova planilha ou na planilha atual.

    • Se você selecionar uma nova planilha, insira um nome para ela.
    • Se você selecionar a planilha atual, especifique em qual célula começar a adicionar os dados.

  9. Clique em Salvar e Importar para preencher a planilha.

nota

A execução da consulta expira após 15 minutos. Se a sua consulta exceder esse limite, ela será cancelada automaticamente. Para conjuntos de resultados grandes, as primeiras 1.000 linhas são gravadas imediatamente, e os dados restantes são obtidos progressivamente. Caso a coleta de dados seja interrompida, resultados parciais permanecerão na sua planilha e poderão ser apagados executando a consulta novamente.

Planilhas preenchidas com resultados de consultas

Adicionar parâmetros de consulta (opcional)​

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

  1. Certifique-se de que sua consulta tenha pelo menos um parâmetro de consulta, no formato :parameter_name. Para obter mais informações sobre parâmetros de consulta, consulte Usar marcadores de parâmetros nomeados.

  2. Clique em + Adicionar parâmetro .

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

  4. Na segunda caixa, insira o nome da planilha e a localização da célula onde está o valor do parâmetro, incluindo o ponto de exclamação após o nome da planilha.

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

    Por exemplo, a seguinte consulta inclui o parâmetro de consulta :trip_distance, que está definido na planilha sheet_1, célula H1.

    Consulta com parâmetros de consulta

Importar como tabela dinâmica (opcional)​

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

  1. Para importar dados usando o método Selecionar dados , marque a caixa de seleção Tabela dinâmica .
  2. Em Configuração da Tabela Dinâmica , selecione as Linhas e Colunas para as dimensões da sua tabela dinâmica.
  3. Especifique os valores pelos quais deseja 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 selecionando a coluna e o tipo de filtro .
  5. Clique em Salvar e Importar para importar os resultados como uma tabela dinâmica. As tabelas dinâmicas importadas são automaticamente salvas em uma nova planilha.

Configure uma tabela dinâmica no conector do Databricks.

Campos calculados​

Um campo calculado é uma coluna derivada de dados existentes, como profit computado a partir de revenue e cost. O Databricks Connector for Google Sheets não oferece suporte à criação de campos calculados usando o método de importação Select data . Para adicionar um campo calculado, use um dos seguintes métodos:

A Databricks recomenda o uso do Genie One para campos calculados.

dados importados​

Para gerenciar os dados que você importa do Databricks, faça o seguinte:

  1. Clique na tab "Importações salvas" na barra lateral do conector.

  2. Para refresh manualmente os dados importados:

    • Atualizar uma única importação : Clique no ícone refresh ao lado do nome da consulta.
    • Atualizar todas as importações : Clique no ícone refresh na parte superior da tab Importações salvas , ao lado do ícone de calendário.

    Para refresh automaticamente as importações de forma recorrente, consulte Atualização de dados programada no Google Sheets.

  3. Para ver a qual planilha uma importação está conectada, clique Ícone do menu Kebab. > Acesse a planilha ao lado do nome da consulta.

  4. Para editar uma importação, clique Ícone do menu Kebab. > Editar ao lado do nome da consulta.

  5. Para excluir uma importação, clique Ícone do menu Kebab. > Apague o que está ao lado do nome da consulta. Isso exclui a consulta, não os dados importados para o Google Sheets. Você deve excluir manualmente os dados importados.

Gerenciar dados importados Databricks no Google Sheets

compartilhamento implicações​

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

  • Os destinatários com a função de Visualizador ou Comentarista não podem acessar o complemento.
  • Os destinatários com a função de Editor e acesso ativo equivalente aos dados podem usar o complemento com sua account do Google. Eles podem usar o conector da mesma forma que o proprietário.
  • Os destinatários com a função de Editor e o mesmo acesso ao recurso subjacente podem refresh as importações se estiverem conectados ao mesmo workspace Databricks .

Mover dados importados​

Mova as tabelas importadas usando os comandos padrão de copiar e colar ou recortar e colar:

  • Copiar e colar duplica os dados da tabela.
  • Recortar e colar move a tabela importada.

O Databricks não impede que você exporte os dados da tabela.

Limitações​

  • Renomear ou excluir uma planilha vinculada a uma importação existente impede a atualização da importação. Para corrigir isso, faça um dos seguintes procedimentos:

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

  • Se duas consultas corresponderem aos mesmos intervalos ou a intervalos sobrepostos, o complemento exibirá os resultados da consulta executada mais recentemente. Isso sobrescreve os dados importados anteriormente.

Próximos passos​

Nesta página