Valores das séries regionais e sociais do Ipeadata¶
Resumo¶
Valores das séries regionais (por exemplo, agências bancárias e despesas dos entes) e sociais (por exemplo, índices de desenvolvimento humano e dados da PNAD Contínua) do Ipeadata. Cada linha traz o território em nivnome e tercodigo, que se juntam à tabela territorios.
Ficha técnica¶
| Campo | Valor |
|---|---|
| Dataset | ipeadata/valores_regional |
| Órgão | Instituto de Pesquisa Econômica Aplicada (Ipea) |
| Página oficial | http://www.ipeadata.gov.br/api/ |
| Licença | Termo de Direitos de Uso do Ipeadata: o conteúdo é informação pública que pode ser livremente distribuída e copiada, com obrigação de citar a fonte Ipeadata; sem garantia de exatidão; http://www.ipeadata.gov.br/iframe_direitouso.aspx |
| Periodicidade | varia por série (trimestral a decenal na amostra; ver series.pernome) |
| Cobertura | 1985 a em-curso |
| Unidade (uma linha) | valor de uma série regional ou social em uma data e um território |
| Granularidade | espacial: Brasil, regiões, estados, municípios e outros níveis (AMC, mesorregião, microrregião, área metropolitana); temporal: da data da observação: trimestre a década, conforme a série |
| Formato bruto | JSON da API OData v4 do Ipeadata (função ValoresSerie), um arquivo por série; um arquivo mistura vários níveis territoriais |
| Estado no lake | convertido |
| Partições | nivel, periodicidade, ano |
| Chave | sercodigo, valdata, nivnome, tercodigo |
| Colunas | 8 |
| Unidades de medida | valvalor: varia por série (series.uninome e series.mulnome); valor: varia por série (series.uninome e series.mulnome) |
| Dados pessoais | nenhum |
| Eras | nenhuma |
| Revisado em | 2026-11-10 |
| Versão do fetcher | 0.3.2 |
Origem e coleta¶
- Mesma coleta de
valores: um JSON por série da funçãoValoresSerie, nas pastasregional/,social/e também emseries/quando a série tem território. - Arquivos no bruto em 2026-11-10: 166 códigos em
regional/(16 com mais de uma versão), 2 emsocial/e 90 códigos deseries/que também estão emregional/. - O conversor decide que a série é regional quando a pasta se chama
regionalou quando alguma linha temNIVNOMEpreenchido.
Conteúdo¶
- Uma linha por série, data e território. Amostra de 9 séries (5 regionais e 2 sociais, mais 2 de
series/): 167.746 linhas, 85 datas distintas de 1985-01-01 a 2026-04-01, 13 níveis territoriais, sem chave repetida. - Níveis na amostra (
nivel): Brasil, Regioes, Estados, Municipios, Microrregioes, Mesorregioes, Area_metropolitana e AMC_* (1872-00, 20-00, 40-00, 60-00, 70-00, 91-00). - Periodicidades na amostra: anual 146.381 linhas, decenal 16.776 e trimestral 4.589.
- A cobertura inicial de 1985 vem da amostra e não vale para todas as séries.
Variáveis¶
| Coluna no lake | Na fonte | Tipo | Descrição | Unidade / códigos | Período |
|---|---|---|---|---|---|
sercodigo |
SERCODIGO | texto | Código da série | — | todo |
valdata |
VALDATA | texto | Data do valor, como a API entrega, com hora e fuso | ISO 8601 | todo |
valvalor |
VALVALOR | decimal | Valor da série na data e no território | varia por série; ver series.uninome e series.mulnome |
todo |
nivnome |
NIVNOME | texto | Nome do nível territorial, como na API | ex.: Municípios, AMC 1872-00 |
todo |
tercodigo |
TERCODIGO | texto | Código do território dentro do nível | código IBGE ou interno; ver territorios |
todo |
data |
— (gerada) | texto | Data no formato AAAA-MM-DD (10 primeiros caracteres de valdata) |
AAAA-MM-DD, texto | todo |
valor |
— (gerada) | decimal | Cópia de valvalor convertida para decimal |
igual a valvalor |
todo |
_origem |
— (conversor) | texto | Série de origem da linha: o código do arquivo bruto (PRECOS_IPCAG); o rodapé do Parquet lista as séries do arquivo (quantilica.members) |
— | todo (depois da reconversão) |
No lake¶
- Dataset
ipeadata/valores_regional, particionado pornivel,periodicidadeeano(ano da data da observação, inteiro):nivel=Municipios/periodicidade=anual/ano=2010/valores_regional_Municipios_anual.parquet, um arquivo por pasta, com as observações de todas as séries daquele nível e ano. Um arquivo da fonte que mistura níveis ou anos aparece em um arquivo por nível e ano. A coluna_origemtraz o código da série de cada linha, e o rodapé do Parquet lista as séries do arquivo (quantilica.members). nivelénivnomesem acento nem espaço (RegiõesviraRegioes,AMC 1872-00viraAMC_1872-00); sem nível, a linha vai paranivel=__HIVE_DEFAULT_PARTITION__.periodicidadecomo emvalores.- Chave natural: (
sercodigo,valdata,nivnome,tercodigo), sem repetição na amostra. - O conversor lê o JSON da série (
ValoresSerie), renomeia as colunas para minúsculas e acrescentadata(os 10 primeiros caracteres devaldata, sem deslocamento de fuso) evalor(valvalorcomo decimal; o que não converte vira nulo). - Textos vazios em
nivnomeetercodigoviram nulo.
Cuidados de uso¶
- Mesma série em mais de uma pasta (mesma causa de
valores): 90 códigos aparecem emregional/eseries/, e 2 emseries/esocial/(PNADCT_PERDESUFePNADCT_TXDSCUPUF). O conversor mantém só a cópia de carimbo mais recente de qualquer pasta. Antes da correção (até a 0.3.2) a última pasta em ordem alfabética substituía as outras mesmo sendo mais antiga: emADMISNC, a cópia deseries/(448.562 linhas, de 2026-11-04) vencia a deregional/(454.175, de 2026-11-05). Se o lake foi gerado por versão anterior, reconverta (veja oCHANGELOG.md). - Junte por nível e código.
tercodigosozinho repete entre níveis; usenivnomeetercodigocomterritorios. - Nome do nível.
nivel(partição) enivnome(coluna) diferem:MunicipioseMunicípios. - Escala e unidade por série. Consulte
series.uninomeeseries.mulnome. - Valores muito grandes. O máximo da amostra é 47,2 bilhões (série de despesa ou crédito); confira a escala antes de agregar níveis.
- Não some níveis. Brasil, regiões, estados e municípios convivem no mesmo dataset; somar todos conta o mesmo valor várias vezes.
- Séries sociais.
base=socialnunca é usada: as séries sociais estão aqui, não emvalores.
Exemplos¶
Valor de uma série para os estados (nível Estados), sem somar com outros níveis:
import duckdb
duckdb.sql("""
SELECT v.data, t.ternome AS estado, v.valor
FROM read_parquet('lake/ipeadata/valores_regional/nivel=Estados/**/*.parquet', hive_partitioning = true) v
JOIN read_parquet('lake/ipeadata/territorios/*.parquet') t
ON t.nivnome = 'Estados' AND t.tercodigo = v.tercodigo
WHERE v.sercodigo = 'DFCOME'
ORDER BY v.data, estado
LIMIT 20
""").show()
Referências¶
- API do Ipeadata (entidades Valores e Territórios): http://www.ipeadata.gov.br/api/
- Direitos de uso: http://www.ipeadata.gov.br/iframe_direitouso.aspx