Conectar-se à Databricks a partir do Google Sheets

info

Visualização

Esse recurso está em Public Preview.

Esta página descreve como usar o Conector do Databricks para o Google Sheets para conectar-se ao Databricks a partir do Google Sheets. O conector Databricks consulta dados Databricks diretamente do Google Sheets, possibilitando análises mais aprofundadas.

Antes de começar

• Crie um Databricks workspace. Consulte Criar um workspace.
• Criar um armazém Databricks SQL. Consulte Criar um SQL warehouse.
• Tenha acesso ao Google Sheets.
• Instale o conector da Databricks para o Google Sheets.
• Se o seu Databricks workspace tiver listas de acesso IP ativadas, o administrador do account deverá adicionar a lista de IPs do Google Cloud à lista de permissões.
  • Para saber mais sobre listas de acesso IP, consulte Configurar listas de acesso IP para o console account.
  • Para a lista de IPs do Google Cloud, consulte esta lista de IPs.

Conecte-se a um Databricks Workspace

Importe dados do Databricks para o Google Sheets usando o Conector Databricks para o Google Sheets, conectando-se primeiro a um workspace Databricks :

1. No Planilhas Google, selecione Extensões > Databricks Connector > Abra a barra lateral para abrir o conector.

   

2. Na caixa de diálogo Login , insira a URL do seu workspace Databricks . Para saber como encontrar a URL do seu workspace , consulte Obter identificadores para objetos workspace.

   • O URL do seu workspace está no seguinte formato: https://<instance-name>.cloud.databricks.com.

3. Clique em Entrar .

4. Uma caixa de diálogo solicita que você faça login ou mostra seu status de login.

5. Após efetuar o login, você poderá selecionar qual SQL warehouse utilizar. Na barra lateral do conector Databricks , na tab Dados , escolha um data warehouse Databricks SQL clicando no círculo no canto superior direito da barra lateral do conector e selecionando o data warehouse Databricks SQL de sua preferência. O conector inicia o SQL warehouse escolhido.

   

Use o conector Databricks para o Google Sheets.

O conector Databricks para Planilhas Google executa consultas em dados aos quais você tem acesso no Unity Catalog e importa esses dados para o Planilhas Google. O conector salva automaticamente todas as consultas como importações. Você pode refresh os resultados, reutilizar consultas existentes e rastrear a origem dos dados no Google Sheets.

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

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.

Escolha um método de importação

Selecione um dos seguintes métodos para importar dados do Databricks:

Select a table

Para importar dados de uma tabela no Databricks:

1. Na barra lateral do conector, em 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 Opções avançadas , escolha se deseja salvar os resultados da consulta em uma nova planilha ou na planilha atual.

   • Se você escolher a planilha atual, especifique em qual célula deseja 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:

1. Na barra lateral do conector, em Método de importação , selecione Criar nova consulta .

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. Opcionalmente, você pode adicionar parâmetros de consulta.

6. Em Opções avançadas , escolha se deseja salvar os resultados da consulta em uma nova planilha ou na planilha atual.

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

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

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.

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:

1. Ao importar dados, selecione 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.

gerenciar dados importados

Para gerenciar os dados importados do Databricks:

1. Selecione a 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 em > Vá para Planilha ao lado do nome da consulta.
4. Para editar uma importação, clique em > Editar ao lado do nome da consulta.
5. Para excluir uma importação, clique em > 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.

Alterar workspace Databricks

Para alterar o workspace Databricks ao qual você está conectado:

1. Selecione Extensões > Conector Databricks > Alterar workspace .
2. Insira a nova URL workspace e autentique-se no workspace.

implicações de compartilhamento

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 realizar usando o complemento.

• Destinatários com a função de Visualizador ou Comentador não podem acessar o complemento.
• Destinatários com a função Editor e acesso ativo a dados equivalente podem usar o complemento com sua account do Google. Eles podem usar o conector assim como o proprietário.
• Destinatários com a função 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 exatamente o mesmo nome.
  • Crie uma nova importação escolhendo Selecionar uma consulta como a origem, reutilizando a importação e clicando em Salvar como novo .

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