Data Schemas
Trang này đọc trực tiếp schema-family registry. Không duy trì các schema mẫu riêng cho từng dataset.
Public dataset envelope
Mọi adapter bên ngoài dùng cùng một khung object.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
canonicalId | string | Có | Mã định danh bất biến của dataset. |
identity | object | Có | Taxonomy, title, scope, geography, schema ID/version. |
data.highlights | HighlightItem[] | Có | Instant result có cấu trúc label + value + unit + context?. |
data.columns | Column[] | Không | Định nghĩa cột bảng hiện hành. |
data.records | Record[] | Có | Các dòng dữ liệu có cấu trúc của dataset. |
freshness | object | Có | Version, trạng thái, ngày cập nhật, chu kỳ và chính sách refresh. |
provenance | object | Có | Nguồn, publisher, URL, source date, license và redistribution. |
links | object | Có | HTML, JSON, CSV và Embed của cùng dataset. |
Schema families
19 hợp đồng family hiện có trong registry.
bop.statistical-seriesChuỗi thống kêv2.2.0
bop.statistical-seriesChuỗi thống kêIdentity keys: name + geography + period
Coverage complete when: Every indicator/geography/period row in the named source table and declared scope is included; selected examples do not qualify.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
period | period | Có | Kỳ dữ liệu · semantic role: time |
geography | string | Có | Địa bàn · semantic role: geography |
value | number | Có | Giá trị · semantic role: measure |
unit | string | Có | Đơn vị · semantic role: classification |
frequency | string | Không | Tần suất · semantic role: classification |
methodology | string | Không | Phương pháp · semantic role: classification |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.statistical-cubeBảng thống kê đa chiềuv2.3.1
bop.statistical-cubeBảng thống kê đa chiềuIdentity keys: name + period + geography + category + scenario + variable · name + period + geography + category + scenario · name + period + geography + category + variable · name + period + geography + category
Coverage complete when: All declared dimension combinations from one named published table or bounded query are present, including explicit missing/suppressed cells when the source defines them.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
period | period | Có | Kỳ dữ liệu · semantic role: time |
geography | string | Có | Địa bàn · semantic role: geography |
category | string | Có | Phân tổ · semantic role: classification |
value | number | Có | Giá trị · semantic role: measure |
unit | string | Có | Đơn vị · semantic role: classification |
scenario | string | Không | Kịch bản · semantic role: classification |
variable | string | Không | Biến · semantic role: classification |
methodology | string | Không | Phương pháp · semantic role: classification |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.entity-registryDanh mục thực thểv2.2.0
bop.entity-registryDanh mục thực thểIdentity keys: record_id · name + geography + category
Coverage complete when: Every entity in the specifically named current registry/list publication is included; the registry boundary and edition are identified.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
record_id | string | Không | Mã định danh · semantic role: identity |
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
geography | string | Không | Địa bàn · semantic role: geography |
category | string | Không | Phân loại · semantic role: classification |
status | string | Không | Trạng thái · semantic role: classification |
effective_date | date | Không | Ngày hiệu lực · semantic role: time |
description | string | Không | Mô tả · semantic role: description |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.facility-registryDanh mục cơ sởv2.2.0
bop.facility-registryDanh mục cơ sởIdentity keys: record_id · name + facility_type + geography
Coverage complete when: Every facility in one named authoritative registry or bounded official publication is represented; do not imply a global inventory from samples.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
record_id | string | Không | Mã định danh · semantic role: identity |
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
facility_type | string | Có | Loại cơ sở · semantic role: classification |
geography | location | Có | Địa bàn · semantic role: geography |
operator | string | Không | Đơn vị vận hành · semantic role: classification |
status | string | Không | Trạng thái · semantic role: classification |
capacity | number | Không | Công suất · semantic role: measure |
unit | string | Không | Đơn vị · semantic role: classification |
address | string | Không | Địa chỉ · semantic role: geography |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.organization-directoryDanh bạ tổ chứcv2.3.0
bop.organization-directoryDanh bạ tổ chứcIdentity keys: record_id · registry_id · name + geography + organization_type
Coverage complete when: All organizations in the named register or explicitly bounded official directory are included.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
record_id | string | Không | Mã định danh · semantic role: identity |
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
organization_type | string | Không | Loại tổ chức · semantic role: classification |
geography | location | Không | Địa bàn · semantic role: geography |
status | string | Không | Trạng thái · semantic role: classification |
registry_id | string | Không | Mã đăng ký · semantic role: classification |
website | string | Không | Website · semantic role: classification |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.service-directoryDanh mục dịch vụv2.3.0
bop.service-directoryDanh mục dịch vụIdentity keys: record_id · name + provider
Coverage complete when: All entries in the complete authoritative service directory within the dataset's declared scope are included; identify the directory owner, publication/snapshot boundary, pagination and known exclusions.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
record_id | string | Không | Mã định danh · semantic role: identity |
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
service_type | string | Có | Loại dịch vụ · semantic role: classification |
provider | string | Có | Đơn vị cung cấp · semantic role: classification |
geography | string | Không | Địa bàn · semantic role: geography |
eligibility | string | Không | Điều kiện tiếp cận · semantic role: classification |
channel | string | Không | Kênh cung cấp · semantic role: classification |
contact | string | Không | Liên hệ · semantic role: classification |
status | string | Không | Trạng thái · semantic role: classification |
official_url | url | Không | Trang chính thức · semantic role: provenance |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.market-snapshotẢnh chụp thị trườngv2.3.0
bop.market-snapshotẢnh chụp thị trườngIdentity keys: name + metric + market + geography + observation_date · name + metric + geography + observation_date
Coverage complete when: All products/instruments and quote metrics (such as bid/ask or buy/sell) in the publisher board at one explicit observation time are included.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
metric | string | Có | Chỉ tiêu báo giá · semantic role: classification |
observation_date | date | Có | Ngày quan sát · semantic role: time |
geography | string | Có | Địa bàn · semantic role: geography |
value | scalar | Có | Giá trị · semantic role: measure |
unit | string | Có | Đơn vị · semantic role: classification |
market | string | Không | Thị trường · semantic role: classification |
currency | string | Không | Tiền tệ · semantic role: classification |
source_timestamp | string | Không | Thời điểm nguồn · semantic role: time |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.crypto-market-pricesBảng giá tài sản sốv1.0.0
bop.crypto-market-pricesBảng giá tài sản sốIdentity keys: coin_id + source_timestamp
Coverage complete when: The declared top-10-by-market-cap CoinGecko asset snapshot is complete at the captured time; each row uses the same CoinGecko coin identity, USD and VND quotes, 24-hour percentage change, and USD market capitalization. Do not substitute a calculated VND conversion for CoinGecko’s VND quote.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
coin_id | string | Không | Mã định danh · semantic role: identity |
name | string | Có | Tên coin · semantic role: identity |
symbol | string | Có | Mã tài sản · semantic role: identity |
price_usd | number | Có | Giá (USD) · semantic role: measure · unit: USD/coin |
price_vnd | number | Có | Giá (VND) · semantic role: measure · unit: VND/coin |
change_24h_percent | number | Có | Thay đổi 24 giờ (%) · semantic role: measure · unit: % |
market_cap_usd | number | Có | Vốn hóa (USD) · semantic role: measure · unit: USD |
source_timestamp | string | Có | Ngày snapshot nguồn · semantic role: time |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.legal-rule-tableBảng quy định pháp lýv2.3.0
bop.legal-rule-tableBảng quy định pháp lýIdentity keys: document_number + name · record_id · name + effective_date
Coverage complete when: All rules, thresholds, categories, and exceptions in the named law/version or bounded official table are represented.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
record_id | string | Không | Mã định danh · semantic role: identity |
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
document_number | string | Không | Số hiệu · semantic role: classification |
issuing_authority | string | Không | Cơ quan ban hành · semantic role: classification |
effective_date | date | Không | Ngày hiệu lực · semantic role: time |
issue_date | string | Không | Ngày ban hành · semantic role: classification |
status | string | Không | Tình trạng · semantic role: classification |
category | string | Không | Phân loại · semantic role: classification |
description | string | Có | Nội dung · semantic role: description |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.classification-referenceBảng mã và phân loạiv2.2.0
bop.classification-referenceBảng mã và phân loạiIdentity keys: code + version · record_id · name + parent_code + version
Coverage complete when: All codes at each declared hierarchy level, including auxiliary/unspecified codes included by the source, are represented for the selected edition.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
record_id | string | Không | Mã định danh · semantic role: identity |
code | string | Có | Mã · semantic role: identity |
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
parent_code | string | Không | Mã cấp trên · semantic role: classification |
level | string | Không | Cấp phân loại · semantic role: classification |
category | string | Không | Nhóm · semantic role: classification |
description | string | Không | Định nghĩa · semantic role: description |
version | string | Không | Phiên bản · semantic role: classification |
published_at | date | Không | Thời điểm công bố · semantic role: time |
geography | string | Không | Địa bàn · semantic role: geography |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.event-feedDòng sự kiệnv2.7.0
bop.event-feedDòng sự kiệnIdentity keys: record_id · name + occurred_at + geography
Coverage complete when: Every source item in the explicitly stated completed time window and event class is included; state pagination/window boundaries.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
record_id | string | Không | Mã định danh · semantic role: identity |
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
occurred_at | date | Có | Thời điểm xảy ra · semantic role: time |
published_at | date | Không | Thời điểm công bố · semantic role: time |
geography | location | Không | Địa bàn · semantic role: geography |
category | string_or_string_list | Không | Loại sự kiện · semantic role: classification |
status | string | Không | Trạng thái · semantic role: classification |
description | string | Không | Mô tả · semantic role: description |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.alert-feedDòng cảnh báov2.2.0
bop.alert-feedDòng cảnh báoIdentity keys: record_id · name + published_at + geography · name + published_at
Coverage complete when: All active alerts or alerts issued in the declared bounded window from the named official alert feed are included.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
record_id | string | Không | Mã định danh · semantic role: identity |
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
published_at | date | Có | Thời điểm công bố · semantic role: time |
geography | string | Không | Địa bàn · semantic role: geography |
category | string | Không | Loại cảnh báo · semantic role: classification |
severity | string | Không | Mức độ · semantic role: classification |
status | string | Không | Trạng thái · semantic role: classification |
description | string | Không | Nội dung cảnh báo · semantic role: description |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.permit-license-registryDanh mục giấy phépv2.3.0
bop.permit-license-registryDanh mục giấy phépIdentity keys: license_number · record_id · name + authority
Coverage complete when: All licenses or licensed entities in the named authority register or bounded published list are included, with pagination and status filters accounted for; when the publication reports assessment outcomes rather than per-license particulars, preserve that distinction and use the publication edition as the snapshot date.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
record_id | string | Không | Mã định danh · semantic role: identity |
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
license_number | string | Không | Số giấy phép · semantic role: classification |
holder | string | Không | Chủ thể được cấp · semantic role: classification |
authority | string | Có | Cơ quan cấp · semantic role: classification |
issue_date | string | Không | Ngày cấp · semantic role: classification |
effective_date | date | Không | Ngày hiệu lực · semantic role: time |
expiry_date | string | Không | Ngày hết hạn · semantic role: classification |
status | string | Có | Trạng thái · semantic role: classification |
geography | location | Không | Địa bàn · semantic role: geography |
category | string | Không | Loại giấy phép · semantic role: classification |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.infrastructure-registryDanh mục hạ tầngv2.2.0
bop.infrastructure-registryDanh mục hạ tầngIdentity keys: record_id · name + infrastructure_type + geography
Coverage complete when: Every named asset in the declared official registry/publication is included; planned assets are distinguished from commissioned assets.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
record_id | string | Không | Mã định danh · semantic role: identity |
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
infrastructure_type | string | Có | Loại hạ tầng · semantic role: classification |
geography | location | Có | Địa bàn · semantic role: geography |
capacity | number | Không | Công suất · semantic role: measure |
unit | string | Không | Đơn vị · semantic role: classification |
status | string | Không | Trạng thái · semantic role: classification |
operator | string | Không | Đơn vị vận hành · semantic role: classification |
commissioned_date | string | Không | Ngày vận hành · semantic role: classification |
description | string | Không | Mô tả · semantic role: description |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.transport-network-registryMạng lưới giao thôngv2.3.0
bop.transport-network-registryMạng lưới giao thôngIdentity keys: record_id · trip_code + origin + destination + departure_time · name + origin + destination + geography + departure_time · name + origin + destination + geography
Coverage complete when: All links/assets or services in one named official network plan, timetable, or bounded operational register are included; identify the publication boundary, validity window, and distinguish planned from operating infrastructure.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
record_id | string | Không | Mã định danh · semantic role: identity |
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
network_type | string | Có | Loại mạng lưới · semantic role: classification |
origin | string | Không | Điểm đầu · semantic role: classification |
destination | string | Không | Điểm cuối · semantic role: classification |
geography | location | Không | Địa bàn · semantic role: geography |
length | number | Không | Chiều dài · semantic role: measure |
unit | string | Không | Đơn vị · semantic role: classification |
capacity | number | Không | Năng lực · semantic role: measure |
status | string | Không | Trạng thái · semantic role: classification |
operator | string | Không | Đơn vị vận hành · semantic role: classification |
trip_code | string | Không | Mã chuyến/tuyến · semantic role: classification |
departure_time | string | Không | Giờ khởi hành · semantic role: classification |
arrival_time | string | Không | Giờ đến · semantic role: classification |
operating_days | string_list | Không | Ngày hoạt động · semantic role: classification |
valid_from | date | Không | Ngày bắt đầu áp dụng · semantic role: time |
valid_to | date | Không | Ngày kết thúc áp dụng · semantic role: time |
effective_date | date | Không | Ngày hiệu lực · semantic role: time |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.environmental-observationQuan trắc môi trườngv2.5.0
bop.environmental-observationQuan trắc môi trườngIdentity keys: record_id · name + indicator + station + geography + observation_date · name + indicator + geography + observation_date · name + indicator + station + geography + period · name + indicator + geography + period
Coverage complete when: All measurements in the declared station/site or geographic set and completed observation window/source-defined period are present; station is optional when the source observation is geographically identified without a station. Latest notice alone is not a complete event or observation feed.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
record_id | string | Không | Mã định danh · semantic role: identity |
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
indicator | string | Có | Chỉ tiêu · semantic role: classification |
observation_date | date | Không | Ngày quan sát · semantic role: time |
period | period | Không | Kỳ dữ liệu · semantic role: time |
geography | location | Có | Địa bàn · semantic role: geography |
station | string | Không | Trạm/điểm · semantic role: classification |
value | number | Có | Giá trị · semantic role: measure |
unit | string | Có | Đơn vị · semantic role: classification |
status | string | Không | Trạng thái · semantic role: classification |
description | string | Không | Mô tả · semantic role: description |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.project-registryDanh mục dự ánv2.3.1
bop.project-registryDanh mục dự ánIdentity keys: record_id · name + geography + project_type
Coverage complete when: All projects in the named official programme, permit batch, or bounded publication are included; distinguish approved, planned, under-construction, and completed status. If the source includes a parent project roll-up alongside a distinct child/component line that repeats the name, project_type is part of the composite identity and must distinguish the source row role.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
record_id | string | Không | Mã định danh · semantic role: identity |
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
project_type | string | Có | Loại dự án · semantic role: classification |
developer | string | Không | Chủ đầu tư · semantic role: classification |
geography | location | Có | Địa bàn · semantic role: geography |
status | string | Có | Trạng thái · semantic role: classification |
capacity | number | Không | Công suất · semantic role: measure |
unit | string | Không | Đơn vị · semantic role: classification |
investment_value | number | Không | Vốn đầu tư · semantic role: measure |
currency | string | Không | Tiền tệ · semantic role: classification |
start_date | string | Không | Ngày bắt đầu · semantic role: classification |
completion_date | string | Không | Ngày hoàn thành · semantic role: classification |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.trade-cubeBảng thương mại đa chiềuv2.3.0
bop.trade-cubeBảng thương mại đa chiềuIdentity keys: period + reporter + partner + flow + commodity + source_table + classification · period + reporter + partner + flow + commodity + source_table · period + reporter + partner + flow + commodity + classification · period + reporter + partner + flow + commodity
Coverage complete when: Every reporter-partner-flow-commodity cell in every declared source table and explicitly bounded completed period/query is present; retain source-table partition where one publication exposes multiple tables.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
period | period | Có | Kỳ dữ liệu · semantic role: time |
reporter | string | Có | Nước/vùng báo cáo · semantic role: classification |
partner | string | Có | Đối tác · semantic role: classification |
flow | string | Có | Chiều thương mại · semantic role: classification |
commodity | string | Có | Hàng hóa/dịch vụ · semantic role: classification |
classification | string | Không | Hệ phân loại · semantic role: classification |
source_table | string | Không | Bảng nguồn · semantic role: classification |
value | number | Có | Giá trị · semantic role: measure |
unit | string | Có | Đơn vị · semantic role: classification |
frequency | string | Không | Tần suất · semantic role: classification |
source_url | url | Không | URL nguồn · semantic role: provenance |
bop.geographic-referenceDữ liệu địa lý tham chiếuv2.2.0
bop.geographic-referenceDữ liệu địa lý tham chiếuIdentity keys: code · record_id · name + geography + admin_level
Coverage complete when: All geographic codes/features within the named edition and jurisdiction are included, respecting hierarchy and source-declared omissions.
| Trường (Field) | Kiểu dữ liệu (Type) | Bắt buộc | Mô tả & Quy cách |
|---|---|---|---|
record_id | string | Không | Mã định danh · semantic role: identity |
code | string | Không | Mã địa lý · semantic role: classification |
name | string | Có | Tên / chỉ tiêu · semantic role: identity |
geography | location | Không | Địa bàn · semantic role: geography |
admin_level | string | Không | Cấp địa giới · semantic role: classification |
parent_code | string | Không | Mã cấp trên · semantic role: classification |
latitude | number | Không | Vĩ độ · semantic role: measure |
longitude | number | Không | Kinh độ · semantic role: measure |
description | string | Không | Mô tả · semantic role: description |
source_url | url | Không | URL nguồn · semantic role: provenance |