Vagas em disputa (consulta_vagas)¶
Resumo¶
Quantidade de vagas por cargo e unidade eleitoral, com a data de posse. O fetcher não baixa este conjunto e o lake não o tem: o conversor reconhece os arquivos pelo nome, mas nenhum foi convertido.
Ficha técnica¶
| Campo | Valor |
|---|---|
| Dataset | tse/vagas |
| Órgão | Tribunal Superior Eleitoral (TSE) |
| Página oficial | https://dadosabertos.tse.jus.br/dataset/candidatos-2024 |
| Licença | Creative Commons Attribution (CC BY), conforme os conjuntos no portal de dados abertos do TSE: http://www.opendefinition.org/licenses/cc-by. Nenhuma restrição de coleta ou de redistribuição foi encontrada nas páginas dos conjuntos. |
| Periodicidade | diária segundo o portal de dados abertos (conjunto de candidatos) |
| Cobertura | 2024 a 2024 |
| Unidade (uma linha) | as vagas de um cargo em uma unidade eleitoral |
| Granularidade | espacial: unidade eleitoral (município ou UF), com UF; temporal: eleição (ano) |
| Formato bruto | ZIP do CDN do TSE; CSV em Latin-1, separador ponto e vírgula, campos entre aspas duplas |
| Estado no lake | so-bruto |
| Partições | ano, uf |
| Chave | — |
| Colunas | — |
| Unidades de medida | — |
| Dados pessoais | nenhum |
| Eras | nenhuma |
| Revisado em | 2026-11-10 |
| Versão do fetcher | 0.3.3 |
Origem e coleta¶
- O fetcher não baixa este conjunto. O catálogo do fetcher (
candidatos,bens,votacao,prestacao_contas) não o inclui, e o bruto conferido em 2026-11-10 não tem nenhum arquivo dele. O conversorLakeConverteraceita o idvagase reconhece arquivos pelo prefixo do nome, se alguém os colocar no diretório de entrada. - A fonte publica
consulta_vagas_<ano>.zipemhttps://cdn.tse.jus.br/estatistica/sead/odsele/consulta_vagas/(um ZIP por ano). Para este documento foi baixado, diretamente do CDN e só para conferência, o ZIP de 2024 (cabeçalho e LEIAME).
Conteúdo¶
- Unidade de análise: as vagas de um cargo em uma unidade eleitoral.
- Cobertura: nada no lake. O cabeçalho abaixo foi conferido no ZIP de 2024 do CDN em 2026-11-10; layouts de outros anos não foram conferidos.
Variáveis¶
Colunas do CSV de 2024 e descrições do LEIAME oficial do TSE; onde o texto não define a variável, a célula diz "não informado pela fonte". Como o dataset não está no lake, esta tabela não é verificada contra um esquema de referência e a coluna "Tipo" indica o tipo que o conversor usaria (texto).
| Coluna no lake | Na fonte | Tipo | Descrição | Unidade / códigos | Período |
|---|---|---|---|---|---|
dt_geracao |
DT_GERACAO |
texto | Data da extração dos dados para geração do arquivo. | — | todo |
hh_geracao |
HH_GERACAO |
texto | Hora da extração dos dados para geração do arquivo com base no horário de Brasília. | — | todo |
ano_eleicao |
ANO_ELEICAO |
texto | Ano de referência da eleição para geração do arquivo. | — | todo |
cd_tipo_eleicao |
CD_TIPO_ELEICAO |
texto | Código do tipo de eleição. | . 1: Eleição Suplementar; . 2: Eleição Ordinária; e . 3: Consulta Popular. | todo |
nm_tipo_eleicao |
NM_TIPO_ELEICAO |
texto | Nome do tipo de eleição. | — | todo |
cd_eleicao |
CD_ELEICAO |
texto | Código único da eleição no âmbito da Justiça Eleitoral. | — | todo |
ds_eleicao |
DS_ELEICAO |
texto | Descrição da eleição. | — | todo |
dt_eleicao |
DT_ELEICAO |
texto | Data da ocorrência da eleição. | — | todo |
dt_posse |
DT_POSSE |
texto | Data de posse da eleição. | — | todo |
sg_uf |
SG_UF |
texto | Sigla da unidade da federação na qual a candidata ou candidato concorre na eleição. | — | todo |
sg_ue |
SG_UE |
texto | Sigla da unidade eleitoral na qual a candidata ou candidato concorre na eleição. A unidade eleitoral representa a unidade da federação ou o município em que a candidata ou o candidato concorre na eleição e é relacionada à abrangência territorial desta (...) | — | todo |
nm_ue |
NM_UE |
texto | Nome da unidade eleitoral da candidata ou candidato. Em caso de abrangência nacional, é igual a "Brasil". Em caso de abrangência estadual, é o nome da UF em que a candidata ou candidato concorre. Em caso de abrangência municipal, é o nome do município em que (...) | — | todo |
cd_cargo |
CD_CARGO |
texto | Código do cargo ao qual a candidata ou candidato concorre. | — | todo |
ds_cargo |
DS_CARGO |
texto | Descrição do cargo ao qual a candidata ou candidato concorre. | — | todo |
qt_vaga |
QT_VAGA |
texto | Quantidade de vagas para aquele cargo, agrupadas por unidade eleitoral. | — | todo |
No lake¶
- Estado:
so-bruto. Não há datasettse/vagasno lake e, portanto, não há esquema de referência. - Se o conjunto for baixado e convertido, o conversor o gravaria particionado por
anoeuf(partiçãoufa partir do nome do membro,__HIVE_DEFAULT_PARTITION__paraBR/BRASIL) com todas as colunas em texto, como nos demais datasets.
Cuidados de uso¶
- Quando for convertido, o ZIP traria também
BRASIL(eBR) junto com as UFs, e o conversor atual os leria todos: a dupla contagem descrita nos outros datasets se repetiria. - Não conferido: linhas, nulos e chave.
Exemplos¶
Ainda não há dados no lake para este dataset. Depois de baixar e converter o conjunto, a leitura segue o padrão dos outros datasets (cada ano em lake/tse/vagas/ano=<ano>/), por exemplo:
import polars as pl
df = pl.scan_parquet("lake/tse/vagas/ano=2024/uf=__HIVE_DEFAULT_PARTITION__/*_brasil.parquet")
O caminho acima é só ilustrativo e não foi executado: o dataset não existe no lake.
Referências¶
- Conjunto no portal: https://dadosabertos.tse.jus.br/dataset/candidatos-2024
- Repositório de dados eleitorais (CDN): https://cdn.tse.jus.br/estatistica/sead/odsele/consulta_vagas/
- Layout:
leiame.pdfdentro do ZIP