PxWeb-tietokantojen rajapintakäyttöön muutoksia 8.6. – muuta rajapintakyselyt ohjeen mukaan
UutinenTilastotietokantojen px-tiedostojen rakenne muuttuu 8.6.2026. Jotta API-rajapintaan tehdyt kyselyt toimivat muutoksen jälkeen, niihin tulee tehdä korjauksia. Tarpeellisista muutoksista on nyt julkaistu ohje.
Muutokset koskevat taulukoita, joiden ID-tunnus on nelimerkkinen, esimerkiksi 12tg. Muutokset vaikuttavat muun muassa StatFin-tietokantaan sekä maksullisiin tietokantoihin. StatFinin arkistokantaan muutoksia ei toistaiseksi tehdä.
Muutoksilla pyrimme parantamaan taulukoiden sisältöjen löydettävyyttä ja ymmärrettävyyttä PxWebin käyttöliittymässä, hakukonekäytössä ja tekoälykäytössä. Muutos auttaa parantamaan taulukoiden metatietojen yhtenäisyyttä, muutostilanteiden ja taulukoiden elinkaaren hallintaa sekä näistä viestimistä.
Mitä muutoksia taulukoihin tulee?
Muutoksia on kolme:
Tiedostonimi, TABLEID- ja MATRIX-tunnus lyhennetään. Tämä koskee kaikkia aktiivisia tietokantoja.
Kaikille muuttujille on lisätty muuttujakoodi. Aiemmin muuttujan nimi toimi api-käytössä muuttujan tunnisteena, mutta jatkossa muuttujakoodi tulee tämän tilalle.
Joissain tapauksissa analyysimuuttujan arvokoodeille täytyy lisätä etuliite. Tämä muutos koskee kaikkia aktiivisia tietokantoja, mutta ei kaikkia muuttujia.
Tunnusten lyhentäminen
Muutoksessa lyhennetään TABLEID- ja MATRIX-kenttien tiedot pelkän ID-tunnisteen mittaisiksi. Muutoksen jälkeen tiedostonimi, TABLEID ja MATRIX tulevat olemaan identtiset.
Esimerkiksi työnvälitystilaston taulukossa tiedostonimi, TABLEID ja MATRIX muuttuvat seuraavasti:
| ennen muutosta | muutoksen jälkeen |
tiedostonimi | statfin_tyonv_pxt_12tg.px | 12tg.px |
TABLEID | TABLEID="statfin_tyonv_pxt_12tg” | TABLEID="12tg” |
MATRIX | MATRIX="010_12tg_2026" | MATRIX="12tg" |
Joissain tapauksissa tiedostonimi ei pelkästään lyhene, vaan ID:n perään tulee lisäksi tarkentava versiotunniste. Tämä muutos koskee lähinnä maksullisten tietokantojen vanhoja arkistotaulukoita. StatFin-taulukoissa tiedostonimiin ei tule lisäosia. StatFin-arkistokannassa näitä on, mutta StatFin-arkistokannan tiedostonimiä ei toistaiseksi muuteta eikä lyhennetä.
Muuttujakoodi
Jokaiselle taulukon muuttujalle lisätään muuttujatason koodi, joka toimii muutoksen jälkeen nykyisen muuttujanimen tilalla muuttujan tunnisteena api-kyselyissä. Alla on lueteltu eri muuttujille lisättävät muuttujakoodit.
Sisältömuuttujat
Sisältömuuttujalle ”Tiedot” lisätään VARIABLECODE contentscode:
VARIABLECODE("Tiedot")="contentscode";
Aikamuuttujat
Aikamuuttujalle lisätään aikamuuttujan syklin mukainen VARIABLECODE. Esim. vuositaulukoille timeperiod_y:
VARIABLECODE("Vuosi")="timeperiod_y";
Luokittelevat muuttujat
Luokitteleville muuttujille lisätään VARIABLECODE, joka on kyseisen luokituksen arvotasoisen koodiston tunniste. Esim. aluemuuttujalle usein alue_23_20260101:
VARIABLECODE("Alue")="alue_23_20260101";
Analyysimuuttujan etuliite
Joissain tapauksissa analyysimuuttujan arvotasoisille koodeille lisätään jokin etuliite. Analyysimuuttujalla tarkoitetaan muuttujaa ”Tiedot”.
Esimerkiksi tieliikenneonnettomuuksia koskevassa StatFin-taulukossa 111e tietomuuttuja ”kuol” muuttuu muotoon ”ton-kuol”.
Näitä muutoksia ei tule kaikkiin taulukoihin.
Tarkentava ohje
Ohjeissa on liitteenä tarkat tiedosto- ja muuttujatasoiset ennen-jälkeen listat muutoksista sekä esimerkit px-tiedostoon ja rajapintahakuihin tulevista muutoksista.