Ohje PxWeb-tietokantojen API-kyselyjen muuttamiseen

Tilastotietokantojen px-tiedostojen rakenne muuttui 8.6.2026. Jotta API-rajapintaan tehdyt kyselyt toimivat muutoksen jälkeen, niihin tulee tehdä korjauksia. Tällä sivulla kerromme, mitä muutoksia pitää tehdä ja mitä tietokantoja muutokset koskevat.

Muutokset koskevat lähes kaikkia tietokantojemme päivittyviä taulukoita. Muuttuvat taulukot tunnistaa nelimerkkisestä taulukko-ID:stä kuten 12tg.

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 kaikki aktiivisia tietokantoja, mutta ei kaikkia muuttujia.

1. Tunnusten lyhentäminen

Muutoksessa lyhennetään TABLEID- ja MATRIX-kenttien tiedot pääsääntöisesti 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	statfin_tyonv_pxt_12tg	12tg
MATRIX	010_12tg_2026	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ä. Tiedostonimimuutokset on listattu liitteessä 1.

Sama tiedosto sisältää myös aikamuuttujaa koskevat VARIABLECODE-muutokset, jotka kuvataan tarkemmin seuraavassa kappaleessa.

Liite 1: tiedostonimimuutokset ja aikamuuttujan VARIABLECODE-muutokset (xlsx)

2. 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";

VARIABLECODE[sv]("Uppgifter")="contentscode";

VARIABLECODE[en]("Information")="contentscode";

Aikamuuttujat

Aikamuuttujalle lisätään aikamuuttujan syklin mukainen VARIABLECODE. Seuraavassa on esimerkit muutamasta aikamuuttujasta.

Vuositaulukot:

VARIABLECODE("Vuosi")="timeperiod_y";

VARIABLECODE[sv]("År")="timeperiod_y";

VARIABLECODE[en]("Year")="timeperiod_y";

Kuukausitaulukot:

VARIABLECODE("Kuukausi")="timeperiod_m";

VARIABLECODE[sv]("Månad")="timeperiod_m";

VARIABLECODE[en]("Month")="timeperiod_m";

Vuosineljännestaulukot:

VARIABLECODE("Vuosineljännes")="timeperiod_q";

VARIABLECODE[sv]("Kvartal")="timeperiod_q";

VARIABLECODE[en]("Quarter")="timeperiod_q";

Luokittelevat muuttujat

Luokitteleville muuttujille lisätään VARIABLECODE, joka on kyseisen luokituksen tai arvotasoisen koodiston tunniste.

Esimerkki aluemuuttujasta:

VARIABLECODE("Alue")="alue_23_20260101";

VARIABLECODE[sv]("Område")="alue_23_20260101";

VARIABLECODE[en]("Region")="alue_23_20260101";

Lisättävät VARIABLECODEt on kuvattu seuraavissa tiedostoissa. Aikamuuttujat sisältyvät samaan tiedostoon, jossa on kuvattu edellisessä kohdassa kuvatut tiedostonimimuutokset.

Liite 1: tiedostonimimuutokset ja aikamuuttujan VARIABLECODE-muutokset (xlsx)Liite 2: luokittelumuuttujien VARIABLECODE-lisäykset (xlsx)

3. 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. Lisättävät etuliitteet on kuvattu seuraavassa tiedostossa.

Liite 3: muutokset analyysimuuttujiin (xls)

Esimerkki rajapintahaun muutoksesta

Esimerkki px-tiedoston muutoksesta

Muutoksia koskevat tiedostot

Tarvittavat tiedosto- ja muuttujatasoiset muutokset on listattu kolmeen tiedostoon.

Listaus px-tiedostojen tiedostonimimuutoksista sekä kyseisten taulukoiden aikamuuttujien uusista VARIABLECODE:ista.
Listaus taulukoiden luokittelumuuttujille lisättävistä VARIABLECODE:ista.
Listaus taulukoiden analyysimuuttujan (="Tiedot"-muuttuja) arvotasoisista koodimuutoksista (näitä ei tule kaikkiin taulukoihin).

Toisessa ja kolmannessa tiedostossa ei ole kytköstä tiedostotasolle, vaan ne on tarvittaessa kytkettävä/yhdistettävä ensimmäiseen listaukseen "Taulukon ID"-sarakkeiden kautta.

Liite 1: tiedostonimimuutokset ja aikamuuttujan VARIABLECODE-muutokset (xlsx)Liite 2: luokittelumuuttujien VARIABLECODE-lisäykset (xlsx)Liite 3: muutokset analyysimuuttujiin (xls)

Uusi tehokkaampi rajapinta tulossa

Otamme tänä vuonna käyttöön uuden tehokkaamman avoimen datan rajapinnan. Uuteen rajapintaan voi tutustua sen beta-versiossa.

Rajapinnan beta-versiosta on saatavilla julkaistava data heti julkaisuhetkellä, mutta rajapintaa kehitetään edelleen, minkä takia hetkelliset katkokset ja muutokset määrittelyissä ovat mahdollisia.

Lisätietoa uudesta rajapinnasta

Yhteystiedot

Palvelusähköposti

tietokannat@stat.fi