vigiar_conectar(refresh = TRUE)16 Perguntas Frequentes (FAQ)
16.1 Conexão e Sessão
16.1.1 A sessão expira? Como renovar?
Sim. As sessões do Power BI expiram após algumas horas de inatividade. Para renovar:
Se encontrar erro 403 (Forbidden), a sessão expirou.
16.1.2 Posso ter múltiplas sessões simultâneas?
Não. O pacote mantém uma única sessão no ambiente interno .vigiar_env. Use vigiar_desconectar() e depois vigiar_conectar() para trocar.
16.1.3 O dashboard ficou fora do ar. O que fazer?
O dashboard do Ministério da Saúde pode passar por manutenções. Aguarde alguns minutos e tente novamente. Você pode verificar o status:
vigiar_status()16.2 Download
16.2.1 A API limita a ~30 mil linhas. Como baixar tabelas maiores?
A API do Power BI trunca respostas em aproximadamente 30 mil linhas (ver Limitações metodológicas). Use vigiar_baixar_rj() que implementa download particionado (ASC + DESC) para cobrir todo o range. Se mesmo assim não for suficiente:
- Baixe por ano:
vigiar_baixar("df_anual", uf = "RJ", ordenar_por = "ano") - Use filtros combinados de ano e UF
- Para tabelas muito grandes, baixe em lotes e combine
16.2.2 Como baixar dados de todos os estados?
pm25_brasil <- vigiar_baixar("df_anual", uf = NULL)Cuidado: isso pode exceder o limite de ~30 mil linhas (ver Limitações metodológicas). Para análises nacionais, considere baixar estado por estado.
16.2.3 O download está muito lento. Como melhorar?
-
Use cache:
vigiar_baixar_com_cache("df_anual") -
Aumente o timeout:
vigiar_baixar("df_anual", timeout = 300) -
Baixe apenas colunas necessárias:
vigiar_baixar("df_anual", colunas = c("ano", "UF", "pm25")) - Verifique sua conexão com a internet
16.2.4 Posso baixar dados para análise em tempo real?
O VIGIAR não é um sistema de monitoramento em tempo real. Os dados são atualizados periodicamente (geralmente anual). O dashboard reflete a última atualização disponível. Use vigiar_status() para verificar se há dados novos.
16.3 Schema e Mudanças
16.3.1 O dashboard mudou e o pacote parou de funcionar. O que fazer?
- Execute
vigiar_status()para diagnosticar - Execute
vigiar_conectar(refresh = TRUE)para obter o schema atualizado - Use
vigiar_esquema_verificar("schema_lock.json")para ver diferenças - Se tabelas foram renomeadas/removidas, adapte seu código
- Reporte o problema em: github.com/santosry/vigiar/issues
16.3.2 Como garantir reprodutibilidade se o schema muda?
-
Trave o schema com
vigiar_esquema_lock() -
Use snapshots com
vigiar_snapshot()evigiar_salvar_snapshot() - Versione o arquivo de lock e os snapshots com git
-
Documente a versão do pacote usada (
packageVersion("vigiar"))
16.4 Dados
16.4.1 Os dados do VIGIAR são oficiais?
Sim. Os dados vêm diretamente do dashboard público do VIGIAR (Ministério da Saúde). No entanto:
- O dashboard é uma ferramenta de visualização, não um repositório oficial de dados
- Os dados podem ser preliminares ou estar em atualização
- Sempre valide os dados antes de usar em análises
- Cite a fonte: Ministério da Saúde / VIGIAR
16.4.2 Qual a diferença entre data de processamento e data do evento?
Para o VIGIAR, os dados representam médias anuais/mensais calculadas, não eventos individuais. A data nos dados é o ano de referência da medição.
16.4.3 Dados de PM2.5: são medições ou estimativas?
Os dados de PM2.5 no VIGIAR são uma combinação de: - Medições de estações de monitoramento (onde disponíveis) - Estimativas por satélite - Modelagem estatística
Consulte a documentação do VIGIAR para detalhes metodológicos.
16.4.4 Por que alguns municípios não têm dados?
Possíveis razões: - Sem estação de monitoramento: municípios pequenos podem não ter medições - Dados insuficientes: menos de 75% dos dias do ano com medição - Falha na coleta: problemas técnicos nas estações - Atualização pendente: dados ainda não processados
Use vigiar_checar_cobertura_espacial() para identificar municípios faltantes.
16.5 Processamento e Validação
16.5.1 Preciso sempre processar os dados?
Sim, recomendamos fortemente. Os dados brutos do Power BI têm nomes de colunas inconsistentes e tipos incorretos. O processamento:
- Padroniza nomes (
muni→cod_municipio) - Corrige tipos (
character→integerpara códigos) - Adiciona classes S3 para métodos especializados
- Adiciona metadados (tabela de origem, timestamp)
16.5.2 Posso pular a validação?
Não recomendamos. A validação é rápida e detecta problemas que podem invalidar análises. O custo de não validar é muito maior que o tempo gasto.
16.5.3 O que faço se a validação encontrar problemas?
| Severidade | Ação |
|---|---|
aviso |
Documente a ressalva, prossiga com cautela |
problema |
Investigue a causa, considere excluir registros problemáticos |
crítico |
Não use os dados. Refaça o download ou reporte o problema |
16.6 Integração
16.6.1 Posso usar o vigiar junto com o microdatasus?
Sim! Ambos usam códigos IBGE de 6 dígitos para municípios, permitindo joins diretos:
library(vigiar)
library(microdatasus)
library(dplyr)
# VIGIAR: poluição do ar
vigiar_conectar()
pm25 <- process_pm25(vigiar_baixar_rj("df_anual"), tipo = "anual")
# microdatasus: mortalidade
sim <- fetch_datasus(2020, 2020, uf = "RJ", "SIM-DO")
sim <- process_sim(sim)
# Join pelo código do município
dados <- pm25 |>
filter(ano == 2020) |>
left_join(sim, by = c("cod_municipio" = "CODMUNRES"))16.6.2 Posso usar vigiar em um pipeline de CI/CD (GitHub Actions)?
Sim. Configure o cache no workflow:
- name: Cache VIGIAR data
uses: actions/cache@v4
with:
path: ~/vigiar_cache
key: vigiar-${{ hashFiles('schema_lock.json') }}E use vigiar_baixar_com_cache() no script.
16.7 Erros Comuns
16.7.1 “Nao foi possivel extrair o telemetrySessionId”
- O dashboard pode estar fora do ar
- Sua conexão pode estar bloqueada (firewall, proxy)
- Tente acessar o dashboard pelo navegador primeiro
16.7.2 “Nenhuma sessao ativa”
Execute vigiar_conectar() antes de qualquer operação.
16.7.3 Timeout em downloads grandes
# Aumente o timeout global
options(timeout = 600)
# Ou por operação
vigiar_baixar("df_anual", timeout = 300)16.7.4 Erro 403 Forbidden
Sessão expirada. Execute vigiar_conectar(refresh = TRUE).
16.8 Qualidade, testes e API
16.8.1 Como rodar os testes sem internet?
A suíte é offline por padrão. As chamadas ao Power BI são substituídas por respostas sintéticas e há um dado de exemplo embutido:
devtools::test()
data(pm25_rj_sample)Veja o capítulo Qualidade, Testes e Desenvolvimento.
16.8.2 Como saber se uma função é estável?
# Status de uma função específica
vigiar_lifecycle("vigiar_conectar")
# Registro completo (estável x experimental)
vigiar_lifecycle()