Repository navigation
Bản release v5.2.0 nâng tỉnh Bắc Ninh thành Thành phố Bắc Ninh trực thuộc trung ương theo Nghị quyết 39/2026/QH16 và thành lập 12 phường thuộc Bắc Ninh theo Nghị quyết 388/NQ-UBTVQH16; bảng metadata bộ dữ liệu được cập nhật lên v5.2.0 trên toàn bộ các định dạng.
🏙️ Bắc Ninh trở thành thành phố (Mới)
Theo Nghị quyết 39/2026/QH16 (hiệu lực từ 20/09/2026), tỉnh Bắc Ninh được chuyển thành Thành phố Bắc Ninh trực thuộc trung ương. Thông tin đơn vị hành chính được cập nhật trên toàn bộ các định dạng:
| Trường | Trước | Sau |
|---|---|---|
full_name |
Tỉnh Bắc Ninh | Thành phố Bắc Ninh |
full_name_en |
Bac Ninh Province | Bac Ninh City |
administrative_unit_id |
2 (Tỉnh) | 1 (Thành phố trực thuộc trung ương) |
Mã tỉnh (24), name, name_en, code_name và postal_code_prefix không thay đổi.
🏘️ Thành lập 12 phường thuộc Bắc Ninh (Mới)
Theo Nghị quyết 388/NQ-UBTVQH16, 12 xã thuộc Bắc Ninh được thành lập thành phường. Các bản ghi wards hiện hữu chỉ được cập nhật full_name, full_name_en và administrative_unit_id (4 Xã → 3 Phường); các cột code, name, name_en, code_name, province_code và postal_code không đổi.
| Mã | Tên | full_name trước |
full_name sau |
|---|---|---|---|
07294 |
Bố Hạ | Xã Bố Hạ | Phường Bố Hạ |
07375 |
Lạng Giang | Xã Lạng Giang | Phường Lạng Giang |
07399 |
Kép | Xã Kép | Phường Kép |
07444 |
Lục Nam | Xã Lục Nam | Phường Lục Nam |
07840 |
Hiệp Hoà | Xã Hiệp Hoà | Phường Hiệp Hoà |
09193 |
Yên Phong | Xã Yên Phong | Phường Yên Phong |
09292 |
Phù Lãng | Xã Phù Lãng | Phường Phù Lãng |
09313 |
Chi Lăng | Xã Chi Lăng | Phường Chi Lăng |
09319 |
Tiên Du | Xã Tiên Du | Phường Tiên Du |
09454 |
Gia Bình | Xã Gia Bình | Phường Gia Bình |
09475 |
Nhân Thắng | Xã Nhân Thắng | Phường Nhân Thắng |
09496 |
Lương Tài | Xã Lương Tài | Phường Lương Tài |
Ví dụ tên tiếng Anh: Bo Ha Commune → Bo Ha Ward, Lang Giang Commune → Lang Giang Ward, … (quy tắc chung: … Commune → … Ward).
Không có bản ghi tỉnh/xã nào được thêm hoặc xóa — bộ dữ liệu vẫn giữ 34 tỉnh/thành và 3.321 phường/xã.
🔄 Bảng metadata bộ dữ liệu cập nhật (Cập nhật)
Bảng một dòng vn_provinces_metadata (đã ra mắt ở v5.1.0) được làm mới cho phiên bản này trên toàn bộ các định dạng:
| dataset_version | latest_decree | generated_at |
|---|---|---|
v5.2.0 |
388/NQ-UBTVQH16 |
2026-09-20 13:13:17 (UTC) |
| Định dạng | Tệp / đối tượng metadata |
|---|---|
| PostgreSQL | Bảng vn_provinces_metadata trong postgresql/postgres_ImportData_vn_units.sql |
| MySQL / MariaDB | Bảng vn_provinces_metadata trong mysql/mysql_ImportData_vn_units.sql |
| Microsoft SQL Server | Bảng vn_provinces_metadata trong sqlserver/mssql_ImportData_vn_units.sql |
| Oracle | Bảng vn_provinces_metadata trong oracle/oracle_ImportData_vn_units.sql |
| JSON | json/vn_provinces_metadata.json |
| MongoDB | mongodb/mongo_data_vn_provinces_metadata.json (collection vn_provinces_metadata) |
| Redis | Hash vnProvincesMetadata trong redis/redis_vn_provinces_dataset.redis |
| Elasticsearch | elasticsearch/vn_provinces_metadata.ndjson (index vn_provinces_metadata) |
SELECT dataset_version, latest_decree, generated_at FROM vn_provinces_metadata;🌍 Đồng bộ trên toàn bộ định dạng
Thay đổi dữ liệu (1 tỉnh + 12 phường) được tái sinh đồng nhất trên tất cả các định dạng đã phát hành:
| Định dạng | Tệp dữ liệu chính |
|---|---|
| PostgreSQL / PostGIS | postgresql/postgres_ImportData_vn_units.sql |
| MySQL / MariaDB | mysql/mysql_ImportData_vn_units.sql |
| Microsoft SQL Server | sqlserver/mssql_ImportData_vn_units.sql |
| Oracle | oracle/oracle_ImportData_vn_units.sql |
| JSON | json/full_json_generated_data_vn_units.json, các tệp simplified/minified |
| MongoDB | mongodb/mongo_data_vn_unit.json, mongodb/mongo_data_vn_provinces_metadata.json |
| Redis | redis/redis_vn_provinces_dataset.redis |
| Elasticsearch | elasticsearch/provinces.ndjson, elasticsearch/provinces-gis-part-02.ndjson, metadata |
| GeoJSON / GIS | json/geojson/24_bac_ninh/** (13 tệp) và khối thuộc tính GIS của 13 đơn vị tương ứng |
Lưu ý về GIS: chỉ phần thuộc tính (
fullName,fullNameEn) của 13 đơn vị liên quan được cập nhật. Hình học (geometry) không thay đổi — không có tọa độ hay ranh giới nào bị sửa.
⬆️ Nâng cấp lên v5.2.0
Người dùng nâng cấp từ v5.1.0 (hoặc cũ hơn): chạy tệp patch patch/v5.2.0/v5.2.0_patch.sql trên cơ sở dữ liệu PostgreSQL hiện có. Patch sẽ:
- Cập nhật bản ghi tỉnh Bắc Ninh (
code = '24') thành Thành phố Bắc Ninh (administrative_unit_id = 1). - Cập nhật 12 xã Bắc Ninh thành phường (
administrative_unit_id = 3) trong bảngwards. - Ghi đè bảng
vn_provinces_metadatabằngv5.2.0/388/NQ-UBTVQH16.
Patch dùng các câu UPDATE theo khóa chính và ghi đè metadata nên có thể chạy lại an toàn.
Patch chỉ áp dụng cho PostgreSQL; dữ liệu GIS không nằm trong phạm vi patch.
English version:
The v5.2.0 release promotes Bắc Ninh province to Bắc Ninh City, a centrally-governed municipality, under Resolution 39/2026/QH16, and establishes 12 wards in Bắc Ninh under Resolution 388/NQ-UBTVQH16; the dataset metadata table is refreshed to v5.2.0 across every format.
🏙️ Bắc Ninh Becomes a City (New)
Under Resolution 39/2026/QH16 (effective 20/09/2026), Bắc Ninh province was promoted to Bắc Ninh City, a centrally-governed municipality. The administrative unit information was updated across all formats:
| Field | Before | After |
|---|---|---|
full_name |
Tỉnh Bắc Ninh | Thành phố Bắc Ninh |
full_name_en |
Bac Ninh Province | Bac Ninh City |
administrative_unit_id |
2 (Province) | 1 (Municipality) |
The province code (24), name, name_en, code_name and postal_code_prefix are unchanged.
🏘️ Establishment of 12 Wards in Bắc Ninh (New)
Under Resolution 388/NQ-UBTVQH16, 12 communes of Bắc Ninh were established as wards (phường). The existing wards rows only update full_name, full_name_en and administrative_unit_id (4 Commune → 3 Ward); the code, name, name_en, code_name, province_code and postal_code columns are unchanged.
| Code | Name | full_name before |
full_name after |
|---|---|---|---|
07294 |
Bố Hạ | Xã Bố Hạ | Phường Bố Hạ |
07375 |
Lạng Giang | Xã Lạng Giang | Phường Lạng Giang |
07399 |
Kép | Xã Kép | Phường Kép |
07444 |
Lục Nam | Xã Lục Nam | Phường Lục Nam |
07840 |
Hiệp Hoà | Xã Hiệp Hoà | Phường Hiệp Hoà |
09193 |
Yên Phong | Xã Yên Phong | Phường Yên Phong |
09292 |
Phù Lãng | Xã Phù Lãng | Phường Phù Lãng |
09313 |
Chi Lăng | Xã Chi Lăng | Phường Chi Lăng |
09319 |
Tiên Du | Xã Tiên Du | Phường Tiên Du |
09454 |
Gia Bình | Xã Gia Bình | Phường Gia Bình |
09475 |
Nhân Thắng | Xã Nhân Thắng | Phường Nhân Thắng |
09496 |
Lương Tài | Xã Lương Tài | Phường Lương Tài |
English name example: Bo Ha Commune → Bo Ha Ward, Lang Giang Commune → Lang Giang Ward, … (general rule: … Commune → … Ward).
No province or ward rows were added or removed — the dataset still contains 34 provinces/cities and 3,321 wards.
🔄 Dataset Metadata Table Refreshed (Update)
The single-row vn_provinces_metadata table (introduced in v5.1.0) is refreshed for this release across every format:
| dataset_version | latest_decree | generated_at |
|---|---|---|
v5.2.0 |
388/NQ-UBTVQH16 |
2026-09-20 13:13:17 (UTC) |
| Format | Metadata file / object |
|---|---|
| PostgreSQL | vn_provinces_metadata table in postgresql/postgres_ImportData_vn_units.sql |
| MySQL / MariaDB | vn_provinces_metadata table in mysql/mysql_ImportData_vn_units.sql |
| Microsoft SQL Server | vn_provinces_metadata table in sqlserver/mssql_ImportData_vn_units.sql |
| Oracle | vn_provinces_metadata table in oracle/oracle_ImportData_vn_units.sql |
| JSON | json/vn_provinces_metadata.json |
| MongoDB | mongodb/mongo_data_vn_provinces_metadata.json (vn_provinces_metadata collection) |
| Redis | vnProvincesMetadata hash in redis/redis_vn_provinces_dataset.redis |
| Elasticsearch | elasticsearch/vn_provinces_metadata.ndjson (vn_provinces_metadata index) |
SELECT dataset_version, latest_decree, generated_at FROM vn_provinces_metadata;🌍 Synced Across All Formats
The data change (1 province + 12 wards) is regenerated consistently across every published format:
| Format | Main data file |
|---|---|
| PostgreSQL / PostGIS | postgresql/postgres_ImportData_vn_units.sql |
| MySQL / MariaDB | mysql/mysql_ImportData_vn_units.sql |
| Microsoft SQL Server | sqlserver/mssql_ImportData_vn_units.sql |
| Oracle | oracle/oracle_ImportData_vn_units.sql |
| JSON | json/full_json_generated_data_vn_units.json, simplified/minified files |
| MongoDB | mongodb/mongo_data_vn_unit.json, mongodb/mongo_data_vn_provinces_metadata.json |
| Redis | redis/redis_vn_provinces_dataset.redis |
| Elasticsearch | elasticsearch/provinces.ndjson, elasticsearch/provinces-gis-part-02.ndjson, metadata |
| GeoJSON / GIS | json/geojson/24_bac_ninh/** (13 files) and the GIS property blocks of the same 13 units |
GIS note: only the properties (
fullName,fullNameEn) of the 13 affected units were updated. Geometry is unchanged — no coordinates or boundaries were modified.
⬆️ Upgrading to v5.2.0
Users upgrading from v5.1.0 (or earlier): run the patch file patch/v5.2.0/v5.2.0_patch.sql on an existing PostgreSQL database. The patch will:
- Promote the Bắc Ninh province row (
code = '24') to Bắc Ninh City (administrative_unit_id = 1). - Reclassify 12 Bắc Ninh communes as wards (
administrative_unit_id = 3) in thewardstable. - Overwrite
vn_provinces_metadatawithv5.2.0/388/NQ-UBTVQH16.
The patch uses primary-key UPDATEs and overwrites the metadata table, so it is safe to re-run.
The patch targets PostgreSQL only; GIS data is not covered.