Como gerenciar uma conexão de dados

Antes de começar

Para criar uma conexão do zero, veja Como criar uma conexão de dados.
O gerenciamento de conexões é feito na página Data Sources, disponível apenas para perfis Analyst.

Editar uma conexão

Na página Data Sources, é possível editar tanto o nome quanto a frequência de atualização definidos durante a criação da Connection. Para isso:

No menu lateral, clique em Data Sources.
Na página Data Sources, localize a conexão correspondente à tabela que você deseja editar.
Na linha da conexão, clique no menu ⁝.
Selecione Edit Connection para acessar o modal e gerenciar as configurações.

Dica: Use este menu para ajustes rápidos (nome e frequência) sem precisar recriar a conexão.

Menu de opções: Dependendo do tipo de conexão, o menu pode trazer: Edit, Re-authenticate (conexões que dependem de login/token, como Google Sheets), Trigger Sync, Reset Connection (só aparece em conexões com sincronização automática/incremental — não em uploads manuais de CSV) e Delete.

Antes de reautenticar uma conexão

Antes de reautenticar, confirme se a conta usada para fazer login tem acesso à conta de origem dos dados no provedor, com as permissões necessárias. O perfil configurado na Uncover não substitui esse acesso.

Confira os requisitos de cada provedor:

Google (Ads, Analytics e DV360): a conta usada para fazer login precisa estar adicionada à conta ou ao partner de origem, conforme o serviço.
TikTok Ads: o usuário técnico precisa estar cadastrado como membro da conta de anúncios.
Meta Ads: a conta usada para fazer login precisa ter acesso ao Business Manager e à conta de anúncios de origem.
Google Sheets: a conta usada para reautenticar precisa ter, no mínimo, permissão de leitura sobre a planilha de origem. Um usuário que não criou a conexão original pode não ter esse acesso liberado, mesmo tendo acesso normal à Uncover.

Se a pessoa com acesso à origem não estiver mais disponível, a reautenticação só é possível com outra conta que também tenha permissão sobre o documento. O Suporte não consegue contornar essa exigência.

Forçar a sincronização de uma conexão

Para forçar uma sincronização de dados:

No menu lateral, clique em Data Sources.
Na página Data Sources, localize a conexão correspondente à tabela que você deseja sincronizar.
Na linha da conexão, clique no menu ⁝.
Selecione Trigger Sync para forçar uma sincronização daquela conexão.
No modal Sync Connection, escolha quais tabelas devem ser sincronizadas. Todas vêm marcadas por padrão: desmarque as que não precisam de atualização.
Clique em Trigger Sync para confirmar.

Dica: Sincronizar apenas as tabelas necessárias deixa o processo mais rápido e evita reprocessar tabelas que já estão atualizadas.

Resetar uma conexão

A opção de resetar as conexões incrementais permite remover dados que já constam na plataforma. Para resetar siga os passos abaixo:

No menu lateral, clique em Data Sources.
Na página Data Sources, localize a conexão correspondente à tabela que você deseja resetar.
Na linha da conexão, clique no menu ⁝.
Selecione Reset Connection para acessar o modal e acessar as configurações.
Selecione o modo de resetar: Full ou Partial (defindo a partir de que data os dados devem ser apagados).
Selecione a tabela que você deseja resetar.

Ao solicitar um reset, você pode informar a partir de qual data os dados devem ser apagados. Os dados serão apagados dessa data em diante e, em sincronizações subsequentes, serão consultados dados de datas posteriores à data mais recente que consta na plataforma (ou seja, o comportamento usual de uma conexão incremental).

Depois de resetar, as próximas sincronizações vão continuar a partir do período mais recente disponível na plataforma.

Status de atualização

Depois de integrar seus dados, a página Data Sources ajuda a confirmar se suas conexões estão saudáveis e se as tabelas estão sincronizando como esperado.

Use os ícones de status para fazer um diagnóstico rápido. Para ver detalhes, passe o mouse sobre os avisos.

Campo	Descrição
Data Source	nome da conexão e tabelas
Sync	estado da sincronização e possíveis falhas
Rules	aplicação das regras de harmonização
Excellence	consistência dos dados com os critérios de Data Excellence da plataforma
Time Range	período de dados disponíveis
Last Sync	tempo desde a última sincronização

Como usar esta tela para checar suas conexões

Encontre a conexão que você acabou de configurar.
Verifique se a(s) tabela(s) está(ão) com status ✅.
Se houver ❌, passe o mouse no ícone para ler a mensagem de erro.
Confirme se o Time Range inclui o período que você esperava ver.
Confira o Last Sync para entender há quanto tempo a plataforma leu os dados.

Status

✅ Conexão ativa e sem erros
⚠️ Alerta identificado (ex.: inconsistência com Data Excellence, erro ao obter status). Passe o mouse para ver a mensagem
🔄 Sincronizando dados
⊘ Nenhuma sincronização foi disparada ainda
(sem status) Informações insuficientes para determinar o estado

💡 Clique na seta ao lado do nome da conexão para expandir a linha e ver o status de cada tabela individualmente, ou use Add tables para incluir novas tabelas a essa conexão.

Observações

Excellence: indica se os dados da conexão estão consistentes com os critérios de Data Excellence da plataforma; passe o mouse para ver o detalhe
Time Range: "No data" indica que ainda não há dados ou a tabela está vazia

Ainda com dúvidas?
Nossa equipe está pronta para ajudar! Fale conosco pelo suporte ou envie um e-mail para support@uncover.co