5  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

library(vigiar)

vigiar_conectar()

# Listar todas as tabelas
tabelas <- vigiar_tabelas()
tabelas

5.2 Catálogo completo

A função vigiar_info() retorna um catálogo detalhado com descrições e categorias:

catalogo <- vigiar_info()
catalogo

Saí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:

  1. Listar tabelas com vigiar_tabelas() e vigiar_info()
  2. Inspecionar colunas com vigiar_esquema("tabela")
  3. Consultar o dicionário com vigiar_dicionario(), vigiar_variaveis() e vigiar_schema()
  4. Detectar mudanças no schema com vigiar_esquema_verificar()
  5. Documentar variáveis com vigiar_descrever_variavel()
  6. Auditar a documentação com vigiar_variaveis_nao_documentadas() e vigiar_variaveis_orfas()