Conectar-se à Databricks a partir do Google Sheets

info

Visualização

Esse recurso está em Public Preview.

Esta página descreve como usar o Databricks Connector para Planilhas Google para se conectar ao Databricks a partir do Planilhas Google. O complemento Databricks consulta dados Databricks de dentro do Planilhas Google, permitindo 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.

Importar dados do Databricks para o Planilhas Google

Importe dados do Databricks para o Planilhas Google usando o Conector Databricks para Planilhas Google conectando-se a um workspace Databricks e escrevendo ou importando consultas.

o passo 1: Conectar a um Databricks Workspace

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.

o passo 2: Use o conector Databricks para o Planilhas Google

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

1. (Opcional) Na tab Dados , escolha um warehouse Databricks SQL clicando no círculo no canto superior direito da barra lateral do conector e selecionando seu warehouse Databricks SQL preferido. O conector inicia o SQL warehouse escolhido.

   

2. Para escrever uma nova consulta SQL:

   1. Na barra lateral do conector, para Origem , 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. 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.

3. Para atualizar ou criar uma nova consulta a partir de uma consulta SQL existente:

   1. Na barra lateral do conector, para Origem , selecione Selecionar consulta .
   2. Em Consulta , selecione a consulta que você deseja usar.
   3. Se necessário, edite a consulta.

4. (Opcional) Para adicionar parâmetros de consulta à sua consulta:

   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.

   

5. Para executar a consulta:

   • Para uma nova consulta, clique em Salvar e Importar para executar a consulta e preencher a planilha.
   • Para uma consulta existente, clique em Atualizar e Importar . Se você quiser salvar a consulta atualizada como uma nova consulta, clique na seta para baixo ao lado de Atualizar e Importar e clique em Salvar como Nova .

   

6. Sua planilha foi preenchida com os resultados da consulta.

   

nota

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.

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

• Não é possível renomear ou excluir uma planilha anexada a uma importação existente. Se fizer isso, você não poderá refresh a importação. Para corrigir isso, faça um dos seguintes:

  • 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 forem mapeadas para o mesmo intervalo ou para intervalos sobrepostos, o complemento exibirá os resultados da consulta executada mais recentemente. Isso substitui os dados importados anteriormente.