https://github.com/vicjun22/script-cidades-e-estados-brasileiros_sql
Repositório contendo Script/Query com todas as cidades e estados do Brasil.
https://github.com/vicjun22/script-cidades-e-estados-brasileiros_sql
banco-de-dados cidades cidades-brasileiras database estados-brasileiros ibge mysql postgresql sql
Last synced: about 1 month ago
JSON representation
Repositório contendo Script/Query com todas as cidades e estados do Brasil.
- Host: GitHub
- URL: https://github.com/vicjun22/script-cidades-e-estados-brasileiros_sql
- Owner: Vicjun22
- Created: 2025-04-10T21:56:16.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-11T01:54:48.000Z (about 1 year ago)
- Last Synced: 2025-04-11T02:31:43.511Z (about 1 year ago)
- Topics: banco-de-dados, cidades, cidades-brasileiras, database, estados-brasileiros, ibge, mysql, postgresql, sql
- Homepage:
- Size: 157 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Script contendo as cidades e estados do Brasil
Este repositório disponibiliza um script SQL para criar e popular as tabelas de **estados** e **cidades do Brasil**, com dados baseados no [IBGE](https://www.ibge.gov.br/cidades-e-estados).
## Objetivo
O objetivo deste repositório é oferecer uma estrutura geográfica nacional completa, facilitando o uso em aplicações ou para fins de estudos.
## Estrutura do Script
O script SQL realiza as seguintes ações:
- Criação da tabela `estados`
- Criação da tabela `cidades`
- Inserção dos 26 estados + Distrito Federal
- Inserção de todas as cidades do Brasil
## Tecnologias e Compatibilidade
O script foi desenvolvido em SQL, utilizando um padrão compatível com os seguintes sistemas de gerenciamento de banco de dados:
[](https://www.postgresql.org/)
[](https://www.mysql.com/)
Caso o script não funcione em algum desses bancos de dados, fique à vontade para abrir uma issue.
## Significado dos nomes das colunas
| Nome da Coluna | Significado | Tipo do Campo |
| ------------------------ | ---------------------------- | -------------------------------- |
| `cd_estado` | Código do Estado | Inteiro |
| `nm_estado` | Nome do Estado | Texto |
| `uf_estado` | UF do Estado | Caractere |
| `nm_capital` | Nome da Capital | Texto |
| `nm_regiao` | Nome da Região | Texto |
| `nu_ddd` | DDD do Estado | Array de inteiros |
| `nu_area` | Área do território em km² | Float |
| `lk_bandeiras` | Link das bandeiras do estado | Texto |
| `nm_clima` | Clima(s) do estado | Array de texto |
| `cd_id` | Código ID (identificador) | Inteiro |
| `nm_cidade` | Nome da Cidade | Texto |
| `cd_ibge` | Código do IBGE | Inteiro |
| `is_capital` | É capital? | Verdadeiro ou Falso (booleano) |
## Como usar?
1. **Baixe o arquivo SQL**
Copie o conteúdo do arquivo [scriptEstadosECidades.sql](https://github.com/Vicjun22/script-cidades-e-estados-brasileiros_sql/blob/main/scriptEstadosECidades.sql).
2. **Carregue no banco de dados**
Cole o script no editor SQL do banco de dados de sua escolha (PostgreSQL, MySQL, etc.).
3. **Execute o script**
Execute o script completo para criar as tabelas e popular os dados.
### Verificando os dados
Após executar o script, você pode validar se os dados foram inseridos corretamente com as seguintes consultas:
- Verificar os estados:
```sql
SELECT * FROM TbEstado;
```
- Verificar as cidades de um estado específico (exemplo: São Paulo):
```sql
SELECT * FROM TbCidade WHERE cd_estado = 35;
```
> **Dica**: O código do estado (coluna `cd_estado`) segue o padrão do IBGE.
## Contribuindo
Achou algum erro nos dados ou precisa de atualizações?
Sinta-se à vontade para abrir uma `Issue` ou enviar um `Pull Request` com sugestões de melhorias no script ou na documentação.
---
Espero que este material seja útil para seus estudos e projetos. Desejo sucesso a todos!
Atenciosamente,
**Victor**