--- a/release-notes.md +++ b/release-notes.md @@ -4,27 +4,27 @@ ## Yleiskatsaus -On syytä huomata, että tämä julkaisu edustaa merkittävää ja keskeistä edistysaskelta DataFlow-alustan kehityksessä. Olemme erittäin innoissamme voidessamme julkaista version 3.2.0, joka on suunniteltu tarjoamaan käyttäjille lukuisia parannuksia ja uusia ominaisuuksia. Tämän lisäksi, on tärkeää ymmärtää, että päivityksen tavoitteena on parantaa alustan suorituskykyä merkittävällä tavalla. +Versio 3.2.0 tuo reaaliaikaisen analytiikan, uudistetun käyttöoikeushallinnan ja uuden REST API -version. Suorituskyky on parantunut tuntuvasti. ## Uudet ominaisuudet ### Reaaliaikainen data-analytiikka -Reaaliaikaisen data-analytiikan ominaisuuden kehittämisen mahdollisuuksien arvioinnin tulokset osoittivat selkeää tarvetta tälle toiminnallisuudelle. Uusi analytiikkamoduuli on toteutettu hyödyntämään Apache Kafka -viestijonoa ja ClickHouse-tietokantaa. Moduuli on suunniteltu käsittelemään jopa 50 000 tapahtumaa sekunnissa. +Tarve reaaliaikaiselle analytiikalle on ollut selvä jo pitkään. Uusi analytiikkamoduuli käyttää Apache Kafka -viestijonoa ja ClickHouse-tietokantaa, ja se käsittelee jopa 50 000 tapahtumaa sekunnissa. -Tämä on ehdottomasti yksi merkittävimmistä ominaisuuksista, jotka olemme koskaan toteuttaneet. On tärkeää korostaa, että reaaliaikainen analytiikka mahdollistaa käyttäjien seurata datavirtoja viiveellä, joka on alle 200 millisekuntia. +Datavirtoja voi nyt seurata alle 200 millisekunnin viiveellä. ### Parannettu käyttöoikeushallinta (RBAC v2) -Käyttöoikeushallinnan uudistaminen on toteutettu vastaamaan nykyaikaisten tietoturvavaatimusten asettamiin haasteisiin. Uusi RBAC v2 -järjestelmä tarjoaa mahdollisuuden määritellä hienojakoisia käyttöoikeuksia organisaatio-, tiimi- ja projektitasolla. +Uusi RBAC v2 -järjestelmä vastaa nykyaikaisiin tietoturvavaatimuksiin. Käyttöoikeudet voi nyt määritellä hienojakoisesti organisaatio-, tiimi- ja projektitasolla. -Tämän lisäksi, on syytä mainita, että järjestelmä tukee nyt SAML 2.0- ja OIDC-autentikointia. Integraatio on suunniteltu toimimaan saumattomasti olemassa olevien identiteetinhallintajärjestelmien kanssa, kuten Azure AD ja Okta. +Järjestelmä tukee myös SAML 2.0- ja OIDC-autentikointia. Se toimii suoraan Azure AD:n ja Oktan kanssa. ### Uusi REST API v3 -Hyvä uutinen! Olemme kehittäneet täysin uuden REST API -version, joka tarjoaa merkittävästi paremman kehittäjäkokemuksen. API on suunniteltu noudattamaan OpenAPI 3.1 -spesifikaatiota ja tarjoaa kattavan dokumentaation. +REST API on kirjoitettu uusiksi. Se noudattaa OpenAPI 3.1 -spesifikaatiota ja mukana tulee kattava dokumentaatio. -Keskeisiä parannuksia ovat: +Parannuksia: - Sivutuksen tuki kaikissa listaendpointeissa (`cursor`-pohjainen) - Rate limiting: 1000 pyyntöä/min (authenticated), 100 pyyntöä/min (anonymous) - Webhook-tuki 15 tapahtumatyypille @@ -32,22 +32,20 @@ ## Suorituskykyparannukset -On tärkeää huomata, että merkittäviä suorituskykyparannuksia on saavutettu useiden optimointien avulla. Tietokantakyselyiden optimoinnin tuloksena keskimääräinen vasteaika on laskenut 340 ms:stä 95 ms:iin. Tämä on erittäin merkittävä parannus, joka tulee vaikuttamaan positiivisesti käyttäjäkokemukseen. +Tietokantakyselyt on optimoitu: keskimääräinen vasteaika laski 340 ms:stä 95 ms:iin. -Välimuistijärjestelmä on uudistettu hyödyntämään Redis Cluster -arkkitehtuuria. Välimuistin osumisprosentti on noussut 72 prosentista 94 prosenttiin. Lisäksi on syytä todeta, että muistinkäyttö on optimoitu, mikä on johtanut 30 prosentin vähennykseen palvelinresurssien kulutuksessa. +Välimuistijärjestelmä käyttää nyt Redis Cluster -arkkitehtuuria. Osumisprosentti nousi 72 %:sta 94 %:iin. Samalla muistinkäyttö väheni 30 % — palvelinresursseja siis vapautuu. ## Korjatut virheet -Seuraavat virheet on korjattu tässä julkaisussa: - -- **DF-1847**: CSV-tiedostojen tuonti epäonnistui kun tiedosto sisälsi yli 100 000 riviä. Ongelma on ratkaistu ottamalla käyttöön stream-pohjainen käsittely. -- **DF-1923**: Käyttöliittymän hakutoiminto ei palauttanut tuloksia kun hakutermi sisälsi erikoismerkkejä. Korjaus toteutettiin päivittämällä Elasticsearch-kyselyjen sanitointilogiikka. -- **DF-2001**: Aikataulutetut raportit eivät lähteneet kun palvelimen aikavyöhyke oli UTC+2. Ongelma johtui virheellisestä aikavyöhykekonversiosta cron-ajastimessa. -- **DF-2034**: Dashboard-widgetien järjestys nollautui selaimen välimuistin tyhjennyksen yhteydessä. Järjestys tallennetaan nyt palvelinpuolelle. +- **DF-1847**: CSV-tuonti epäonnistui yli 100 000 rivin tiedostoilla. Korjattu stream-pohjaisella käsittelyllä. +- **DF-1923**: Haku ei toiminut erikoismerkkejä sisältävillä hakutermeillä. Elasticsearch-kyselyjen sanitointi päivitetty. +- **DF-2001**: Aikataulutetut raportit eivät lähteneet UTC+2-aikavyöhykkeellä. Syynä oli virheellinen aikavyöhykekonversio cron-ajastimessa. +- **DF-2034**: Dashboard-widgetien järjestys nollautui välimuistin tyhjennyksen yhteydessä. Järjestys tallentuu nyt palvelinpuolelle. ## Siirtymäohjeet -Päivitys versiosta 3.1.x versioon 3.2.0 on suunniteltu toteutettavaksi mahdollisimman sujuvasti. On kuitenkin tärkeää huomioida seuraavat askeleet: +Päivitys 3.1.x → 3.2.0: 1. Varmuuskopioi tietokanta ennen päivitystä 2. Aja migraatioskripti: `dataflow migrate --to 3.2.0` @@ -55,19 +53,13 @@ 4. Käynnistä palvelu uudelleen: `systemctl restart dataflow` 5. Varmista RBAC v2 -migraatio: `dataflow rbac migrate --dry-run` -REST API v2 säilyy tuettuna 6 kuukautta (deprecation: 13.10.2026). On erittäin suositeltavaa aloittaa siirtyminen API v3:een mahdollisimman pian, sillä uusi versio tarjoaa huomattavasti paremman toiminnallisuuden. +REST API v2 pysyy tuettuna 6 kuukautta (deprecation: 13.10.2026). Siirtyminen v3:een kannattaa aloittaa heti. ## Tunnetut rajoitukset -On tärkeää tiedostaa, että seuraavat rajoitukset ovat voimassa tässä julkaisussa: - -- Reaaliaikainen analytiikka tukee tällä hetkellä ainoastaan JSON- ja Avro-muotoista dataa -- RBAC v2 -migraatio vaatii manuaalisen tarkistuksen organisaatioille, joilla on yli 500 käyttäjää +- Reaaliaikainen analytiikka tukee toistaiseksi vain JSON- ja Avro-muotoista dataa +- RBAC v2 -migraatio vaatii manuaalisen tarkistuksen jos organisaatiossa on yli 500 käyttäjää - REST API v3:n batch-endpoint tukee enintään 100 operaatiota per pyyntö - -## Yhteenveto - -Yhteenvetona voidaan todeta, että DataFlow Platform v3.2.0 edustaa merkittävää harppausta eteenpäin alustan kehityksessä. Uskomme vahvasti, että nämä parannukset tulevat tarjoamaan käyttäjillemme entistä paremman kokemuksen ja tehokkaammat työkalut datan käsittelyyn. Olemme sitoutuneet jatkamaan alustan kehittämistä ja odotamme innolla palautettanne. Tuki ja dokumentaatio: https://docs.dataflow.io/v3.2 Vikailmoitukset: https://support.dataflow.io/tickets