越南省市县行政区划完整数据库
数据集简介
概览
Vietnamese Provinces Database 提供的是越南行政区划单元的完整 SQL(同时也有非 SQL)数据库,覆盖全部 34 个越南省份及其所属的县(district)、乡/坊(ward)级区划。数据以最新生效法令为依据进行更新,仓库同时提供 GIS 数据集与邮政编码数据集作为附加内容。
- 覆盖范围:34 个越南省份,含所属县级、乡级区划
- 数据形式:SQL 脚本 + 非 SQL 数据格式
- 附加数据集:GIS Dataset、Postal Code Dataset
- 许可:MIT license(仓库含 LICENSE 文件,公开免费下载)
数据发布与政府法令
该仓库的数据更新以越南政府最新生效的法令为准,当前数据依据最近生效法令 36/2026/QH16 更新。也就是说,行政区划的名称、层级与编码会随法令调整而变化,使用者应以仓库中对应版本的数据为准。
省级与乡级数据基于越南统计总局(General Statistics Office of Vietnam)网站提供的 API 省级数据生成,保证了数据来源的可追溯性。
本仓库所做的附加改动
除政府法令带来的区划变动外,仓库本身还对数据做了整理与补充,主要包括:
- 提供 GIS 数据集,便于与地理边界相关的空间处理
- 提供邮政编码数据集(Postal Code Dataset)
- 将同一套行政区划数据导出为多种数据库与序列化格式,方便不同技术栈直接导入
下载
仓库提供多格式下载,文件以压缩包形式组织,常见格式包括:
- SQL:
sql - JSON:
json - 压缩包:
zip - 地理数据:
geojson
版本 v5.1.0 的多格式压缩包大小大致在 88.43 KB 至 96.18 MB 之间,例如 PostgreSQL 包约 41.82 MB,JSON 包约 96.18 MB。不同格式体积差异主要来自数据组织方式与附带内容的不同。
安装
仓库按目标数据库或数据存储拆分为多个目录,便于分别导入:
postgresql/mysql/sqlserver/oracle/
脚本方面提供:
CreateTable_vn_units.sql:用于创建行政区划相关表结构ImportData_vn_units.sql:用于导入数据
使用时可先执行建表脚本,再执行数据导入脚本;其他格式(JSON、MongoDB、Redis、Elasticsearch 等)则按对应目录或文件直接使用。
表结构
仓库的表结构围绕行政区划单元组织,已给出的表包括:
administrative_regions表:字段为id、name、name_en、code_name、code_name_enadministrative_units表
其中 administrative_regions 同时提供越南语名称与英文名称,以及对应的编码名称(code_name、code_name_en),便于在系统内以编码稳定关联行政区划。administrative_units 表则用于承载行政单位层级相关信息。
格式与规格
| 项目 | 内容 |
|---|---|
| 官方名称 | vietnamese-provinces-database |
| 覆盖区划 | 全部 34 个越南省份及所属县、乡级区划 |
| 数据依据 | 最新生效法令 36/2026/QH16 |
| 原始数据来源 | 越南统计总局(General Statistics Office of Vietnam)网站 API 省级数据 |
| 文件格式 | sql、json、zip、geojson |
| 数据库格式 | PostgreSQL、MySQL、SQL Server、Oracle、JSON、MongoDB、Redis、Elasticsearch |
| 版本规模 | v5.1.0 压缩包约 88.43 KB 至 96.18 MB(PostgreSQL 41.82 MB、JSON 96.18 MB) |
| 许可 | MIT license |
| 发布/更新日期 | 2026-09-19 |