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 63 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: 1203/NQ-UBTVQH15
Hãy để lại một ngôi sao ⭐ trên dự án này nếu bạn thấy nó hữu ích, và để nhận những thông báo về các bản release mới nhất. Điều này giúp khích lệ tinh thần của chúng tôi để chúng tôi tiếp tục cống hiến thêm các sản phẩm mã nguồn mở phục vụ cộng đồng.

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.
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.

Bộ dữ liệu này sẽ liên tục được cập nhật theo nghị định gần nhất có hiệu lực. Để kiểm tra trạng thái và cập nhật bộ dữ liệu hành chính Việt Nam của bạn, hãy làm theo hướng dẫn ở phần Làm sao để cập nhật bộ dữ liệu của tôi?.

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	Ngày ban hành	Ngày có hiệu lực	Phiên bản
1203/NQ-UBTVQH15	28/09/2024	01/11/2024	v2.2.0
1106/NQ-UBTVQH15	23/07/2024	01/09/2024	v2.1.0
1013/NQ-UBTVQH15	19/03/2024	01/05/2024	v2.0.1
939/NQ-UBTVQH15	13/12/2023	01/02/2024	v2.0.0
Từ 721/NQ-UBTVQH15 đến 730/NQ-UBTVQH15	13/02/2023	10/04/2023	v1.0.4.1
569/NQ-UBTVQH15, 570/NQ-UBTVQH15	11/08/2022	01/10/2022	v1.0.3.1
510/NQ-UBTVQH15	12/05/2022	01/07/2022	v1.0.2
469/NQ-UBTVQH15	15/02/2022	10/04/2022	v1.0.1
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 và khu vực cho các giá trị tỉnh thành, quận huyện, 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, quận huyện, phường xã
Tạo mã từ tên các tỉnh thành, quận huyện, phường xã

Hướng dẫn cài đặt

Postgresql

Bạn có thể nạp dữ liệu vào cơ sở dữ liệu hiện có, hoặc tạo một cơ sở dữ liệu mới:

CREATE DATABASE vietnamese_administrative_units;

Chạy tệp CreateTable_vn_units.sql trong thư mục postgresql trước để khởi tạo các bảng và quan hệ cần thiết.
Sau đó chạy tiếp tệp ImportData_vn_units.sql để nạp dữ liệu vào các bảng đã tạo.

MySQL - MariaDB

Bạn có thể nạp dữ liệu vào cơ sở dữ liệu hiện có, hoặc tạo một cơ sở dữ liệu mới:

CREATE DATABASE vietnamese_administrative_units;

Chạy tệp CreateTable_vn_units.sql trong thư mục mysql trước để khởi tạo các bảng và quan hệ cần thiết.
Sau đó chạy tiếp tệp ImportData_vn_units.sql để nạp dữ liệu vào các bảng đã tạo.

Microsoft SQL Server

Bạn có thể nạp dữ liệu vào cơ sở dữ liệu hiện có, hoặc tạo một cơ sở dữ liệu mới:

CREATE DATABASE vietnamese_administrative_units;

Chạy tệp CreateTable_vn_units.sql trong thư mục sqlserver trước để khởi tạo các bảng và quan hệ cần thiết.
Sau đó chạy tiếp tệp ImportData_vn_units.sql để nạp dữ liệu vào các bảng đã tạo.

Oracle

Bạn có thể nạp dữ liệu vào cơ sở dữ liệu hiện có, hoặc tạo một cơ sở dữ liệu mới:

CREATE DATABASE vietnamese_administrative_units;

Chạy tệp CreateTable_vn_units.sql trong thư mục oracle trước để khởi tạo các bảng và quan hệ cần thiết.
Sau đó chạy tiếp tệp ImportData_vn_units.sql để nạp dữ liệu vào các bảng đã tạo.

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 dựa trên bậc của từng phân cấp hành chính từ lớn đến 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	Thành phố thuộc thành phố trực thuộc trung ương	Municipal city	Thành phố	City	thanh_pho_thuoc_thanh_pho_truc_thuoc_trung_uong	municipal_city
4	Thành phố thuộc tỉnh	Provincial city	Thành phố	City	thanh_pho_thuoc_tinh	provincial_city
5	Quận	Urban district	Quận	District	quan	urban_district
6	Thị xã	District-level town	Thị xã	Town	thi_xa	district_level_town
7	Huyện	District	Huyện	District	huyen	district
8	Phường	Ward	Phường	Ward	phuong	ward
9	Thị trấn	Commune-level town	Thị trấn	Township	thi_tran	commune_level_town
10	Xã	Commune	Xã	Commune	xa	commune

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 63 thành phố trực thuộc trung ương và tỉnh.
Mã đơn vị code và full_name dựa trên tệp tin CSV gốc.

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`
`administrative_region_id`	integer	Mã vùng địa lý mà đối tượng thuộc về	Khoá ngoại, liên kết đến bảng `administrative_regions.id`

Dữ liệu mẫu

code	name	name_en	full_name	full_name_en	code_name	administrative_unit_id	administrative_region_id
01	Hà Nội	Ha Noi	Thành phố Hà Nội	Ha Noi City	ha_noi	1	3
30	Hải Dương	Hai Duong	Tỉnh Hải Dương	Hai Duong Province	hai_duong	2	3
46	Thừa Thiên Huế	Thua Thien Hue	Tỉnh Thừa Thiên Huế	Thua Thien Hue Province	thua_thien_hue	2	4
48	Đà Nẵng	Da Nang	Thành phố Đà Nẵng	Da Nang City	da_nang	1	5
79	Hồ Chí Minh	Ho Chi Minh	Thành phố Hồ Chí Minh	Ho Chi Minh City	ho_chi_minh	1	7
..	...........	...........	.....................	................	...........	..	..

Bảng quan hệ `districts`

Bảng quan hệ districts chứa danh sách đơn vị hành chính cấp 2 - Quận huyện, bao gồm 705 thành phố thuộc thành phố trung ương, quận, thị xã, huyện và thành phố trực thuộc tỉnh.
Mã đơn vị code và full_name dựa trên tệp tin CSV gốc.

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 quận huyện 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	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	province_code	administrative_unit_id
001	Ba Đình	Ba Dinh	Quận Ba Đình	Ba Dinh District	ba_dinh	01	5
002	Hoàn Kiếm	Hoan Kiem	Quận Hoàn Kiếm	Hoan Kiem District	hoan_kiem	01	5
003	Tây Hồ	Tay Ho	Quận Tây Hồ	Tay Ho District	tay_ho	01	5
004	Long Biên	Long Bien	Quận Long Biên	Long Bien District	long_bien	01	5
005	Cầu Giấy	Cau Giay	Quận Cầu Giấy	Cau Giay District	cau_giay	01	5
...	........	........	.............	.................	........	..	..

Bảng quan hệ `wards`

Bảng quan hệ wards chứa danh sách đơn vị hành chính cấp 3 - cấp Phường xã, bao gồm 10599 phường, xã và thị trấn. Mã đơn vị code và full_name dựa trên tệp tin CSV gốc.

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
`district_code`	integer	Mã quận huyện (`district`) mà đối tượng phường xã này thuộc về	Khoá ngoại, liên kết đến bảng `districts.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	district_code	administrative_unit_id
25942	Dĩ An	Di An	Phường Dĩ An	Di An Ward	di_an	724	8
25945	Tân Bình	Tan Binh	Phường Tân Bình	Tan Binh Ward	tan_binh	724	8
25948	Tân Đông Hiệp	Tan Dong Hiep	Phường Tân Đông Hiệp	Tan Dong Hiep Ward	tan_dong_hiep	724	8
25951	Bình An	Binh An	Phường Bình An	Binh An Ward	binh_an	724	8
25954	Bình Thắng	Binh Thang	Phường Bình Thắng	Binh Thang Ward	binh_thang	724	8
-----	-----	-------	---------	-----------	----------	---	--

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ộ Tỉnh thành theo khu vực địa lý

Tìm toàn bộ tỉnh thành thuộc vùng Duyên hải Nam Trung Bộ (định danh id của vùng = 5)

SELECT p.code, p."name" , p.full_name , p.full_name_en ,au.full_name as administrative_unit_name
FROM provinces p
INNER JOIN administrative_units au 
ON p.administrative_unit_id = au.id 
WHERE p.administrative_region_id = 5
ORDER BY code;

code	name	full_name	full_name_en	administrative_unit_name
48	Đà Nẵng	Thành phố Đà Nẵng	Da Nang City	Thành phố trực thuộc trung ương
49	Quảng Nam	Tỉnh Quảng Nam	Quang Nam Province	Tỉnh
51	Quảng Ngãi	Tỉnh Quảng Ngãi	Quang Ngai Province	Tỉnh
52	Bình Định	Tỉnh Bình Định	Binh Dinh Province	Tỉnh
54	Phú Yên	Tỉnh Phú Yên	Phu Yen Province	Tỉnh
56	Khánh Hòa	Tỉnh Khánh Hòa	Khanh Hoa Province	Tỉnh
58	Ninh Thuận	Tỉnh Ninh Thuận	Ninh Thuan Province	Tỉnh
60	Bình Thuận	Tỉnh Bình Thuận	Binh Thuan Province	Tỉnh

Tìm toàn bộ quận huyện thuộc tỉnh

Tìm toàn bộ quận huyện thuộc tỉnh Khánh Hoà

SELECT d.code, d."name" , d.full_name , d.full_name_en ,au.full_name as administrative_unit_name
FROM districts d 
INNER JOIN administrative_units au 
ON d.administrative_unit_id = au.id
WHERE d.province_code = '56' -- Khanh Hoa province code
ORDER BY d.code;

code	name	full_name	full_name_en	administrative_unit_name
568	Nha Trang	Thành phố Nha Trang	Nha Trang City	Thành phố thuộc tỉnh
569	Cam Ranh	Thành phố Cam Ranh	Cam Ranh City	Thành phố thuộc tỉnh
570	Cam Lâm	Huyện Cam Lâm	Cam Lam District	Huyện
571	Vạn Ninh	Huyện Vạn Ninh	Van Ninh District	Huyện
572	Ninh Hòa	Thị xã Ninh Hòa	Ninh Hoa Town	Thị xã
573	Khánh Vĩnh	Huyện Khánh Vĩnh	Khanh Vinh District	Huyện
574	Diên Khánh	Huyện Diên Khánh	Dien Khanh District	Huyện
575	Khánh Sơn	Huyện Khánh Sơn	Khanh Son District	Huyện
576	Trường Sa	Huyện Trường Sa	Truong Sa District	Huyện

Tìm toàn bộ xã phường thuộc quận huyện

Tìm toàn bộ xã phường thuộc huyện Ninh Hoà

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.district_code = '572' -- Ninh Hoa town code
ORDER BY w.code;

code	name	full_name	full_name_en	administrative_unit_name
22528	Ninh Hiệp	Phường Ninh Hiệp	Ninh Hiep Ward	Phường
22531	Ninh Sơn	Xã Ninh Sơn	Ninh Son Commune	Xã
22534	Ninh Tây	Xã Ninh Tây	Ninh Tay Commune	Xã
22537	Ninh Thượng	Xã Ninh Thượng	Ninh Thuong Commune	Xã
22540	Ninh An	Xã Ninh An	Ninh An Commune	Xã
22543	Ninh Hải	Phường Ninh Hải	Ninh Hai Ward	Phường
22546	Ninh Thọ	Xã Ninh Thọ	Ninh Tho Commune	Xã
-----	--------	-----------	------	-----
(Các dòng kết quả tiếp theo đã được lược bớt để dễ đọc)

Câu hỏi thường gặp

Dự án này xây dựng dữ liệu từ đâu?

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 tệp tin CSV (Excel) tải trực tiếp từ trang web Đơn vị hành chính của Tổng cục Thống kê Việt Nam
Bạn có thể truy cập trang web trên, đánh dấu vào ô Quận Huyện, Phường Xã, và bấm nút Xuất Excel để tải về tệp CSV (Excel).

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 `10` 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
`districts`	Khoá chính: `code`. Được quy ước theo đối tượng Quận huyện 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

Tôi không thể tìm thấy Quận 2, Quận 9 và Quận Thủ Đức trong cơ sở dữ liệu này?

Quận 2, Quận 9 và Quận Thủ Đức đã chính thức sáp nhập thành thành phố Thủ Đức, là thành phố trực thuộc thành phố Hồ Chí Minh từ đầu năm 2021. Tất cả các Phường xã của 3 quận kể trên được liên kết trực tiếp đến cùng một đối tượng Quận huyện là Thành phố Thủ Đức, mã định danh code là 769

Làm sao để cập nhật bộ dữ liệu của tôi?

Chính phủ Việt Nam có thể ban hành nghị định để thay đổi tổ chức hành chính của Việt Nam theo thời gian.
Để kiểm tra trạng thái của bộ dữ liệu ở máy của bạn, hãy chạy tệp patch_checker.sql, và chạy thủ công những bản vá theo từng nghị định trong thư mục patch
Ví dụ kết quả khi chạy lệnh kiểm tra patch_checker

nghidinh_469_nq_ubtvqh15	vietnamese_provinces_dataset_up_to_date
true	true

Hoặc bạn có thể làm mới lại toàn bộ dữ liệu hành chính Việt Nam của bạn bằng cách gỡ toàn bộ các liên kết khoá ngoại đến các bảng thuộc bộ dữ liệu hành chính Việt Nam, rồi xoá toàn bộ các bảng dữ liệu hành chính hiện tại, tạo và nạp lại các bảng và bộ dữ liệu hành chính mới nhất, và tái khai báo lại các liên kết khoá ngoại từ các bảng dữ liệu hiện hành của bạn.

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 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
Tất cả các đóng góp đến dự án đều được trân trọng ghi nhận.

Nguồn tham khảo

Bản đồ Việt Nam dùng làm banner từ vietcentertourist

Files

README_vi.md

Latest commit

History

README_vi.md

File metadata and controls

Dữ liệu Tỉnh thành, Quận huyện Việt Nam

Tổng quan

Các phiên bản của bộ dữ liệu và Nghị định của Chính phủ

Các thay đổi thêm

Hướng dẫn cài đặt

Postgresql

MySQL - MariaDB

Microsoft SQL Server

Oracle

Lược đồ quan hệ

Bảng quan hệ administrative_regions

Cấu trúc bảng dữ liệu

Dữ liệu mẫu

Bảng quan hệ administrative_units

Cấu trúc bảng dữ liệu

Dữ liệu mẫu

Bảng quan hệ provinces

Cấu trúc bảng dữ liệu

Dữ liệu mẫu

Bảng quan hệ districts

Cấu trúc bảng dữ liệu

Dữ liệu mẫu

Bảng quan hệ wards

Cấu trúc bảng dữ liệu

Dữ liệu mẫu

Câu truy vấn SQL mẫu

Tìm toàn bộ Tỉnh thành theo khu vực địa lý

Tìm toàn bộ quận huyện thuộc tỉnh

Tìm toàn bộ xã phường thuộc quận huyện

Câu hỏi thường gặp

Dự án này xây dựng dữ liệu từ đâu?

Các khoá định danh được định nghĩa dựa trên đâu?

Tôi không thể tìm thấy Quận 2, Quận 9 và Quận Thủ Đức trong cơ sở dữ liệu này?

Làm sao để cập nhật bộ dữ liệu của tôi?

Tôi tìm thấy một vài lỗi trong tệp dữ liệu SQL này?

Nguồn tham khảo

Bảng quan hệ `administrative_regions`

Bảng quan hệ `administrative_units`

Bảng quan hệ `provinces`

Bảng quan hệ `districts`

Bảng quan hệ `wards`