Агуулга руу очих

Энэ заавар албан ёсны статистикийг эх сурвалж, сонгосон хэмжээс, ажиглалтын тэмдэглэгээ, цуглуулалтын нөхцөлтэй холбоотой хадгалах 0.4 ажлын урсгалыг харуулна. Доорх үйлчилгээний бүх хүсэлт нь хэрэглэгч зориуд ажиллуулах жишээ; зааврыг бүтээхэд сүлжээнд хандахгүй.

Эх сурвалжаа сонгох

Үйлчилгээ Хэрэглээ Таних дугаар
PXWeb, data.1212.mn Нийтлэгдсэн статистикийн хүснэгт DT_NSO_...
Нээлттэй өгөгдлийн портал, data.nso.mn Туршилтын нэгтгэсэн цуваа, өгөгдлийн сангийн жагсаалт Хайлтын үр дүн дэх portal:DT_NSO_...
Мета өгөгдлийн каталог, metadata.nso.mn Тодорхойлолт, маягт, ангилал, холбоос Төрөл заасан тоон дугаар

Ижил гарчиг, хүснэгттэй төстэй код нь хоёр үйлчилгээ ижил хэмжүүр нийтэлдгийг батлахгүй. Газар нутгийн код ч өөрийн эх сурвалжид харьяалагдана. Жишээлбэл шалгасан порталын ДНБ-ий цуваа улсын кодод CO9999, харин хянасан PXWeb-ийн суурин хүн амын загвар 0 ашигладаг.

Хянасан үзүүлэлтээс эхлэх

nso_indicators() нь багцад дагалдах, хянасан PXWeb ойлголтын жижиг бүртгэлээс хайна. Татахаасаа өмнө тодорхойлолт, нэгжийн төлөв, баталгаажуулсан огноо, анхаарах зүйлийг шалгана. Асуулгын загвар үндсэн сонголтуудыг тогтоох бөгөөд хугацааны нэрийг тусад нь өгнө. Төстэй нэртэй порталын цувааг ижил гэж таамаглахгүй.

old_options <- nso_options(mongolstats.lang = "en")
nso_indicators("GDP")
concept <- nso_indicator("gdp_current")
concept[c("name", "definition", "unit", "unit_status", "verified_at", "caveats")]

query <- nso_indicator_query("gdp_current", periods = c("2023", "2024"))
gdp <- nso_fetch(query, labels = "both")

# Хянасан анхны сонголт нь хоёр хүйс, улсын нийт дүн.
population_query <- nso_indicator_query("resident_population", periods = "2024")
options(old_options)

PXWeb-ийн байрлалын кодын оронд "2024" зэрэг хугацааны нэр ашиглана. Дараагийн шинэчлэлээр "0" код өөр оныг зааж болно. *-ээр төгссөн эх нэрийг хадгална. Засварын төлөв оноох, нийтэлсэн тооны масштабыг хувиргахаасаа өмнө тухайн тэмдгийн эх тайлбарыг уншина.

Эх сурвалжийн мэдээллийг шалгах

Татсан үр дүн энгийн tibble хэвээр байна. Гарал үүслийн атрибут эх сурвалжийн таних мэдээлэл, хүсэлтийн URL, сонголт, татсан хугацаа, боломжтой эх мета өгөгдөл, мета өгөгдлийн хэшийг бүртгэнэ. nso_table_info() товч харагдац, nso_provenance() нь багц хүсэлтийн бүтэлгүйтлийг багтаасан бүрэн бүртгэл өгнө.

nso_table_info(gdp)
manifest <- nso_provenance(gdp)
manifest$records[[1]]$selections
manifest$failures
nso_citation(gdp)

# Зөвхөн мета өгөгдөл хайна; ажиглалт хүсэхгүй.
nso_table_info("DT_NSO_0500_001V1")

Эх сурвалжийн мэдэгдэл, шинэчилсэн огноо, нэгж байхгүй бол дутуу хэвээр үлдээнэ. Зөвхөн мета өгөгдлийн хайлт нь өгөгдлийн хариунаас бага мэдээлэлтэй байж болно. Эшлэл нь эх сурвалжийг хүлээн зөвшөөрнө. Багцын програмын лиценз өгөгдлийн дахин ашиглах нөхцөлийг тогтоохгүй. ҮСХ-ны ашиглах нөхцөл болон холбогдох эх бичлэгийг үзнэ үү.

Эх сурвалжийн тэмдэглэгээг хадгалах

Тоон NA дангаараа дутуу ажиглалтыг .. зэрэг эх тэмдэглэгээнээс ялгахгүй. nso_value_status() нь ажиглалтын түлхүүр, анхны value_raw, value_status-г буцаана: төгсгөлөг тоонд "observed", хоосон эсвэл дутуу талбарт "missing", бусад текстэд "symbol". Тэмдэглэгээний утгыг таамаглахгүй. Шүүх, хувиргахаас өмнө эдгээр бүртгэлийг хадгална.

status <- nso_value_status(gdp)
status[status$value_status != "observed", , drop = FALSE]

nso_check_data(
  gdp,
  keys = "Year",
  period = "Year",
  expected_periods = c("2023", "2024")
)

Энэ жишээ PXWeb-ийн англи хэмжээсийн нэр ашиглана. Өөр хэлээр татахдаа names(gdp)-г шалгана. Нэмэлт unit, geography_level аргумент нь өгөгдөлд тань байгаа баганыг нэрлэнэ. Шалгагч утгыг өөрчлөхгүйгээр асуудлыг мэдээлнэ. Асуудал мэдээлээгүй нь хүн ам, нэгж, газар нутгийн түвшин харьцуулах боломжтойг батлахгүй.

Хадгалж, дахин ашиглах баримт экспортлох

Хувиргалт, CSV экспорт атрибутыг алдагдуулж болно. Гарал үүслийн дагалдах файл, анхны төлөвийн хүснэгтийг тусад нь хадгална. JSON бүртгэл нь эх сурвалж, хүсэлтийн нөхцөлийг агуулдаг бөгөөд статистикийн ажиглалт, түүхий тэмдэглэгээг агуулахгүй.

# Тогтвортой хадгалах төслийн хавтас сонгож, экспорт бүрд шинэ хавтас ашиглана.
export_dir <- file.path("outputs", "nso", format(Sys.Date(), "%Y-%m-%d"))
dir.create(export_dir, recursive = TRUE, showWarnings = FALSE)
# Өмнөх ажиллуулалтын файлыг санамсаргүй дарж бичихээс сэргийлнэ.
targets <- file.path(export_dir, c("gdp.csv", "gdp.rds", "value-status.rds", "provenance.json", "analysis-context.rds"))
stopifnot(!any(file.exists(targets)))
saveRDS(gdp, file.path(export_dir, "gdp.rds"))
analysis_context <- list(
  saved_at = format(Sys.time(), tz = "UTC", usetz = TRUE),
  data_sha256 = digest::digest(gdp, algo = "sha256"),
  session = utils::sessionInfo(),
  code_revision = Sys.getenv("ANALYSIS_CODE_REVISION", unset = NA_character_),
  manual_recodes = character()
)
saveRDS(analysis_context, file.path(export_dir, "analysis-context.rds"))
utils::write.csv(gdp, file.path(export_dir, "gdp.csv"), row.names = FALSE)
saveRDS(nso_value_status(gdp), file.path(export_dir, "value-status.rds"))
nso_write_manifest(gdp, file.path(export_dir, "provenance.json"))

saved_manifest <- nso_read_manifest(file.path(export_dir, "provenance.json"))
nso_table_info(saved_manifest)
nso_citation(saved_manifest)
readRDS(file.path(export_dir, "value-status.rds"))

overwrite = TRUE-г илэрхий өгөөгүй бол nso_write_manifest() байгаа файлыг дарж бичихгүй. RDS файл анхны R төрөл, атрибутыг хадгална. Шинжилгээний кодын хувилбар, гараар өөрчилсөн кодчиллыг тодорхой бүртгэнэ. Мета өгөгдлийн хэш дангаараа эх сурвалж шинэчлэгдсэний дараах ажиглалтыг дахин сэргээх боломжгүй.

Түвшин тооцохоос өмнө шалгах

Бусад заавар system.file("examples", "analysis-helpers.R", package = "mongolstats")-д дагалдах, кодыг нь шалгаж болох сургалтын туслах функцүүдийг ачаална. Үнэлгээ тооцохоос өмнө хүлээгдэж буй нэгж–сарын тор, цорын ганц түлхүүр, нийтлэг хугацаа, насны бүрэн бүлэг, эерэг хуваарийг шалгана. Дутуу эх ажиглалтыг тодорхойгүй хэвээр үлдээнэ. nso_check_data() асуудлыг мэдээлэх боловч хоосон тайлан шинжилгээний шаардлага хангагдсаныг батлахгүй.

Хувиргалтаас өмнө анхны татсан объект, түүний nso_value_status() үр дүн, гарал үүслийг хадгална. Шалгасан шинжилгээний өгөгдөл, дахин кодлох дүрмийг дээрх гаралтуудтай хамт хадгална. Татсан огноо, түүхий тэмдэглэгээгүй хуучин сургалтын хуулбарт дутуу мэдээллийг нөхөж сэргээх боломжгүй.

Тодорхойлолт, цуглуулалтын нөхцөлийг олох

Мета өгөгдлийн каталог нь мэдээллийн сан, хүснэгт, асуулгын талбар, маягт, ангиллыг холбоно. Түүний indicator төрөл нийтлэгдсэн цуваа бус, цуглуулалтын маягтын асуулт байж болно. Каталогийн тоон код PXWeb хүснэгтийг танихгүй. Хайлтын хамралт, хуудаслалтын атрибут нь буцсан мэдээллийг тайлбарлахаас бүрэн жагсаалт болохыг батлахгүй.

hits <- nso_metadata_search("хүн ам", type = "all")
attr(hits, "coverage")
attr(hits, "pagination")

organizations <- nso_metadata_search(type = "organization")
databases <- nso_metadata_search(organization = 1, page = 1)
attr(databases, "pagination")

database <- nso_metadata("database", 526, include_raw = TRUE)
database$methodology
database$access
nso_related(database)

field <- nso_metadata("indicator", 12925, include_raw = TRUE)
field$quality_flags
field$context$unit
field$context$value_type
field$date_fields
nso_related(field)

Эндхүү тоон кодууд шалгасан каталогийн бичлэгийн бодит жишээ юм. Шинжилгээндээ хамаарах бичлэг сонгоно. nso_related() нэмэлт хүсэлтгүйгээр доторх холбоосыг уншина. Дэмждэг бүтэн бичлэгийг nso_metadata(type, id)-оор татна; доторх дэлгэрэнгүй мэдээлэл хэсэгчилсэн байж болно. Чанарын тэмдэглэгээ сэжигтэй эх талбарыг чимээгүй засахын оронд шалгахад зориулж хадгална.

forms <- nso_forms(database_id = 526, include_raw = TRUE)
forms$records
form <- nso_metadata("form", 1024, include_raw = TRUE)
form$dates
form$years
form$date_fields
form$context
form$quality_flags

classification <- nso_classification(3446, include_raw = TRUE)
attr(classification, "completeness")
attr(classification, "quality_flags")
attr(classification, "metadata")$version

nso_metadata_dictionary("frequency")
nso_metadata_dictionary("collection-method")
nso_metadata_dictionary("licence")

Ангиллын кодыг тэмдэгт мөрөөр хадгална. Хоосон кодын тайлбар нь тухайн ангилал бүлэггүйг батлахгүй; хоосон бус тайлбар ч бүрэн хамралтыг батлахгүй. Лиценз, нууцлалын ангилал нь каталогийн бичлэгийг тайлбарлахаас суурь өгөгдөлд хандах эрх олгохгүй. Дутуу албан ёсны орчуулгыг дутуу хэвээр үлдээнэ.

Каталогийн шинэчлэгдсэн байдлыг шалгах

Локал PXWeb хайлт багцад дагалдах эсвэл сессийн индекс ашиглана. Бичлэгийн тоонд нэг хүснэгт хэд хэдэн замаар орсон байж болно. Бодит түлхүүр үгийн хайлт нь эх үйлчилгээний тогтоосон хайлтын цонх буцаахаас бүтэн индексийг дахин байгуулахгүй.

nso_catalogue_status()
nso_search("population", fixed = TRUE)
live_hits <- nso_search("population", live = TRUE)
attr(live_hits, "catalogue")

config <- nso_api_config(refresh = TRUE)
config[c("maxCells", "maxValues", "origin", "status")]

Багц өгөгдлийн асуулгыг нүдний хязгаараар хувааж, хүсэлтийн болгоомжтой давтамж мөрдөнө. maxValues нь PXWeb-ийн зарласан мета өгөгдлийн утгын хязгаарыг тайлбарлахаас өгөгдлийн асуулгын сонголтыг хязгаарлахгүй. Тохиргоо анхны утга эсвэл хуучин кэш рүү шилжиж болох тул status-г шалгана. Нэг компьютерийн процессууд хүсэлтийн давтамжаа хуваалцана. Ижил нийтийн хаяг ашигладаг бусад компьютерийг нэмж зохицуулах шаардлагатай.

Нийтийн порталыг зориуд сонгож ашиглах

Порталын бүртгэл туршилтын шинжтэй. Түүний queryable, quality_flags, бүлэглэх хэмжээсүүдийг шалгана. Буруу эсвэл дутуу кодтой мөр хайлтад харагдах ч асуулга хийх боломжгүй. Порталын хүсэлтийн параметр нь хянасан PXWeb загвараас тусдаа бөгөөд эх сурвалжийн өгүүлбэрэн хураангуй нь ажиглалт биш.

portal_catalog <- nso_indicators(source = "portal", refresh = TRUE)
portal_catalog[c("id", "name", "unit", "queryable", "quality_flags")]
nso_indicator("portal:DT_NSO_0000_4_4")

portal_gdp <- nso_portal_data(
  "DT_NSO_0000_4_4",
  area = "1",
  dimension = "code",
  graph_type = "line",
  periods = "2024",
  labels = "both"
)
portal_gdp[c("source_id", "period", "code", "code_mn", "code_en", "value", "unit")]
nso_check_data(portal_gdp, keys = c("period", "code", "code1"), unit = "unit")
nso_table_info(portal_gdp)

area, dimension, graph_type нь эх сурвалжид илгээх тодорхой параметрүүд. ДНБ-ий жишээ тэдгээрийн утгыг бүх үзүүлэлтэд батлахгүй. Хугацаагаар шүүхдээ татсаны дараа эхийн нэртэй яг тааруулна. Нэрийн аль ч сонголтод кодыг хадгална. Дутуу англи нэр NA хэвээр, тодорхойгүй газар нутгийн код хадгалагдана. 2025-1 зэрэг тэгээр нөхөөгүй үеийн нэрийг хэвээр үлдээх боловч сар уу, улирал уу гэдэг нь хоёрдмол бол огноогүй байна.

datamarts <- nso_portal_datamarts()
datamarts[c("id", "name", "years", "source", "query_supported")]

Өгөгдлийн сангийн дэмжлэг нь зөвхөн каталог хайх, дүрслэлийн тохиргоог авах боломж олгоно. Мэдээлсэн оны хүрээ бол эхийн текст, баталгаажсан хамралт биш. query_supported нь FALSE: нэгтгэсэн өгөгдлийн асуулгын тогтвортой протокол баталгаажаагүй бөгөөд энэ интерфейс суурь нэгжийн бичлэгүүдийг татахгүй.