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

Esta página descreve como programar a atualização automática de dados no conectorDatabricks para Planilhas Google , mantendo seus dados importados sempre atualizados. Atualize periodicamente as suas consultas salvas e atualize as planilhas correspondentes.

Requisitos

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

Criar uma conexão Unity Catalog

A atualização agendada requer o seguinte:

• Uma conexão Unity Catalog chamada databricks_google_connection, criada por um administrador do metastore no Google Sheets.
• O privilégio USE CONNECTION na conexão, concedido aos usuários que precisam criar ou gerenciar atualizações agendadas.

1. Como administrador do metastore do Databricks, no Google Sheets, abra a barra lateral do Conector do Databricks para o Google Sheets.
2. Clique na tab Importações salvas .
3. Clique no calendário no canto superior direito.
4. Clique em Configurar conexão .

Compartilhe uma conexão no Databricks

Após a conexão ser criada, conceda o privilégio USE CONNECTION aos usuários que precisam criar ou gerenciar atualizações agendadas. Um administrador do metastore ou qualquer usuário com o privilégio MANAGE na conexão pode conceder este privilégio. Para obter mais informações sobre como gerenciar conexões, consulte Gerenciar conexões para a Federação Lakehouse.

Crie um programador

Cada importação pode ser atribuída a apenas um programador. Para criar um novo programa para uma importação existente:

1. Na barra lateral do conector Databricks no Google Sheets, clique na tab Importações salvas .

2. Clique no ícone do calendário e clique em Novo programa .

3. Selecione a importação para a qual deseja criar um programa.

4. Digite um nome para o programa.

5. Selecione a frequência do seu programador:

   • Para a opção "Por hora" , selecione o minuto da hora para executar a refresh.
   • Para a opção Diária , selecione o horário do dia em que a refresh será executada.
   • Para a opção Semanal , selecione o dia da semana e a hora em que deseja executar a refresh.

   O programa utiliza o seu fuso horário local.

6. Selecione o SQL warehouse a ser usado para as consultas agendadas.

7. Clique em Criar programa .

ver história de execução e detalhes da programação

Para visualizar o histórico de execução de todas as suas atualizações agendadas, faça o seguinte:

1. Na barra lateral do conector Databricks no Google Sheets, clique na tab Importações salvas .
2. Clique no ícone do calendário e clique em visualizar história de execução .
3. Clique em uma execução específica para view os detalhes do programar.

Para view o histórico de execução e os detalhes de configuração de uma refresh agendada, faça o seguinte:

1. No painel de histórico de execução , selecione o nome do programa que deseja view. Em Execução recente , o status de cada execução é mostrado.

2. Passe o mouse sobre um ícone de status para ver o ID de execução , a hora de início e o status da execução de uma execução.

   

3. Clique em "Exibir configuração" para ver os detalhes do programa, que incluem a importação selecionada e a configuração do programa.

   • Se você estiver visualizando um programa criado por outra pessoa, a hora exibida será a hora no fuso horário local do criador.

Excluir refreshagendada

Para excluir sua atualização agendada, faça o seguinte:

1. Na barra lateral do conector Databricks no Google Sheets, clique na tab Importações salvas .
2. Clique no ícone do calendário e clique em gerenciar programar .
3. Selecione o programa que deseja excluir.
4. Clique em "Exibir configuração" e, em seguida, clique em "Excluir" .

Solução de problemas

Se você estiver enfrentando problemas com a atualização agendada, exclua o arquivo programático no Google Sheets e as conexões correspondentes Unity Catalog no Databricks e recrie o arquivo programático. Para mais informações sobre conexões Unity Catalog , consulte gerenciar conexões para lakehouse Federation.

Limitações

• Não é possível editar uma refresh agendada. Você só pode view ou excluir programas existentes. Para modificar um programa, exclua-o e crie um novo.
• Se você editar uma consulta que um programador utiliza, o programador não detectará automaticamente as suas alterações. Para aplicar o texto de consulta atualizado, exclua o programa e recrie-o.
• Não é possível programar uma refresh em tabelas dinâmicas. A API do Google atualiza apenas os dados brutos da consulta e não pode modificar a configuração de pivô se o esquema do resultado da consulta for alterado.
• Um único programador pode incluir no máximo 20 importações.
• O texto de consulta para importações usadas em uma refresh agendada tem um limite de 4.096 caracteres.