FAQ - B.I

Este artigo reúne as dúvidas frequentes sobre as configurações do B.I.

1. Qual o principal benefício de migrar a fonte de dados da API para o Athena?

A principal vantagem é a melhora significativa de performance na atualização dos dashboards, especialmente com grandes volumes de dados. A API anterior se mostrava lenta e ineficiente para cenários mais robustos.

2. Onde devo instalar o Gateway e o driver Athena ODBC?

ATENÇÃO! Garanta que a versão (32/64 bits) do driver ODBC corresponda à versão do Power BI Desktop e à do Gateway.

Instale o On-premises Data Gateway apenas em um servidor local, preferencialmente de baixa criticidade (ex.: servidor de impressão). O driver Amazon Athena ODBC deve ser instalado tanto:

• No servidor onde o Gateway está instalado (para as atualizações automáticas);

• Nas máquinas locais dos usuários que editam os arquivos .pbix no Power BI Desktop (para desenvolvimento/edição).

3. Preciso instalar o Gateway na minha máquina local?

DICA: Se não houver servidor, use um computador/mini-PC dedicado (ou VM) que fique 24x7 ligado para dar confiabilidade às atualizações.

ATENÇÃO! Se o computador com o gateway estiver desligado, em suspensão, sem internet ou com credenciais inválidas, as atualizações agendadas falharão. No Power BI Service, verifique o status em Configurações > Gateways e garanta que o gateway apareça com o status 'Online'.

• Recomendado: instalar o Gateway (Padrão) em um servidor local.

• Sem servidor? Pode instalar o Gateway em um computador local que ficará 'hospedando' o gateway. Nesse caso:

  • A atualização automática no Power BI Service/Fabric só funciona se esse computador estiver ligado, com internet e com o serviço do gateway em execução.

  • Evite suspensão/hibernação e quedas de energia/conexão. Configure o Windows para não dormir.

  • Se usar Gateway (Modo Pessoal), a sessão do usuário precisa permanecer ativa; com o Gateway (Padrão), basta o serviço do Windows estar em execução.

  • Instale o driver Amazon Athena ODBC também nessa máquina (além das máquinas de quem edita os .pbix.

4. A atualização dos dashboards é automática após a troca da fonte para Athena?

A atualização é automática apenas depois que o dashboard for publicado no Power BI Service (Fabric) e a fonte de dados estiver associada ao Gateway configurado. Enquanto você trabalhar no arquivo .pbix localmente, a atualização é manual.

5. Como posso agendar a atualização automática no Power BI Service (Fabric)?

• Publique o dashboard (dataset) no Power BI Service;

• Associe a fonte de dados (Athena) ao Gateway instalado no servidor;

• Acesse as configurações do dataset e ative a 'Atualização agendada', definindo os horários desejados.

6. Quais são os horários recomendados para agendar a atualização dos meus dashboards?

IMPORTANTE! Considere o fuso horário da sua operação ao definir os horários no Power BI Service.

O sistema Kartado atualiza sua base às 06h, 09h, 12h, 15h e 18h (processo leva cerca de 1 hora). Recomendamos agendar para: 07h30, 10h30, 13h30, 16h30 e 19h30. Nos finais de semana, a atualização do Kartado ocorre ao meio-dia.

7. Campos dos apontamentos estão vindo em branco ou incorretos. O que fazer?

DICA: Se vários campos de uma mesma tabela passaram a vir em branco de uma vez, verifique alterações recentes no schema do Athena (renomeios, novas partições) e permissões de acesso.

ATENÇÃO! Ajustes feitos localmente no .pbix só impactam o Power BI Service após você PUBLICAR a versão atualizada. Se o dataset online estiver desatualizado, a divergência pode persistir.

• Primeiro, faça estas checagens rápidas:

  • Confirme que você está usando a versão mais recente do arquivo .pbix fornecida.

  • No Power BI Desktop, clique em ATUALIZAR e revalide as credenciais do driver Athena ODBC.

  • Verifique se não houve mudança de nomes de tabelas/colunas no Athena; se houve, baixe o .pbix atualizado ou ajuste as consultas no Power Query.

  • Revise filtros do relatório/modelo, relacionamentos e tipos de dados no Power Query (datas e números).

• Persistindo o problema? Acione a equipe N2 diretamente, já com um exemplo concreto:

  • ID do apontamento afetado e intervalo de datas.

  • Tabela/coluna onde o valor era esperado e não apareceu.

  • Prints do Kartado e do Power BI mostrando a divergência.

  • Nome do workspace e do dataset, horário da última atualização e se foi manual ou agendada.

  • Gateway utilizado e status no momento do erro.

  • Se possível, anexe o .pbix (ou trechos da consulta M/SQL relevantes).

8. Preciso de um novo campo no Athena (ex.: Código SNV, Protocolado ANTT). Como proceder?

• Se o campo já existia na API antiga e precisa ser incluído no Athena, abra uma solicitação para a equipe de Suporte da Kartado (fluxo mais rápido para esse tipo de inclusão).

• Se for um campo novo (que não existia na API), descreva a necessidade ao abrir o chamado para que a equipe avalie viabilidade e prazo.

9. As datas no Power BI estão diferentes das do Kartado, ou os números estão vindo como texto. Por que isso acontece?

ATENÇÃO! A atualização agendada não será executada se o Gateway estiver offline ou com credenciais inválidas.

• Datas diferentes: o Athena utiliza UTC/GMT. Ajuste a conversão de fuso horário no Power BI (Power Query), definindo o fuso adequado ao seu contexto.

• Números como texto: algumas colunas podem vir tipadas como texto. No Power Query, ajuste o tipo de dados para Número/Decimal e, se necessário, use 'Usar local' para aplicar o formato/região corretos.

---