Consultar dados do Databricks no Google Sheets

info

Visualização

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

Esta página descreve como consultar dados do seu workspace Databricks e importá-los para o Google Sheets usando o ConectorDatabricks para o Google Sheets . Você pode selecionar tabelas diretamente, escrever consultas SQL, adicionar parâmetros e criar tabelas dinâmicas. O conector salva automaticamente todas as consultas como importações, permitindo que você refresh os resultados e reutilize as consultas existentes.

Pré-requisitos

• Você configurou o conector do Databricks para o Google Sheets.

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. 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.

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

Select data

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

1. Na barra lateral do conector Databricks do Google Sheets, em Dados , 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, marque a opção Limitar linhas para definir um limite para o número de linhas a serem importadas.

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

   • 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.

Write a SQL query

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

1. Na barra lateral do conector Databricks do Google Sheets, em Dados , selecione Escrever SQL .

2. A Databricks recomenda que você insira um nome para sua consulta para que ela seja identificável.

3. Você pode navegar por catálogos, esquemas e tabelas.

4. No campo "Texto da consulta" , insira sua consulta SQL.

5. Opcionalmente, você pode adicionar parâmetros de consulta.

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

   • Se você selecionar a planilha atual, especifique em qual célula começar a adicionar os dados.

7. Clique em Salvar e Importar para executar a consulta e preencher a planilha.

nota

A execução da consulta expira após três 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.

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 Trabalhar com parâmetros de consulta.

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.

   

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.

dados importados

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

1. Clique na tab Importações na barra lateral do conector.
2. Para refresh uma importação, clique no ícone refresh ao lado do nome da consulta.
3. Para ver a qual planilha uma importação está conectada, clique > Acesse a planilha ao lado do nome da consulta.
4. Para editar uma importação, clique > Editar ao lado do nome da consulta.
5. Para excluir uma importação, clique > 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.

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 .

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

• Atualização programática de dados no Google Sheets