uutinen

PxWeb-tietokantojen rajapintakäyttöön muutoksia 8.6. – muuta rajapintakyselyt ohjeen mukaan

Uutinen

Tilastotietokantojen 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:  

  1. Tiedostonimi, TABLEID- ja MATRIX-tunnus lyhennetään. Tämä koskee kaikkia aktiivisia tietokantoja. 

  2. Kaikille muuttujille on lisätty muuttujakoodi. Aiemmin muuttujan nimi toimi api-käytössä muuttujan tunnisteena, mutta jatkossa muuttujakoodi tulee tämän tilalle. 

  3. 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 

Tutustu tarkempaan ohjeeseen

Ohjeissa on liitteenä tarkat tiedosto- ja muuttujatasoiset ennen-jälkeen listat muutoksista sekä esimerkit px-tiedostoon ja rajapintahakuihin tulevista muutoksista. 

Miksi tätä sisältöä ei näytetä?

Tämä sisältö ei näy, jos olet estänyt evästeiden käytön. Jos haluat nähdä sisällön, tarkista evästeasetuksesi.