Atualizações de dados de agendamento no Google Sheets

Esta página descreve como agendar atualizações automáticas de dados no Databricks Connector do Google Sheets para manter os seus dados importados atualizados. As atualizações agendadas executam as suas consultas guardadas de forma recorrente e atualizam as folhas correspondentes.

Requisitos

• Tens de configurar o Databricks Connector para o Google Sheets e importar dados do Azure Databricks.

Criar uma ligação ao Catálogo Unity

As atualizações agendadas exigem o seguinte:

• Uma ligação ao Unity Catalog chamada databricks_google_connection, criada por um administrador da metastore no Google Sheets.
• O USE CONNECTION privilégio na ligação, concedido a utilizadores que precisam de criar ou gerir atualizações agendadas.

1. Como administrador de metastore do Azure Databricks, no Google Sheets, abra a barra lateral do Databricks Connector para o Google Sheets.
2. Clique na aba Importações guardadas.
3. Clique no calendário no canto superior direito.
4. Clica em Configurar ligação.

Partilha uma ligação em Azure Databricks

Depois de criada a ligação, conceda o USE CONNECTION privilégio aos utilizadores que precisam de criar ou gerir atualizações agendadas. Um administrador da metastore ou qualquer utilizador com privilégio MANAGE na ligação pode conceder este privilégio. Para mais informações sobre a gestão de ligações, consulte Gestão de ligações para a Lakehouse Federation.

Criar uma agenda

Cada importação pode ser atribuída apenas a um calendário. Para criar um novo cronograma para uma importação existente:

1. Na barra lateral do conector Azure Databricks no Google Sheets, clique no separador Importações guardadas.

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

3. Selecione a importação para a qual pretende criar um agendamento.

4. Insira um nome para a agenda.

5. Selecione a frequência da sua agenda:

   • Para Hourly, selecione o minuto da hora para executar a atualização.
   • Para Daily, selecione a hora do dia para executar a atualização.
   • Para Semanal, selecione o dia da semana e a hora para executar a atualização.

   O horário utiliza o seu fuso horário local.

6. Selecione o SQL warehouse para usar nas consultas agendadas.

7. Clique em Criar horário.

Ver histórico de corridas e detalhes do calendário

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

1. Na barra lateral do conector Azure Databricks no Google Sheets, clique no separador Importações guardadas.
2. Clique no ícone do calendário e clique em Ver histórico de corridas.
3. Clique numa corrida específica para ver os detalhes do calendário.

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

1. No painel Ver histórico de corridas , selecione o nome do calendário que quer ver. Em Edições Recentes, é mostrado o estado de cada corrida.

2. Passe o rato sobre um ícone de estado para ver o ID da Corrida, a hora de Início e o estado da Corrida.

   

3. Clique em Ver configuração para ver detalhes de agendamento, que incluem a importação e a configuração de agendamento selecionadas.

   • Se estiver a ver um horário criado por outra pessoa, a hora mostrada é a hora no fuso horário local do criador.

Apagar uma atualização agendada

Para apagar as suas atualizações agendadas, faça o seguinte:

1. Na barra lateral do conector Azure Databricks no Google Sheets, clique no separador Importações guardadas.
2. Clique no ícone do calendário e clique em Gerir horários.
3. Seleciona o horário que queres apagar.
4. Clica em Ver configuração, depois clica em Eliminar.

Troubleshooting

Se estiver a ter problemas com as atualizações agendadas, elimine o agendamento no Google Sheets e as ligações correspondentes do Unity Catalog no Azure Databricks e recrie o agendamento. Para mais informações sobre ligações ao Unity Catalog, consulte Gerir ligações para a Lakehouse Federation.

Limitações

• Não podes editar uma atualização agendada. Só podes ver ou eliminar horários existentes. Para modificar um cronograma, apague-o e crie um novo.
• Se editares uma consulta utilizada por um agendamento, o agendamento não incorpora automaticamente as tuas alterações. Para aplicar o texto atualizado da consulta, apague o horário e recrie-o.
• Não pode agendar uma atualização de dados em tabelas dinâmicas. A API do Google atualiza apenas os dados brutos da consulta e não pode modificar a configuração pivot se o esquema do resultado da consulta mudar.
• Um único cronograma pode incluir um máximo de 20 importações.
• O texto de consulta para importações usado numa atualização programada tem um limite de 4.096 caracteres.