# Dữ liệu Tỉnh thành, Quận huyện Việt Nam
Đây là tập lệnh cơ sở dữ liệu SQL của toàn bộ đơn vị hành chính Việt Nam, bao gồm **34 tỉnh thành** và các Quận huyện, phường xã liên quan.
Dữ liệu được cập nhật theo nghị định gần nhất: [388/NQ-UBTVQH16][source government decree]
**Add-ons mở rộng**:
- Dataset toạ độ địa lý (GIS)
- Dataset mã bưu chính (Postal Code)
Nếu bạn thấy dự án này hữu ích, hãy để lại một ⭐ để ủng hộ nhé — điều đó sẽ tiếp thêm động lực để chúng tôi tiếp tục cải tiến và mang đến những công cụ giá trị cho cộng đồng. Ngoài ra, việc "star" repo cũng giúp bạn dễ dàng theo dõi các bản cập nhật trong tương lai.
## Tổng quan
Tác giả của dự án không làm việc, hay đại diện cho **Tổng cục Thống kê Việt Nam**, lẫn chính phủ nước Việt Nam.
Dữ liệu của Tỉnh thành, Quận huyện và Phường xã được tổng kết và hệ thống dựa trên dữ liệu tỉnh thành được cung cấp bởi [API từ trang web Đơn vị hành chính của Tổng cục Thống kê Việt Nam][source goverment API].
Ngoài ra, cơ sở dữ liệu này còn có thêm những thông tin bổ sung, xin xem chi tiết trong phần **Các thay đổi thêm** ngay bên dưới.
### Các phiên bản của bộ dữ liệu và Nghị định của Chính phủ
Chính phủ Việt Nam có thể ban hành những nghị định để thay đổi cấu trúc của các đơn vị hành chính Việt Nam theo thời gian. Bạn có thể theo dõi danh mục nghị định thay đổi đơn vị được ban hành tại [đây][decree issued page].
Bảng dưới thông kê các nghị định đã được ban hành, cùng thời gian có hiệu lực, cùng phiên bản của bộ dữ liệu tỉnh thành Việt Nam từ phiên bản đầu tiên.
|Nghị định/Mô tả|Ngày ban hành|Ngày có hiệu lực|Phiên bản|
|-------------|-----------|-------------|---------------|
|[39/2026/QH16][decree 39/2026/QH16], [388/NQ-UBTVQH16][decree 388/NQ-UBTVQH16]|04/08/2026|20/09/2026|v5.2.0|
|[36/2026/QH16][decree 36/2026/QH16]; bảng metadata dataset cho tất cả các định dạng|24/08/2026|01/09/2026|v5.1.0|
|Mã bưu chính cho tất cả các định dạng; sửa mã xã Ba Chẽ|---|---|v5.0.0|
|Thêm GIS dataset cho ElasticSearch, MongoDB|---|---|v4.2.0|
|Thêm định dạng GIS GeoJSON, vá tên tiếng Anh, vá dữ liệu GIS của tỉnh Đà Nẵng và Khánh Hòa|---|---|v4.1.0|
|Thêm dữ liệu GIS|---|---|v4.0.0|
|[30/2026/QH16][decree 30/2026/QH16], [237/NQ-UBTVQH16][decree 237/NQ-UBTVQH16]|14/04/2026|30/04/2026|v3.1.0|
|[19/2025/QĐ-TTg][decree 19/2025/QĐ-TTg]|30/06/2025|01/07/2025|v3.0.2|
|Sửa chính tả, cutoff dữ liệu trước 19/2025/QĐ-TTg|15/01/2025|01/03/2025|v2.4.1
|[1365/NQ-UBTVQH15][decree 1365/NQ-UBTVQH15]|15/01/2025|01/03/2025|v2.4.0
|[1314/NQ-UBTVQH15][decree 1314/NQ-UBTVQH15]|30/11/2024|01/01/2025|v2.3.0
|[1203/NQ-UBTVQH15][decree 1203/NQ-UBTVQH15]|28/09/2024|01/11/2024|v2.2.0
|[1106/NQ-UBTVQH15][decree 1106/NQ-UBTVQH15]|23/07/2024|01/09/2024|v2.1.0
|[1013/NQ-UBTVQH15][decree 1013/NQ-UBTVQH15]|19/03/2024|01/05/2024|v2.0.1
|[939/NQ-UBTVQH15][decree 939/NQ-UBTVQH15]|13/12/2023|01/02/2024 |v2.0.0
|Từ [721/NQ-UBTVQH15][decree 721/NQ-UBTVQH15] đến
[730/NQ-UBTVQH15][decree 730/NQ-UBTVQH15]|13/02/2023|10/04/2023 |v1.0.4.1
|[569/NQ-UBTVQH15][decree 569/NQ-UBTVQH15],
[570/NQ-UBTVQH15][decree 570/NQ-UBTVQH15]|11/08/2022|01/10/2022 |v1.0.3.1
|[510/NQ-UBTVQH15][decree 510/NQ-UBTVQH15]|12/05/2022|01/07/2022|v1.0.2
|[469/NQ-UBTVQH15][decree 469/NQ-UBTVQH15]|15/02/2022|10/04/2022|v1.0.1
|[387/NQ-UBTVQH15][decree 387/NQ-UBTVQH15]|22/09/2021|01/11/2021|v1.0.0
### Các thay đổi thêm
- Thêm bảng quan hệ `administrative_regions`
- Thêm bảng quan hệ `administrative_units`
- Đặt dữ liệu tên đơn vị hành chính cho các giá trị tỉnh thành, phường xã
- Tạo các tên riêng bằng tiếng Anh cho các giá trị tỉnh thành, phường xã
- Tạo mã từ tên các tỉnh thành, phường xã
- **Add-on**: Bộ dữ liệu GIS và Mã bưu chính
## Tải xuống
Bạn có thể tải xuống gói dữ liệu (archive) sẵn sàng sử dụng cho hệ quản trị cơ sở dữ liệu hoặc định dạng bạn cần bên dưới. Mỗi gói chứa đầy đủ thư mục dữ liệu của phiên bản phát hành mới nhất.
> Các gói dữ liệu được phát hành cho tag phiên bản mới nhất. Các phiên bản cũ vẫn được lưu trữ theo đường dẫn phiên bản riêng trên CDN.
| Bộ dữ liệu | Định dạng | Phiên bản | Kích thước | Tải xuống |
|------------|-----------|-----------|------------|-----------|
| PostgreSQL / PostGIS | SQL | v5.2.0 | 41.82 MB | [vn_provinces_postgresql_dataset_v5.2.0.zip](https://vn-provinces-ds.thanglequoc.xyz/v5.2.0/postgresql/vn_provinces_postgresql_dataset_v5.2.0.zip) |
| MySQL / MariaDB | SQL | v5.2.0 | 40.70 MB | [vn_provinces_mysql_dataset_v5.2.0.zip](https://vn-provinces-ds.thanglequoc.xyz/v5.2.0/mysql/vn_provinces_mysql_dataset_v5.2.0.zip) |
| Microsoft SQL Server | SQL | v5.2.0 | 41.84 MB | [vn_provinces_sqlserver_dataset_v5.2.0.zip](https://vn-provinces-ds.thanglequoc.xyz/v5.2.0/sqlserver/vn_provinces_sqlserver_dataset_v5.2.0.zip) |
| Oracle | SQL | v5.2.0 | 88.43 KB | [vn_provinces_oracle_dataset_v5.2.0.zip](https://vn-provinces-ds.thanglequoc.xyz/v5.2.0/oracle/vn_provinces_oracle_dataset_v5.2.0.zip) |
| JSON | JSON | v5.2.0 | 96.18 MB | [vn_provinces_json_dataset_v5.2.0.zip](https://vn-provinces-ds.thanglequoc.xyz/v5.2.0/json/vn_provinces_json_dataset_v5.2.0.zip) |
| MongoDB | NoSQL | v5.2.0 | 46.10 MB | [vn_provinces_mongodb_dataset_v5.2.0.zip](https://vn-provinces-ds.thanglequoc.xyz/v5.2.0/mongodb/vn_provinces_mongodb_dataset_v5.2.0.zip) |
| Redis | NoSQL | v5.2.0 | 170.17 KB | [vn_provinces_redis_dataset_v5.2.0.zip](https://vn-provinces-ds.thanglequoc.xyz/v5.2.0/redis/vn_provinces_redis_dataset_v5.2.0.zip) |
| Elasticsearch | NoSQL | v5.2.0 | 42.91 MB | [vn_provinces_elasticsearch_dataset_v5.2.0.zip](https://vn-provinces-ds.thanglequoc.xyz/v5.2.0/elasticsearch/vn_provinces_elasticsearch_dataset_v5.2.0.zip) |
## Hướng dẫn cài đặt
Tạo cơ sở dữ liệu (nếu cần):
```sql
CREATE DATABASE vietnamese_administrative_units;
```
Sau đó thực thi các tập lệnh sau theo đúng thứ tự:
1. `CreateTable_vn_units.sql` – tạo cấu trúc cơ sở dữ liệu.
2. `ImportData_vn_units.sql` – nhập dữ liệu mẫu.
Chọn các tập lệnh tương ứng với hệ quản trị cơ sở dữ liệu bạn đang sử dụng:
| Cơ sở dữ liệu | Thư mục |
|---------------|----------|
| PostgreSQL | `postgresql/` |
| MySQL / MariaDB | `mysql/` |
| Microsoft SQL Server | `sqlserver/` |
| Oracle | `oracle/` |
> Người dùng Oracle có thể sử dụng cơ sở dữ liệu hoặc schema hiện có, vì việc tạo database phụ thuộc vào từng môi trường triển khai.
## Lược đồ quan hệ
### Bảng quan hệ `administrative_regions`
Bảng quan hệ `administrative_regions` chứa danh sách **8** khu vực địa lý của Việt Nam, với định danh `id` tăng dần theo vị trí khu vực theo chiều từ Bắc vào Nam.
#### Cấu trúc bảng dữ liệu
|Cột|Kiểu dữ liệu|Ý nghĩa|Ràng buộc|
|------|-----------|---------|------------|
|`id`|integer|Mã định danh của khu vực|Khoá chính|
|`name`|varchar(255)|Tên khu vực bằng tiếng Việt||
|`name_en`|varchar(255)|Tên khu vực bằng tiếng Anh||
|`code_name`|varchar(255)|Tên mã khu vực bằng tiếng Việt, tạo theo định dạng chữ thường xếp gạch||
|`code_name_en`|varchar(255)|Tên mã khu vực bằng tiếng Anh, tạo theo định dạng chữ thường xếp gạch||
#### Dữ liệu mẫu
|id|name|name_en|code_name|code_name_en|
|--|----|-------|---------|------------|
|1|Đông Bắc Bộ|Northeast|dong_bac_bo|northest|
|2|Tây Bắc Bộ|Northwest|tay_bac_bo|northwest|
|3|Đồng bằng sông Hồng|Red River Delta|dong_bang_song_hong|red_river_delta|
|4|Bắc Trung Bộ|North Central Coast|bac_trung_bo|north_central_coast|
|5|Duyên hải Nam Trung Bộ|South Central Coast|duyen_hai_nam_trung_bo|south_central_coast|
|6|Tây Nguyên|Central Highlands|tay_nguyen|central_highlands|
|7|Đông Nam Bộ|Southeast|dong_nam_bo|southeast|
|8|Đồng bằng sông Cửu Long|Mekong River Delta|dong_bang_song_cuu_long|southwest|
### Bảng quan hệ `administrative_units`
Bảng quan hệ `administrative_units` chứa danh sách các đơn vị hành chính với định danh `id` được xếp theo 2 phân cấp đơn vị hành chính.
#### Cấu trúc bảng dữ liệu
|Cột|Kiểu dữ liệu|Ý nghĩa|Ràng buộc|
|------|-----------|---------|------------|
|`id`|integer|Mã định danh của đơn vị hành chính|Khoá chính|
|`full_name`|varchar(255)|Tên tiếng Việt đầy đủ của đơn vị hành chính||
|`full_name_en`|varchar(255)|Tên tiếng Anh đầy đủ của đơn vị hành chính||
|`short_name`|varchar(255)|Tên tiếng Việt thông dụng của đơn vị hành chính||
|`short_name_en`|varchar(255)|Tên tiếng Anh thông dụng của đơn vị hành chính||
|`code_name`|varchar(255)|Tên mã đơn vị dạng tiếng Việt dựa trên cột `full_name`, tạo theo định dạng chữ thường xếp gạch||
|`code_name_en`|varchar(255)|Tên mã đơn vị dạng tiếng Anh dựa trên cột `full_name_en`, tạo theo định dạng chữ thường xếp gạch||
#### Dữ liệu mẫu
|id|full_name|full_name_en|short_name|short_name_en|code_name|code_name_en|
|--|---------|------------|----------|-------------|---------|------------|
|1|Thành phố trực thuộc trung ương|Municipality|Thành phố|City|thanh_pho_truc_thuoc_trung_uong|municipality|
|2|Tỉnh|Province|Tỉnh|Province|tinh|province|
|3|Phường|Ward|Phường|Ward|phuong|ward|
|4|Xã|Commune|Xã|Commune|xa|commune|
|5|Đặc khu tại hải đảo|Special administrative region|Đặc khu|Special administrative region|dac_khu|special_administrative_region|
### Bảng quan hệ `provinces`
Bảng quan hệ `provinces` chứa danh sách đơn vị hành chính **cấp 1 - Tỉnh thành**, bao gồm **34** thành phố trực thuộc trung ương và tỉnh.
#### Cấu trúc bảng dữ liệu
|Cột|Kiểu dữ liệu|Ý nghĩa|Ràng buộc|
|------|-----------|---------|------------|
|`code`|varchar(20)|Mã đơn vị chính thức, quy ước bởi chính phủ|Khoá chính|
|`name`|varchar(255)|Tên tiếng Việt||
|`name_en`|varchar(255)|Tên tiếng Anh||
|`full_name`|varchar(255)|Tên tiếng Việt đầy đủ kèm tên đơn vị hành chính||
|`full_name_en`|varchar(255)|Tên tiếng Anh đầy đủ kèm tên đơn vị hành chính||
|`code_name`|varchar(255)|Tên mã dựa trên cột `name`, tạo theo định dạng chữ thường xếp gạch||
|`administrative_unit_id`|integer|Mã đơn vị hành chính của đối tượng|Khoá ngoại, liên kết đến bảng `administrative_units.id` |
#### Dữ liệu mẫu
|code|name|name_en|full_name|full_name_en|code_name|administrative_unit_id|
|----|----|-------|---------|------------|---------|----------------------|
|01|Hà Nội|Ha Noi|Thành phố Hà Nội|Ha Noi City|ha_noi|1|
|56|Khánh Hòa|Khanh Hoa|Tỉnh Khánh Hòa|Khanh Hoa Province|khanh_hoa|2|
|79|Hồ Chí Minh|Ho Chi Minh|Thành phố Hồ Chí Minh|Ho Chi Minh City|ho_chi_minh|1|
|96|Cà Mau|Ca Mau|Tỉnh Cà Mau|Ca Mau Province|ca_mau|2|
|..|...........|...........|.....................|................|...........|..|..|
### Bảng quan hệ `wards`
[](https://postimg.cc/mh69gtBJ)
Bảng quan hệ `wards` chứa danh sách **đơn vị hành chính cấp 2**, bao gồm **3321** xã phường, đặc khu.
#### Cấu trúc bảng dữ liệu
|Cột|Kiểu dữ liệu|Ý nghĩa|Ràng buộc|
|------|-----------|---------|------------|
|`code`|varchar(20)|Mã đơn vị chính thức, quy ước bởi chính phủ|Khoá chính|
|`name`|varchar(255)|Tên tiếng Việt||
|`name_en`|varchar(255)|Tên tiếng Anh||
|`full_name`|varchar(255)|Tên tiếng Việt đầy đủ kèm tên đơn vị hành chính||
|`full_name_en`|varchar(255)|Tên tiếng Anh đầy đủ kèm tên đơn vị hành chính||
|`code_name`|varchar(255)|Tên mã dựa trên cột `name`, tạo theo định dạng chữ thường xếp gạch||
|`province_code`|integer|Mã tỉnh thành (`province`) mà đối tượng phường xã này thuộc về|Khoá ngoại, liên kết đến bảng `provinces.code`|
|`administrative_unit_id`|integer|Mã đơn vị hành chính của đối tượng|Foreign Key, references to `administrative_units.id` |
#### Dữ liệu mẫu
|code|name|name_en|full_name|full_name_en|code_name|province_code|administrative_unit_id|
|----|----|-------|---------|------------|---------|-------------|----------------------|
|25920|Tân Hiệp|Tan Hiep|Phường Tân Hiệp|Tan Hiep Ward|tan_hiep|79|3|
|25942|Dĩ An|Di An|Phường Dĩ An|Di An Ward|di_an|79|3|
|25945|Tân Đông Hiệp|Tan Dong Hiep|Phường Tân Đông Hiệp|Tan Dong Hiep Ward|tan_dong_hiep|79|3|
|25951|Đông Hòa|Dong Hoa|Phường Đông Hòa|Dong Hoa Ward|dong_hoa|79|3|
|25966|Lái Thiêu|Lai Thieu|Phường Lái Thiêu|Lai Thieu Ward|lai_thieu|79|3|
|25969|Thuận Giao|Thuan Giao|Phường Thuận Giao|Thuan Giao Ward|thuan_giao|79|3|
|25975|An Phú|An Phu|Phường An Phú|An Phu Ward|an_phu|79|3|
### Bảng quan hệ `vn_provinces_metadata`
Bảng `vn_provinces_metadata` là bảng một dòng mô tả phiên bản dataset đang được cài đặt, giúp ứng dụng biết được phiên bản hiện tại và khi nào cần cập nhật.
#### Định nghĩa bảng
|Cột|Kiểu dữ liệu|Ý nghĩa|
|------|-----------|---------|
|`dataset_version`|varchar(50)|Phiên bản dataset (ví dụ `v5.1.0`)|
|`latest_decree`|varchar(100)|Nghị định mới nhất đã phản ánh trong dữ liệu (ví dụ `36/2026/QH16`)|
|`generated_at`|timestamp|Thời điểm tạo dataset (UTC)|
#### Dữ liệu mẫu
|dataset_version|latest_decree|generated_at|
|--|--|--|
|v5.1.0|36/2026/QH16|2026-09-12 07:42:08|
Thông tin metadata tương tự cũng được xuất cho các định dạng non-SQL: `vn_provinces_metadata.json` (JSON), collection `vn_provinces_metadata` (MongoDB), hash `vnProvincesMetadata` (Redis), và index `vn_provinces_metadata` (Elasticsearch).
## Câu truy vấn SQL mẫu
Bạn có thể dễ dàng viết các câu truy vấn để lấy, lọc dữ liệu tương ứng bằng cách tạo các kết (`JOIN`) giữa các bảng dựa trên giá trị khoá chính, khoá ngoại.
Phía sau là một vài câu truy vấn mẫu để tham khảo:
### Tìm toàn bộ xã phường thuộc quận huyện
Tìm toàn bộ xã phường thuộc **tỉnh Khánh Hoà**
```sql
SELECT w.code, w."name" , w.full_name , w.full_name_en ,au.full_name as administrative_unit_name
FROM wards w
INNER JOIN administrative_units au
ON w.administrative_unit_id = au.id
WHERE w.province_code = '56' -- Khanh Hoa province code
ORDER BY w.code;
```
|code|name|full_name|full_name_en|administrative_unit_name|
|----|----|---------|------------|------------------------|
|22333|Bắc Nha Trang|Phường Bắc Nha Trang|Bac Nha Trang Ward|Phường|
|22366|Nha Trang|Phường Nha Trang|Nha Trang Ward|Phường|
|22390|Tây Nha Trang|Phường Tây Nha Trang|Tay Nha Trang Ward|Phường|
|22402|Nam Nha Trang|Phường Nam Nha Trang|Nam Nha Trang Ward|Phường|
|22411|Bắc Cam Ranh|Phường Bắc Cam Ranh|Bac Cam Ranh Ward|Phường|
|22420|Cam Ranh|Phường Cam Ranh|Cam Ranh Ward|Phường|
|22423|Ba Ngòi|Phường Ba Ngòi|Ba Ngoi Ward|Phường|
|22432|Cam Linh|Phường Cam Linh|Cam Linh Ward|Phường|
### Lấy phiên bản dataset đang cài đặt
```sql
SELECT dataset_version, latest_decree, generated_at FROM vn_provinces_metadata;
```
## Dữ liệu định dạng Non-SQL
Ngoài định dạng SQL, dataset tỉnh thành Việt Nam này cũng cung cấp thêm dưới các định dạng sau:
- Dạng **JSON**, bao gồm bản đầy đủ, tối giản, và tốn giản chỉ có tiếng Việt
- **MongoDB**
- **Redis**
## Dữ liệu mở rộng (Add-ons)
Bên cạnh bộ dữ liệu đơn vị hành chính, repository này còn cung cấp các gói dữ liệu mở rộng tùy chọn nhằm bổ sung thêm tính năng và khả năng sử dụng.
### Bộ dữ liệu GIS
[](https://postimg.cc/k2GPcsBy)
Phần mở rộng GIS cung cấp dữ liệu hình học ranh giới hành chính cho các đơn vị hành chính của Việt Nam và hiện hỗ trợ:
- GeoJSON
- PostgreSQL/PostGIS
- MySQL
- Microsoft SQL Server
- ElasticSearch
- MongoDB
Xem thêm: [Bộ dữ liệu GIS](./docs/gis/README_vi.md)
## Câu hỏi thường gặp
### Dự án này xây dựng dữ liệu từ đâu?
Dữ liệu về các tỉnh và phường được tạo dựa trên [API dữ liệu tỉnh do Tổng cục Thống kê Việt Nam cung cấp trên website chính thức][source goverment API]
Dữ liệu ranh giới GIS được xây dựng dựa trên dữ liệu từ [Bản đồ tra cứu các đơn vị hành chính Việt Nam](https://sapnhap.bando.com.vn), do Nhà xuất bản Tài nguyên, Môi trường và Bản đồ Việt Nam thuộc Bộ Nông nghiệp và Môi trường phát hành.
### Các khoá định danh được định nghĩa dựa trên đâu?
|Bảng quan hệ|Khoá chính|
|-----|-----------|
|`administrative_regions`|Khoá chính: `id`. Tăng dần `1` đến `8` theo vị trí vùng địa lý hướng từ Bắc vào Nam
|`administrative_units`|Khoá chính: `id`. Tăng dần từ `1` đến `5` theo phân cấp bậc đơn vị hành chính
|`provinces`|Khoá chính: `code`. Được quy ước theo đối tượng **Tỉnh thành** do chính phủ ban hành
|`wards`|Khoá chính: `code`. Được quy ước theo đối tượng **Phường xã** do chính phủ ban hành
### Sao không dùng API từ nhà cung cấp khác, hay dataset khác trên thị trường?
Mã đơn vị hành chính được Chính phủ Việt Nam quy định thống nhất, vì vậy các bộ dữ liệu được xây dựng từ cùng một nguồn dữ liệu chính thức nhìn chung đều tương thích với nhau.
Điểm khác biệt lớn nhất của repository này là tính minh bạch của mã nguồn và khả năng duy trì lâu dài. Nhiều bộ dữ liệu công khai khác dần trở nên lỗi thời theo thời gian vì chỉ phát hành dữ liệu đã được sinh sẵn. Repository này công khai toàn bộ quy trình sinh dữ liệu (dataset-generation-scripts), giúp mọi người có thể xem chính xác cách dữ liệu được thu thập, làm sạch, chuẩn hóa và xuất ra. Mọi bước đều minh bạch và có thể tái tạo, giúp bạn dễ dàng kiểm chứng dữ liệu, tùy biến theo nhu cầu, tạo lại dataset mới nhất từ nguồn dữ liệu chính thức, hoặc tiếp tục duy trì dự án ngay cả khi tác giả ban đầu không còn hoạt động nữa.
Repository được phát hành theo MIT License — cứ clone về dùng thôi. Bạn không mất phí, và không cần phải xin phép ai để sử dụng.
### Tại sao mối quan hệ giữa tỉnh và vùng hành chính (region) bị loại bỏ từ phiên bản v3.0.0?
Sau khi số lượng tỉnh được sáp nhập còn 37, các tỉnh mới — chẳng hạn như Phú Thọ, được hình thành từ Vĩnh Phúc, Phú Thọ và Hòa Bình — hiện nay trải dài trên nhiều vùng hành chính trước đây. Do các tỉnh cũ thuộc các vùng khác nhau, nên việc xác định vùng hành chính cho tỉnh mới không còn chính xác nữa.
### Tôi có thể sử dụng bộ dữ liệu này cho các dự án thương mại không?
Có. Hoàn toàn được.
Bộ dữ liệu này được phát hành theo [Giấy phép MIT](LICENSE), cho phép bạn tự do sử dụng, chỉnh sửa và phân phối trong cả các dự án cá nhân lẫn thương mại.
Bạn không cần đăng ký, xin phép tác giả hoặc trả bất kỳ khoản phí cấp phép nào.
Nếu thấy dự án hữu ích, hãy cân nhắc tặng một ngôi sao (⭐) trên GitHub hoặc đóng góp các cải tiến để hỗ trợ cộng đồng.
Kho lưu trữ này là một dự án cộng đồng độc lập và không trực thuộc Tổng cục Thống kê Việt Nam hoặc bất kỳ cơ quan nhà nước nào của Việt Nam. Bộ dữ liệu được cung cấp theo nguyên trạng ("as is"), không kèm theo bất kỳ cam kết hay bảo đảm nào dưới bất kỳ hình thức nào.
### Tôi tìm thấy một vài lỗi trong tệp dữ liệu SQL này?
Nếu bạn có bất kỳ một đề xuất nào có thể cải tiến dự án, xin vui lòng [tạo một Issue](https://github.com/thanglequoc/VietnameseProvincesDatabase/issues) và cung cấp thông tin cụ thể.
Hoặc tốt hơn nữa, bạn có thể đóng góp xây dựng dự án này bằng các [tạo Pull Request](https://github.com/thanglequoc/VietnameseProvincesDatabase/pulls)
Tất cả các đóng góp đến dự án đều được trân trọng ghi nhận.
## Người đóng góp xây dựng
##### Nguồn tham khảo
Bản đồ Việt Nam dùng làm banner từ [vietcentertourist](https://vietcentertourist.com/assets/images/vietnam.png)
[source danhmuchanhchinh gov]: https://danhmuchanhchinh.nso.gov.vn/
[source government decree]: https://danhmuchanhchinh.nso.gov.vn/NghiDinh.aspx
[source goverment API]: https://danhmuchanhchinh.nso.gov.vn/DMDVHC.asmx
[source danhmuchanhchinh gov]: https://danhmuchanhchinh.nso.gov.vn/
[source government decree]: https://danhmuchanhchinh.nso.gov.vn/NghiDinh.aspx
[decree issued page]: https://danhmuchanhchinh.nso.gov.vn/NghiDinh.aspx
[decree 387/NQ-UBTVQH15]: https://thuvienphapluat.vn/van-ban/Bo-may-hanh-chinh/Nghi-quyet-387-NQ-UBTVQH15-thanh-lap-Toa-an-nhan-dan-thanh-pho-Tu-Son-thuoc-tinh-Bac-Ninh-490766.aspx
[decree 469/NQ-UBTVQH15]: https://thuvienphapluat.vn/van-ban/Bo-may-hanh-chinh/Nghi-quyet-469-NQ-UBTVQH15-2022-thanh-lap-phuong-thuoc-thi-xa-Pho-Yen-Thai-Nguyen-504359.aspx
[decree 510/NQ-UBTVQH15]: https://thuvienphapluat.vn/van-ban/Bo-may-hanh-chinh/Nghi-quyet-510-NQ-UBTVQH15-2022-thanh-lap-thi-tran-Phuong-Son-huyen-Luc-Nam-Bac-Giang-516371.aspx
[decree 569/NQ-UBTVQH15]: https://thuvienphapluat.vn/van-ban/Bo-may-hanh-chinh/Nghi-quyet-569-NQ-UBTVQH15-2022-thanh-lap-thi-tran-Binh-Phu-thuoc-huyen-Cai-Lay-Tien-Giang-525909.aspx
[decree 570/NQ-UBTVQH15]: https://thuvienphapluat.vn/van-ban/Bo-may-hanh-chinh/Nghi-quyet-570-NQ-UBTVQH15-2022-thanh-lap-thi-xa-Chon-Thanh-Binh-Phuoc-525910.aspx
[decree 721/NQ-UBTVQH15]: https://thuvienphapluat.vn/van-ban/Bo-may-hanh-chinh/Nghi-quyet-721-NQ-UBTVQH15-2023-thanh-lap-thi-xa-Tinh-Bien-va-phuong-thuoc-thi-xa-An-Giang-556498.aspx
[decree 730/NQ-UBTVQH15]: https://thuvienphapluat.vn/van-ban/Bo-may-hanh-chinh/Nghi-quyet-730-NQ-UBTVQH15-2023-thanh-lap-thi-tran-Kim-Long-thi-tran-Tam-Hong-Vinh-Phuc-556504.aspx
[decree 939/NQ-UBTVQH15]: https://thuvienphapluat.vn/van-ban/Bo-may-hanh-chinh/Nghi-quyet-939-NQ-UBTVQH15-2023-nhap-xa-Thieu-Phu-vao-thi-tran-Thieu-Hoa-Thanh-Hoa-592292.aspx
[decree 1013/NQ-UBTVQH15]: https://thuvienphapluat.vn/van-ban/Bo-may-hanh-chinh/Nghi-quyet-1013-NQ-UBTVQH15-2024-thanh-lap-cac-phuong-thuoc-thi-xa-Go-Cong-Tien-Giang-606022.aspx
[decree 1106/NQ-UBTVQH15]: https://thuvienphapluat.vn/van-ban/Bo-may-hanh-chinh/Nghi-quyet-1106-NQ-UBTVQH15-2024-sap-xep-don-vi-hanh-chinh-cap-xa-Tuyen-Quang-619244.aspx
[decree 1203/NQ-UBTVQH15]: https://thuvienphapluat.vn/banan/tin-tuc/nghi-quyet-ve-sap-xep-don-vi-hanh-chinh-tai-63-tinh-thanh-pho-giai-doan-20232025-11897
[decree 1314/NQ-UBTVQH15]: https://thuvienphapluat.vn/van-ban/Bo-may-hanh-chinh/Nghi-quyet-1314-NQ-UBTVQH15-2024-sap-xep-don-vi-hanh-chinh-cap-huyen-cap-xa-thanh-pho-Hue-634158.aspx
[decree 1365/NQ-UBTVQH15]: https://thuvienphapluat.vn/van-ban/Bo-may-hanh-chinh/Nghi-quyet-1365-NQ-UBTVQH15-2025-thanh-lap-cac-phuong-thuoc-thi-xa-Phu-My-Vung-Tau-640985.aspx
[decree 19/2025/QĐ-TTg]: https://www.nso.gov.vn/default/2025/07/quyet-dinh-ban-hanh-bang-danh-muc-va-ma-so-cac-don-vi-hanh-chinh-viet-nam/
[decree 237/NQ-UBTVQH16]: https://thuvienphapluat.vn/van-ban/Bo-may-hanh-chinh/Nghi-quyet-237-NQ-UBTVQH16-2026-thanh-lap-10-phuong-thuoc-tinh-Dong-Nai-702513.aspx
[decree 30/2026/QH16]: https://thuvienphapluat.vn/van-ban/Bo-may-hanh-chinh/Nghi-quyet-30-2026-QH16-thanh-lap-thanh-pho-Dong-Nai-703888.aspx
[decree 36/2026/QH16]: https://thuvienphapluat.vn/van-ban/Bo-may-hanh-chinh/Nghi-quyet-36-2026-QH16-thanh-lap-thanh-pho-Quang-Ninh-722881.aspx
[decree 39/2026/QH16]: https://thuvienphapluat.vn/van-ban/bo-may-hanh-chinh/Nghi-quyet-39-2026-QH16-thanh-lap-thanh-pho-Bac-Ninh-722250.aspx
[decree 388/NQ-UBTVQH16]: https://thuvienphapluat.vn/van-ban/Bo-may-hanh-chinh/Nghi-quyet-388-NQ-UBTVQH16-2026-thanh-lap-cac-phuong-thuoc-tinh-Bac-Ninh-720767.aspx
