Colunas

Cada tipo consulta retorna colunas diferentes. Para que esta funcionalidade fosse implementada foi necessário mapear todos os casos em que as colunas se diferem nos diferentes anos, cargos e agregações.

Repositório Eleições por Cargo

Neste caso a padronização das colunas, foi feita no pré-processamento dos arquivos. Logo só foi necessário dividir as colunas por agregação política e agregação regional

Agregação Política - Candidato

Base Padrão

• ANO_ELEICAO
• NUM_TURNO
• DESCRICAO_ELEICAO
• SIGLA_UE
• DESCRICAO_UE
• CODIGO_CARGO
• DESCRICAO_CARGO
• NOME_CANDIDATO
• NUMERO_CANDIDATO
• CPF_CANDIDATO
• NOME_URNA_CANDIDATO
• COD_SITUACAO_CANDIDATURA
• DES_SITUACAO_CANDIDATURA
• NUMERO_PARTIDO
• SIGLA_PARTIDO
• NOME_PARTIDO
• CODIGO_LEGENDA
• SIGLA_LEGENDA
• COMPOSICAO_LEGENDA
• NOME_LEGENDA
• CODIGO_OCUPACAO
• DESCRICAO_OCUPACAO
• DATA_NASCIMENTO
• NUM_TITULO_ELEITORAL_CANDIDATO
• IDADE_DATA_ELEICAO
• CODIGO_SEXO
• DESCRICAO_SEXO
• COD_GRAU_INSTRUCAO
• DESCRICAO_GRAU_INSTRUCAO
• CODIGO_ESTADO_CIVIL
• DESCRICAO_ESTADO_CIVIL
• CODIGO_COR_RACA
• DESCRICAO_COR_RACA
• CODIGO_NACIONALIDADE
• DESCRICAO_NACIONALIDADE
• SIGLA_UF_NASCIMENTO
• COD_MUN_TSE_NASCIMENTO
• NOME_MUNICIPIO_NASCIMENTO
• DESPESA_MAX_CAMPANHA
• COD_SIT_TOT_TURNO
• DESC_SIT_TOT_TURNO
• NM_EMAIL
• TIPO_LEGENDA
• SIGLA_COLIGACAO
• NOME_COLIGACAO
• COMPOSICAO_COLIGACAO
• QTDE_VOTOS

Agregação Política - Legenda

Base Padrão

• ANO_ELEICAO
• NUM_TURNO
• DESCRICAO_ELEICAO
• SIGLA_UE
• DESCRICAO_UE
• CODIGO_CARGO
• DESCRICAO_CARGO
• NUMERO_PARTIDO
• SIGLA_PARTIDO
• NOME_PARTIDO
• QTDE_VOTOS

Agregação Política - Coligação

Base Padrão

• ANO_ELEICAO
• NUM_TURNO
• DESCRICAO_ELEICAO
• SIGLA_UE
• DESCRICAO_UE
• CODIGO_CARGO
• DESCRICAO_CARGO
• SIGLA_COLIGACAO
• NOME_COLIGACAO
• COMPOSICAO_COLIGACAO
• QTDE_VOTOS

Agregação Política - Detalhes da Eleição

Base Padrão

• ANO_ELEICAO
• NUM_TURNO
• DESCRICAO_ELEICAO
• SIGLA_UE
• DESCRICAO_UE
• CODIGO_CARGO
• DESCRICAO_CARGO
• SIGLA_COLIGACAO
• NOME_COLIGACAO
• COMPOSICAO_COLIGACAO
• QTDE_VOTOS

Agregações Regionais

Para agregar em determinada agregação regional, só é necessário Adicionar ou Remover algumas colunas da Base Padrão (Agregação Regional - Brasil)

Agregação Regional - Macro-Região

Adicionar

• CODIGO_MACRO
• NOME_MACRO

Agregação Regional - UF

Adicionar

• UF
• NOME_UF

Agregação Regional - Meso Região

Adicionar

• CODIGO_MESO
• NOME_MESO

Agregação Regional - Micro Região

Adicionar

• CODIGO_MICRO
• NOME_MICRO

Agregação Regional - Município

Adicionar

• COD_MUN_TSE
• COD_MUN_IBGE
• NOME_MUNICIPIO

Agregação Regional - Município-Zona

Adicionar

• NUM_ZONA

Agregação Regional - Zona

Remover

• COD_MUN_TSE
• COD_MUN_IBGE
• NOME_MUNICIPIO

Adicionar

• NUM_ZONA

Sobre as Agregações Regionais Zona e Município-Zona

A coluna NUM_ZONA é um número inteiro e não único para cada zona. Uma Zona pode conter muitos ou nenhum município e um Município pode conter muitas ou nenhuma Zona. São Paulo, por exemplo, possui 35 zonas; enquanto no Acre existem zonas agregando 4 municípios. Esse relacionamento complexo foi o que tornou essas agregações mais difíceis de se organizar.

Repositório Resultados da Eleição

Neste caso a padronização das colunas foi feita no pré-processamento dos arquivos. Logo só foi necessário dividir as colunas por agregação regional.

Como não existe agregação política nessa consulta, só existe uma Base Padrão para as colunas. O processo para as Agregações Regionais se repete.

Base Padrão

• DATA_GERACAO
• HORA_GERACAO
• ANO_ELEICAO
• SIGLA_UE
• NUM_TURNO
• DESCRICAO_ELEICAO
• CODIGO_CARGO
• DESCRICAO_CARGO
• NUMERO_CANDIDATO
• QTDE_VOTOS

Repositório Candidatos

Neste caso a padronização das colunas foi feita no pré-processamento dos arquivos. Logo só existe uma única lista de colunas.

• DATA_GERACAO
• HORA_GERACAO
• ANO_ELEICAO
• NUM_TURNO
• DESCRICAO_ELEICAO
• SIGLA_UF
• SIGLA_UE
• DESCRICAO_UE
• CODIGO_CARGO
• DESCRICAO_CARGO
• NUMERO_PARTIDO
• SIGLA_PARTIDO
• NOME_CANDIDATO
• NUMERO_CANDIDATO
• CPF_CANDIDATO
• NOME_URNA_CANDIDATO
• COD_SITUACAO_CANDIDATURA
• DES_SITUACAO_CANDIDATURA
• NOME_PARTIDO
• CODIGO_LEGENDA
• SIGLA_LEGENDA
• COMPOSICAO_LEGENDA
• NOME_COLIGACAO
• CODIGO_OCUPACAO
• DESCRICAO_OCUPACAO
• DATA_NASCIMENTO
• NUM_TITULO_ELEITORAL_CANDIDATO
• IDADE_DATA_ELEICAO
• CODIGO_SEXO
• DESCRICAO_SEXO
• COD_GRAU_INSTRUCAO
• DESCRICAO_GRAU_INSTRUCAO
• CODIGO_ESTADO_CIVIL
• DESCRICAO_ESTADO_CIVIL
• CODIGO_COR_RACA*
• DESCRICAO_COR_RACA*
• CODIGO_NACIONALIDADE
• DESCRICAO_NACIONALIDADE
• SIGLA_UF_NASCIMENTO
• CODIGO_MUNICIPIO_NASCIMENTO
• NOME_MUNICIPIO_NASCIMENTO
• DESPESA_MAX_CAMPANHA
• COD_SIT_TOT_TURNO
• DESC_SIT_TOT_TURNO
• EMAIL_CANDIDATO*

*Foi aplicada uma correção para garantir a padronização das colunas no decorrer dos anos. As colunas CODIGO_COR_RACA e DESCRICAO_COR_RACA só passam a existir nos anos posteriores à 2014 e a coluna EMAIL_CANDIDATO só passa a existir a partir de 2010

Repositório Legendas

Neste caso a padronização das colunas foi feita no pré-processamento dos arquivos. Logo só existe uma única lista de colunas.

• DATA_GERACAO
• HORA_GERACAO
• ANO_ELEICAO
• NUM_TURNO
• DESCRICAO_ELEICAO
• SIGLA_UF
• SIGLA_UE
• CODIGO_CARGO
• DESCRICAO_CARGO
• TIPO_LEGENDA
• NUMERO_PARTIDO
• SIGLA_PARTIDO
• NOME_PARTIDO
• SIGLA_COLIGACAO
• NOME_COLIGACAO
• COMPOSICAO_COLIGACAO
• SEQUENCIAL_COLIGACAO*

*Uma correção foi aplicada para padronizar a coluna SEQUENCIAL_COLIGACAO, pois ela está presente nos arquivos do repositório como SEQUENCIA_COLIGACAO (faltando um L na palavra SEQUENCIAL)

Ordem das colunas

A ordem em que as colunas são especificadas influencia a ordem do arquivo final. Elas foram organizadas de modo que o ano da eleição é dado pela primeira coluna, seguido das colunas referentes à agregação regional e/ou política (quando disponíveis), e dos dados dados da votação, candidato ou legenda selecionado(a).