v26.03: Muunnossolmujen käyttö

Muunnossolmut (aiemmin laskentasolmut) muuntavat ylävirran solmuista tulevia tietoja erilaisilla menetelmillä.

Käytettävissä olevat tietotyypit

v26.03: Kartoitussolmu

Kartoitussolmu muuntaa dataa soveltamalla ennalta määriteltyjä kartoitustaulukoita syöttödatajoukkoihin.

Kartoitussolmun määrittäminen:

1. Napsauta + Lisää solmu tason 2 otsikosta. Lisää solmu -valintaikkuna avautuu.

2. Valitse vasemmasta paneelista Muunna.

3. Valitse Mapping oikealta paneelilta. Solmu ilmestyy työtasolle ja konfigurointipaneeli avautuu.

4. Täytä konfigurointipaneelin pakolliset kentät:

   Parametri	Kuvaus
   Nimi	Ainutlaatuinen tunniste. Oletusarvo on Mapping_[n].
   syöte	Valitse ylävirran Read-, Mapping- tai SQL Script-solmu.
   Vaiheet	Valitse + Lisää vaihe luodaksesi kartoituksia. Jokainen vaihe vaatii seuraavat tiedot: Vaiheen nimi (tunniste) Mapping-taulukko (sovellettava ennalta määritelty mapping-taulukko) Lähdekenttien kartoitus (kartoitettavat lähdekentät)
   v26.10:  Vain ensimmäinen vastaavuus	Valitse tämä, jos haluat palauttaa vain ensimmäisen vastaavan rivin rivijärjestyksessä, kun lähdearvo vastaa useampaa kuin yhtä riviä kartoitustaulukossa. Kun valintaruutu on tyhjä (oletusasetus), solmu palauttaa kaikki vastaavat rivit. Asetus koskee solmun kaikkia vaiheita.
   v26.05:  Asetukset (valinnainen)	Määritä Precedent ja Subsequent -solmut solmun suoritusjärjestyksen hallitsemiseksi. Katso lisätietoja kohdasta Solmuasetusten käyttö.

5. Tallenna asetukset valitsemalla Julkaise tason 2 otsikosta.

   Julkaisun jälkeen seuraavat hallintatoiminnot tulevat käytettäviksi tason 2 otsikossa:

   • Päivitä: Lataa ruudukon uudelleen muutosten näkyviin tuomiseksi.

   • Suorita: Suorittaa kyselyn, kun se on kelvollinen.

Siirry Suorituksen tulos -välilehteen, jos haluat esikatsella kartoitustaulukon tietoja. Suorituksen tulos -välilehdessä näkyy myös reaaliaikainen tietojen simulointiesikatselu: kartoitettujen rivien kohdalla näkyy kartoitettu arvo, epäonnistuneiden rivien kohdalla näkyy N/A ja kartoittamattomien rivien kohdalla on tyhjä kenttä, jos Kartoittamattoman lähteen epäonnistuminen -asetusta ei ole otettu käyttöön.

v26.04: Käyttäjät voivat järjestää vaiheita uudelleen, muokata ja poistaa niitä ellipsimenun kautta. Käsittely kartoittamattomille perii ”Epäonnistuminen kartoittamattomasta lähteestä” -asetuksen valitusta kartoitustaulukosta.

v26.10: Kun suoritus keskeytyy tai päättyy kartoittamattomien arvojen vuoksi, Suorituksen tuloste -välilehden Viesti-kohdassa näkyy hylättyjen tietueiden määrä ja kartoittamattomat arvot ulottuvuuksittain. Esimerkiksi: 3 tietuetta hylättiin seuraavien ulottuvuuksien vuoksi: Masterdata: ["EM","AF","DC"]

v26.10: Lähdearvojen täsmäyttäminen ja ohittaminen

Kartoitussolmu vertaa kutakin lähdearvoa kartoitustaulukon riveihin rivijärjestyksessä. Seuraavia sääntöjä sovelletaan:

v26.03: SQL-skriptisolmu

SQL-skripti-solmu tarjoaa SQL-pohjaisia tietojen muuntamistoimintoja.

SQL-skriptisolmun määrittäminen:

1. Napsauta + Lisää solmu tason 2 otsikosta. Lisää solmu -valintaikkuna avautuu.

2. Valitse vasemmasta paneelista Muunna.

3. Valitse SQL-skripti oikealta paneelilta. Solmu ilmestyy työtasolle ja konfigurointipaneeli avautuu.

4. Täytä konfigurointipaneelin pakolliset kentät:

   Parametri	Kuvaus
   Nimi	Ainutlaatuinen tunniste. Oletusarvo on SQL-skripti_[n].
   syöte	Valitse + Lisää valitaksesi ylävirran solmuja. Useita tuloja tuetaan.
   Kysely	Syötä SQL-logiikka. Valitse Laajenna avataksesi Lisäasetukset-näkymän muokkaamista varten.
   v26.05:  Asetukset (valinnainen)	Määritä Precedent ja Subsequent -solmut solmun suoritusjärjestyksen hallitsemiseksi. Katso lisätietoja kohdasta Solmuasetusten käyttö.

5. (Valinnainen) Valitse Validoi tarkistaaksesi syntaksin ennen julkaisua.

6. Tallenna asetukset valitsemalla Julkaise tason 2 otsikosta.

   Note: Solmut voidaan julkaista virheellisillä kyselyillä — tällöin näkyviin tulee varoituskuvake.

   Julkaisun jälkeen tason 2 otsikossa tulee näkyviin lisävalintakenttiä:

   • Päivitä: Lataa ruudukon uudelleen muutosten näkyviin tuomiseksi.

   • Suorita: Suorittaa kyselyn, kun se on kelvollinen.

Kysely-kenttä tukee seuraavia:

• Kyselysyntaksi — {{node_name}} ja ${dimension_description} esimerkkeineen.

• Tuetut SQL-operaatiot — SELECT, JOIN, WHERE, GROUP BY, ORDER BY, funktiot.

• Validointitiedot — Valitse Validoi tarkistaaksesi syntaksin ennen julkaisua.

Note: Solmut voidaan julkaista virheellisillä kyselyillä (varoituskuvake näkyy)

v26.02: Kysely validoidaan julkaisun tai päivityksen yhteydessä. Järjestelmä näyttää varoituskuvakkeen, kun SQL-kyselyt käyttävät luvattomia komponentteja.

v26.04: Kyselyn syntaksi: Käytä {{node_name}} syöttösolmuille ja {{node_name}}.DIM_NAME ulottuvuuksille.

v26.08:  Syötteen validointi ja tietoturva

SQL-kyselyt voivat nyt viitata vain taulukoihin, jotka on nimenomaisesti lisätty syöttösolmuiksi (Lue-solmujen, perustietojen tai asetusten kautta).

Suorat taustataulujen tunnisteet tai nimet estetään sekä tallennus- että suoritusvaiheessa.

Tämä korjaa aukon, jonka kautta työnkulut saattoivat ohittaa työtilatasoiset tietojen käyttöoikeusrajoitukset, ja varmistaa, että kaikki SQL-skriptisolmut noudattavat työtilatasoisia tietoturvakäytäntöjä.

v26.10:  Voit poistaa tämän rajoituksen työnkululta valitsemalla Salli pääsy työtilan taulukoihin Työnkulun tiedot -paneelissa. Vaihtoehto on oletusarvoisesti pois valittuna.

v26.09:  SQL-syntaksin standardointi

SQL-skriptisolmu käyttää nyt standardoitua syntaksia solmujen, sarakkeiden ja parametrien viittaamiseen. Tämä korvaa aiemmat muodot {{node_name}} ja ${Node Name}.

Solmu- ja sarakkeiden viittaukset

Sarakkeisiin viitataan muodossa 'node_id'.'column_id', jolloin sekä solmun tunnus että sarakkeen tunnus ovat yksinkertaisissa lainausmerkeissä.

• Viittauksessa on aina oltava sekä solmun tunnus että sarakkeen tunnus, pisteellä erotettuina. Kysely, jossa käytetään pelkkää sarakkeen nimeä ilman solmuviaitetta, hylätään selkeällä virheilmoituksella.

• Yksinkertaisissa lainausmerkeissä oleva solmu- tai saraketunnus, jota ei voida tulkita määritellyksi syöttösolmuksi tai sen sarakkeeksi, hylätään selkeällä virheilmoituksella, jossa tunnistetaan tuntematon tunniste.

• Yksinkertaisia ja kaksoislainausmerkkejä ei saa sekoittaa keskenään.

Standardoitua syntaksia sovelletaan johdonmukaisesti kyselyjen kirjoittamisessa, syöttö-/tulostusrakenteen näytössä ja tietojen esikatselussa. Rakenteen näytössä näkyy ID (kuvaus), kun taas kyselyssä käytetään muotoa 'node_id'.'column_id'.

Parametriviittaukset

Kaikkiin parametreihin viitataan muodossa $'parameter_name'. Aikaisempaa muotoa ${Node Name} ei enää käytetä eikä näytetä missään.

Tämä koskee kaikkia Käytettävissä olevat parametrit -paneelin parametreja, mukaan lukien järjestelmäparametrit (Suorituspäivä, Suoritusjakso, Suorittaja) ja käyttäjän määrittämät parametrit.

Editorin toiminta

• Kun napsautat parametria Käytettävissä olevat parametrit -paneelissa, se lisätään kursorin kohdalle muodossa $'parameter_name' sen sijaan, että se kopioitaisiin leikepöydälle.

• Kun kirjoitat yksinkertaisten lainausmerkkien sisällä, editori ehdottaa vastaavia syöttösolmujen tunnisteita. Merkinnän 'node_id'. jälkeen se ehdottaa kyseisen solmun saraketunnuksia, jotka poimitaan ainoastaan SQL-solmun määritellyistä syöttösolmuista. Ehdotuksen valitseminen lisää koko 'node_id'.'column_id'-viittauksen.

Vaikutus olemassa oleviin työnkulkuihin

Olemassa olevia työnkulkuja ei päivitetä automaattisesti. Aiemmalla syntaksilla kirjoitetut olemassa olevat SQL-kyselyt — joissa käytetään {{node_name}}.column_name tai ${Node Name} — eivät toimi, ennen kuin ne on päivitetty uuteen syntaksiin. Kaikki solmut, joiden kyselyä ei enää voida ratkaista, merkitään virheellisiksi.

Note: Olemassa olevat solmut säilyttävät nykyiset nimensä ja tunnisteensa. Tämä päivitys ei luo uusia taulukoita eikä muuta tunnisteita.

v26.10:  Kyselyvirheiden korjaaminen

Kun vahvistat, julkaiset tai suoritat SQL-skriptisolmun, kyselyssä oleva ongelma raportoidaan suorituslähdössä tietyllä viestillä. Viestissä käytetään näytöllä näkyviä nimiä, kuten antamiasi syöttösolmujen nimiä, ja siinä ilmoitetaan kyselyn ongelman rivi ja sarake sellaisena kuin olet sen kirjoittanut.

Seuraavanlaisia ongelmia raportoidaan:

Kyselyn suorituksen aikana ilmenevät virheet säilyttävät alkuperäisen tekstinsä, ja sisäisten taulukoiden nimien tilalla näkyvät syöttösolmujen nimet.

Note: Tekstiarvon, kommentin tai lainausmerkeillä ympäröidyn tunnisteen sisällä oleva kielletty avainsana ei estä kyselyä, ja kysely voi päättyä omaan LIMIT-lauseeseensa.