Mecanismo de busca e repositório de bases de dados brasileiras e internacionais.

Base dos Dados Mais

Uma simples consulta de SQL é o suficiente para cruzamento de bases que você desejar. Sem precisar procurar, baixar, tratar, comprar um servidor e subir clusters.

Nosso repositório traz acesso, rapidez, escala, facilidade, economia, curadoria, e transparência ao cenário de dados no Brasil.

Usando em Python

Instale

pip install basedosdados

Crie seu projeto no BigQuery

É necessário criar um projeto para que você possa fazer as queries no nosso repositório. Ter um projeto é de graça e basta ter uma conta Google (seu gmail por exemplo).

Caso não tenha ainda um projeto, veja aqui como criar um projeto no Google Cloud.

Acesse uma tabela

import basedosdados as bd

df = bd.read_table('br_ibge_pib', 'municipios', billing_project_id="<YOUR-PROJECT>")

Caso esteja acessando da primeira vez, vão aparecer alguns passos para você autenticar seu projeto. Basta seguir os passos na tela!

Faça uma consulta

import basedosdados as bd

# Bens dos candidatos de Tocantins em 2020
query = """
SELECT *
FROM `basedosdados.br_tse_eleicoes.bens_candidato` 
WHERE ano = 2020
AND sigla_uf = 'TO'
"""

df = bd.read_sql(query, billing_project_id="<YOUR-PROJECT>")

Caso esteja acessando da primeira vez, vão aparecer alguns passos para você autenticar seu projeto. Basta seguir os passos na tela!

Veja todos os datasets disponíveis

import basedosdados as bd

bd.list_datasets()

Para saber mais, veja os exemplos ou a documentação da API

Usando em R

Instale

install.packages("bigrquery")

Faça uma consulta

library("bigrquery")

billing_project_id = "<YOUR_PROJECT_ID>"

pib_per_capita = "SELECT 
    pib.id_municipio ,
    pop.ano, 
    pib.PIB / pop.populacao * 1000 as pib_per_capita
FROM `basedosdados.br_ibge_pib.municipios` as pib
INNER JOIN `basedosdados.br_ibge_populacao.municipios` as pop
ON pib.id_municipio = pop.id_municipio AND pib.ano = pop.ano"

d <- bq_table_download(bq_project_query(billing_project_id, pib_per_capita), page_size=500, bigint="integer64")

Tutoriais

Veja exemplos de uso na pasta /examples e acesse também nossos tutoriais no Youtube

💭 Tem alguma ideia ou um exemplo seu para colaborar? Abra um issue e fale com a gente!

Contribua! 🔄

Incentivamos que outras instituições e pessoas contribuam. Veja mais como contribuir aqui.

Apoie 💚

A Base dos Dados já poupou horas da sua vida? Ou permitiu coisas antes impossíveis? Nosso trabalho é quase todo voluntário, mas temos vários custos de infraestrutura, equipe, e outros.

Nos ajude a fazer esse projeto se manter e crescer!

Como citar o projeto 📝

O projeto está licenciado sob a Licença Hipocrática. Sempre que usar os dados cite a fonte como:

Português:

Carabetta, João; Dahis, Ricardo; Israel, Fred; Scovino, Fernanda (2020) Base dos Dados: Repositório de Dados Abertos em https://basedosdados.org.

Inglês:

Carabetta, João; Dahis, Ricardo; Israel, Fred; Scovino, Fernanda (2020) Data Basis: Open Data Repository at https://basedosdados.org.

Idiomas

Documentação está em português (quando possível), código e configurações estão em inglês.

Desenvolvimento

CLI

Suba o CLI localmente

make create-env
. .mais/bin/activate
python setup.py develop

Versionamento

Publique nova versão

poetry version [patch|minor|major]
poetry publish --build

Docs

Atualize os docs adicionando ou editando .md em docs/.

Se for adicionar um arquivo novo, adicione ele em mkdocs.yml sob a chave nav.

Para testar a documentação, rode:

mkdocs serve 

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Ricardo Dahis 🤔 📝 👀 📆 🐛 🚧 💬

Fernanda Scovino 🤔 📖 👀

João Carabetta 🤔 💻 👀 📆 🐛 🚧 💬

polvoazul 🤔 💻 👀 🚇

Diego Oliveira 🤔 💻 📓 👀 🐛

This project follows the all-contributors specification. Contributions of any kind welcome!