vietnamese-provinces-database

环境要求

• 已安装并可使用的关系型数据库：PostgreSQL、MySQL/MariaDB、SQL Server 或 Oracle 之一
• 对应的数据库命令行客户端（如 psql），用于执行仓库中的 SQL 脚本
• Git，用于获取仓库中的 SQL 脚本文件
• 可选：需要地图渲染或空间分析时，准备支持 GIS 数据的数据库环境

安装与启动步骤

1. 1克隆仓库

   把仓库拉到本地，建表和导数据的 SQL 脚本都在仓库的数据库目录下。

   git clone https://github.com/thanglequoc/vietnamese-provinces-database.git

   复制

2. 2创建数据库

   README 要求先创建数据库承载数据；Oracle 可直接使用已有库/schema，无需新建。

   psql -U postgres -c "CREATE DATABASE vietnamese_administrative_units;"

   复制

3. 3执行建表脚本

   必须先跑建表脚本 CreateTable_vn_units.sql，建立省级、县级、乡级的表结构。

   cd vietnamese-provinces-database && psql -U postgres -d vietnamese_administrative_units -f postgresql/CreateTable_vn_units.sql

   复制

4. 4导入数据集

   再执行 ImportData_vn_units.sql 导入行政区划数据，顺序不能颠倒。

   cd vietnamese-provinces-database && psql -U postgres -d vietnamese_administrative_units -f postgresql/ImportData_vn_units.sql

   复制

5. 5按数据库换脚本

   非 PostgreSQL 用户改选对应目录下的同名脚本：mysql/、sqlserver/、oracle/。

如何确认成功

两个 SQL 脚本执行过程无报错，数据库中可见省份、县、乡相关表且已写入数据。

常见问题

注意事项

• 数据基于越南统计总局官网 API 生成，作者与该机构及越南政府无隶属关系。
• 四个数据库目录（postgresql、mysql、sqlserver、oracle）脚本名相同，注意别拷贝错方言版本。
• 仓库自 2022 年持续维护，使用前建议拉取最新版本以获取最新法令对应的数据。