Autenticação
Para que a Uncover consiga ler dados de suas planilhas do Google Sheets, é necessário fazer "sign in" na plataforma. O usuário fazendo sign in precisa ter, no mínimo, permissão de leitura sobre a planilha sendo conectada.
Requisitos de qualidade de dados
Para garantir que a conexão funcionará corretamente, as abas da planilha precisam seguir alguns padrões de qualidade. O ideal é que todas as abas (mesmo as não conectadas) sigam um formato "tabular", isso é, o mais próximo possível de um arquivo CSV. A lista abaixo descreve alguns direcionamentos, mas não é extensiva.
Linha de header: todas as abas precisam conter a primeira linha com o nome da respectiva coluna;
Colunas vazias: nenhuma coluna deve ser inteiramente vazia, isso é, não conter sequer o header;
Linha de total: as abas não devem conter linhas de total no fim dos dados;
Células com fórmulas: não são recomendadas;
Fórmulas com erro: não deve haver células com erro de fórmula;
Colunas repetidas: cada nome de coluna deve ser único dentro de uma aba;
Coluna de data: uma coluna de data precisa existir, não ter valores nulos em nenhuma linha e conter um único formato (não se pode, por exemplo, misturar os formatos "YYYY-MM-DD" e "DD/MM/YYYY" na mesma coluna);
Valores numéricos: devem ter separador de decimal "." (ponto) e não devem ter separador de milhar;
Gráficos e tabelas dinâmicas: não devem ser incluídos,
Caracteres especiais nos nomes das abas: devem ser evitados.
Se algum cálculo ou validação de dados precisa ser realizada, a recomendação é que isso seja feito sempre em um documento separado, mantendo o documento conectado apenas com os dados a serem integrados, sendo esse usado exclusivamente para o propósito de transferência de dados.
Configurações do provider
O provider recebe os seguintes campos de configuração:
Configuração | Significado |
Spreadsheet URL | Link do documento Google Sheets a ser conectado |
Tabelas disponíveis
Estarão disponíveis para conexão todas as tabelas presentes no documento.
Configurações das tabelas
As configurações devem ser feitas conforme documentado em Entendendo Data Sources. É recomendável fazer uso da configuração de tipos de dados das colunas como garantia de qualidade dos dados.
Limitações
1- O documento precisa ser uma planilha do Google Sheets "nativa". Documentos Excel (.xlsx) hospedados no Google Drive não podem ser usados.
2- Após a conexão de um documento,
Abas conectadas não podem ser renomeadas ou apagadas
Isso levará a erros que exigem o acionamento do suporte da plataforma
Colunas não podem ser renomeadas, apagadas, ou criadas
Isso pode levar a erros que exigem acionamento do suporte
Se é necessário adicionar uma coluna nova na planilha, é necessário recriar a sincronização dessa tabela
3- Em conexões com carga incremental, a atualização considera sempre a última data registrada na tabela como marco de corte para adicionar novos dados.
Presença de datas futuras interrompe a sincronização
Se a planilha contiver datas à frente, o sistema entende que já processou os dados até lá e não atualizará mais.
Exemplo: A planilha tem datas até 2026-01-30; ou seja, o conector entende que o próximo dado "novo" só existirá a partir de 2026-04-01. Não haverá um reprocessamento se for adicionado algo em 2026-01-19, porque no sistema essa data já foi lida.
Manutenção do fluxo de dados
Para corrigir ou evitar o travamento, é necessário remover as linhas com datas futuras na inserção de dados ou resetar os dados dessa tabela a partir da última data em que de fato existem dados.
Ainda com dúvidas? Nossa equipe está pronta para ajudar! Fale conosco pelo suporte ou envie um e-mail para [email protected]