library(vigiar)
vigiar_conectar()
# Listar todas as tabelas
tabelas <- vigiar_tabelas()
tabelas5 Exploração do Esquema de Dados
Uma vez conectado, o primeiro passo é entender quais dados estão disponíveis. O pacote oferece múltiplas funções para explorar o esquema do dashboard.
5.1 Listando tabelas disponíveis
5.2 Catálogo completo
A função vigiar_info() retorna um catálogo detalhado com descrições e categorias:
catalogo <- vigiar_info()
catalogoSaída (exemplo):
# A tibble: 28 × 4
tabela colunas descricao categoria
<chr> <int> <chr> <chr>
1 df_anual 12 Medias anuais PM2.5 por municipio Qualidade do Ar
2 df_mensal 14 Medias mensais PM2.5 por municipio (LAT/LON) Qualidade do Ar
3 df_dias 6 Dias acima do limite OMS Qualidade do Ar
4 df_dias_conama 6 Dias acima do limite CONAMA Qualidade do Ar
5 pop 7 Populacao residente por municipio Populacao
6 df_muni 11 Cadastro de municipios Cadastro
7 tb_brasil 13 Indicadores de saude agregados -- BRASIL Indicadores de Saude
8 tb_uf 10 Indicadores de saude agregados -- UF Indicadores de Saude
9 tb_muni 18 Indicadores de saude por MUNICIPIO Indicadores de Saude
10 tb_fracao 12 Fracao atribuivel por indicador Indicadores de Saude
...
5.3 Visualizando o esquema de uma tabela
# Ver colunas e tipos de uma tabela específica
vigiar_esquema("df_anual")Saída:
=== Tabela: df_anual ===
coluna tipo
1 muni character
2 UF character
3 ano integer
4 Media_pm25 numeric
5 Categoria_pm25 character
6 LAT numeric
7 LON numeric
...
5.4 Categorias de tabelas
O dashboard VIGIAR organiza os dados em domínios temáticos:
5.4.1 Qualidade do Ar
| Tabela | Conteúdo | Granularidade |
|---|---|---|
df_anual |
Médias anuais PM2.5 | Município × Ano |
df_mensal |
Médias mensais PM2.5 | Município × Ano × Mês |
df_dias |
Dias críticos (limite OMS: PM2.5 > 15 µg/m³) | Município × Ano × Mês |
df_dias_conama |
Dias críticos (limite CONAMA: PM2.5 > 50 µg/m³) | Município × Ano × Mês |
5.4.2 População
| Tabela | Conteúdo |
|---|---|
pop |
População residente por município, ano e categoria de exposição |
5.4.3 Cadastro
| Tabela | Conteúdo |
|---|---|
df_muni |
Cadastro completo de municípios: região, UF, coordenadas, nomes |
5.4.4 Indicadores de Saúde
| Tabela | Conteúdo |
|---|---|
tb_brasil |
Indicadores de saúde agregados para o Brasil |
tb_uf |
Indicadores de saúde por Unidade Federativa |
tb_muni |
Indicadores de saúde por município (com código IBGE, lat, long) |
tb_fracao |
Fração atribuível por indicador e desfecho de saúde |
tb_quartis |
Quartis dos indicadores (q1, q2, q3) |
5.4.5 Exposição Indoor
| Tabela | Conteúdo |
|---|---|
df_indoor |
Exposição a combustíveis sólidos em domicílios |
df_indoor_desfecho |
Desfechos de saúde associados à poluição indoor |
5.4.6 Medidas e Metadados
| Tabela | Conteúdo |
|---|---|
medidas |
Medidas calculadas: rankings, médias, alertas, proporções |
legenda |
Legenda de cores PM2.5 (padrão OMS) |
legenda_conama |
Legenda de cores PM2.5 (padrão CONAMA) |
5.5 Dicionário de variáveis
O pacote inclui um dicionário documentado de variáveis, cobrindo os domínios pm25, populacao_exposta, indicadores_saude, fracao_atribuivel, exposicao_indoor e municipios (incluindo o cadastro dos 92 municípios do RJ na tabela df_muni):
# Dicionário completo
dict <- vigiar_dicionario()
# Variáveis de um domínio específico
vigiar_variaveis("pm25")
vigiar_variaveis("indicadores_saude")
vigiar_variaveis("exposicao_indoor")
vigiar_variaveis("municipios")
# Esquema resumido de um domínio
vigiar_schema("pm25")
# Descrever uma variável específica
vigiar_descrever_variavel("pm25", "pm25_media_anual")5.6 Variáveis não documentadas
Para identificar colunas que não têm documentação:
5.7 Abrindo a página de convenções
Esta função abre no navegador a página com as convenções de nomenclatura e códigos utilizados pelo pacote.
5.8 Verificando mudanças no schema
O schema do dashboard pode mudar sem aviso prévio. Para detectar alterações:
# Comparar schema atual com um lock file
vigiar_esquema_lock("schema_2026-07.json")
# ... algum tempo depois ...
vigiar_esquema_verificar("schema_2026-07.json")Retorna TRUE se o schema é idêntico, ou lista as diferenças encontradas.
5.9 Tabelas documentadas vs. não documentadas
# Apenas tabelas com documentação completa
vigiar_tabelas_documentadas()5.10 Resumo
Com as funções de exploração, você pode:
-
Listar tabelas com
vigiar_tabelas()evigiar_info() -
Inspecionar colunas com
vigiar_esquema("tabela") -
Consultar o dicionário com
vigiar_dicionario(),vigiar_variaveis()evigiar_schema() -
Detectar mudanças no schema com
vigiar_esquema_verificar() -
Documentar variáveis com
vigiar_descrever_variavel() -
Auditar a documentação com
vigiar_variaveis_nao_documentadas()evigiar_variaveis_orfas()