# Instalar o devtools se necessário
install.packages("devtools")
# Instalar o vigiar do GitHub
devtools::install_github("santosry/vigiar")3 Instalação e Configuração
3.1 Instalação do R e RStudio
Se você ainda não tem o R instalado:
- Acesse https://cran.r-project.org
- Faça o download para o seu sistema operacional
- Execute o instalador
Recomendamos também o RStudio (ou Positron) como IDE:
3.2 Instalação do pacote vigiar
3.2.1 Via GitHub (recomendado)
3.2.2 Instalação local
Se você baixou o arquivo .tar.gz do pacote:
install.packages("vigiar_0.7.2.tar.gz", repos = NULL, type = "source")3.3 Dependências
O pacote requer os seguintes pacotes R. Eles serão instalados automaticamente:
| Pacote | Versão mínima | Função |
|---|---|---|
httr2 |
qualquer | Requisições HTTP para a API do Power BI |
jsonlite |
qualquer | Parsing de JSON (queries e respostas) |
tibble |
qualquer | Data frames modernos (tibbles) |
dplyr |
qualquer | Manipulação de dados |
cli |
qualquer | Mensagens formatadas no console |
checkmate |
qualquer | Validação de argumentos |
openssl |
qualquer | Checksums SHA256 |
rlang |
qualquer | Estruturas de programação funcional |
tools |
base | Utilitários do R (integridade de arquivos) |
3.3.1 Instalação manual das dependências
install.packages(c(
"httr2", "jsonlite", "tibble", "dplyr", "cli",
"checkmate", "openssl", "rlang"
))3.3.2 Dependências opcionais
# Para exportação Parquet
install.packages("arrow")
# Para geração de relatórios
install.packages(c("knitr", "rmarkdown"))
# Para visualização
install.packages("ggplot2")
# Para testes
install.packages(c("testthat", "withr"))3.4 Carregando o pacote
Ao carregar, o pacote exibe informações sobre a versão e o estado:
# vigiar 0.7.2 — VIGIAR Environmental Health Data
# Duvida dos dados antes de confiar neles.
# 92 municipios do RJ • 9 macrorregioes SES-RJ
# Execute vigiar_conectar() para iniciar.
3.5 Verificando a instalação
# Verificar versão
packageVersion("vigiar")
# Verificar funções disponíveis
ls("package:vigiar")
# Teste rápido (requer internet)
library(vigiar)
# Conectar ao dashboard
vigiar_conectar()
# Listar tabelas
vigiar_tabelas()
# Ver informações do catálogo
vigiar_info()
# Desconectar
vigiar_desconectar()3.6 Solução de Problemas na Instalação
3.6.1 Erro no Windows: “Rtools is required”
Se você encontrar este erro ao instalar do GitHub, instale o RTools:
- Acesse https://cran.r-project.org/bin/windows/Rtools/
- Baixe e instale a versão apropriada para sua versão do R
- Durante a instalação, marque a opção para adicionar ao PATH
3.6.2 Erro de compilação no Linux
Instale as dependências de sistema:
# Ubuntu/Debian
sudo apt-get install libssl-dev libcurl4-openssl-dev
# Fedora/RHEL
sudo dnf install openssl-devel libcurl-devel3.6.3 Erro: “there is no package called…”
Certifique-se de que as dependências estão instaladas:
deps <- c("httr2", "jsonlite", "tibble", "dplyr", "cli",
"checkmate", "openssl", "rlang")
install.packages(setdiff(deps, installed.packages()[,"Package"]))3.7 Configuração do ambiente
3.7.1 Diretório de cache
O pacote vigiar pode armazenar dados em cache local para acelerar downloads repetidos:
# Configurar diretório de cache
vigiar_cache_dir("~/vigiar_cache")
# Verificar configuração atual
vigiar_cache_info()3.7.2 Timeout de download
Para tabelas muito grandes, aumente o timeout:
# Aumentar timeout global do R (em segundos)
options(timeout = 300)
# Ou especificar por operação
vigiar_baixar("df_anual", timeout = 120)3.7.3 Renv (reprodutibilidade)
Para projetos que exigem reprodutibilidade estrita, use o renv:
install.packages("renv")
renv::init()
renv::install("santosry/vigiar")
renv::snapshot()