Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
TMDL-näkymä Power BI Desktopissa ja Power BI -palvelu antaa sinun skriptata, muokata ja soveltaa muutoksia semanttisiin malliobjekteihin käyttämällä modernia koodieditoria ja Tabular Model Definition Language (TMDL) -kieltä. Se parantaa kehityksen tehokkuutta ja tarjoaa täydellisen näkyvyyden sekä hallinnan semanttisten mallien metatietoihin.
TMDL-näkymä tarjoaa vaihtoehtoisen kokemuksen semanttiselle mallinnukselle käyttämällä koodia graafisen käyttöliittymän, kuten mallin näkymän, sijaan.
TMDL-näkymä tarjoaa seuraavat edut:
- Parannetun kehityksen tehokkuus monipuolisella koodieditorilla, joka sisältää haku- ja korvaustoiminnot, pikanäppäimet, moniriviset muokkaukset ja paljon muuta.
- paranna uudelleenkäytettävyyttä luomalla TMDL-komentosarjat helposti, jakamalla ja käyttämällä niitä uudelleen semanttisten mallikehittäjien keskuudessa. Keskitettyä SharePoint-sivustoa käyttämällä voit esimerkiksi helposti jakaa uudelleenkäytettäviä semanttisia malliobjekteja, kuten kalenteritaulukoita tai aikatietojen laskentaryhmiä.
- Lisää hallintaa ja läpinäkyvyyttä näyttämällä kaikki semanttisten mallien objektit ja ominaisuudet sekä sallimalla muutokset kohteisiin, joita ei ole saatavilla Power BI:n käyttöliittymässä, kuten IsAvailableInMDX tai DetailRowsDefinition.
Muistiinpano
TMDL-näkymä Power BI Desktopissa on yleisesti saatavilla, kun taas TMDL-näkymä verkossa on saatavilla esikatselussa.
TMDL-komentosarja
Valitse Power BI Desktopissa TMDL-näkymän -kuvake, joka sijaitsee ikkunan vasemmassa reunassa seuraavassa kuvassa esitetyllä tavalla.
Power BI -palvelu- tai Fabric-portaalin työtilassa valitse TMDL View (Preview).
Kun TMDL-näkymä avautuu, koodieditori on aluksi tyhjä. Voit luoda komentosarjan mihin tahansa semanttiseen malliobjektiin, kuten taulukkoon, mittariin tai sarakkeeseen, valitsemalla objektit Data -ruudusta ja vetämällä ne koodieditoriin:
Kun käytät TMDL-näkymää ja vedät objektia Tiedot-ruudusta, Power BI luo koko objektin metatiedot nykyiseen välilehteen TMDL:nä tai avaa uuden välilehden, jos nykyinen välilehti ei ole tyhjä, koska createOrReplace valittujen objektien TMDL-komentosarjaa seuraavassa kuvassa esitetyllä tavalla:
Vaihtoehtoisesti voit napsauttaa objektia hiiren kakkospainikkeella Tietonäkymässä ja valita Script TMDL - uuteen välilehteen tai leikepöydälle seuraavassa kuvassa esitetyllä tavalla:
Juomaraha
- Voit skriptata kokonaisia osia – mittareita, taulukoita tai sarakkeita – vetämällä osan koodieditoriin ja komentosarjaamalla kaikki osion objektit.
- Monivalintaa tuetaan painamalla CTRL-näppäintä ennen objektien komentosarjoja TMDL-näkymäkoodieditoriin.
Koodieditori
Kun olet komentosarjan semanttisen mallin objektin tai liittänyt TMDL-komentosarjan koodieditoriin, voit käyttää TMDL-näkymäkoodieditorin tarjoamia kattavia koodikokemusominaisuuksia. Koodikokemusominaisuuksien avulla voit joko tutkia mallin metatietoja tai tehdä muutoksia, joita voidaan myöhemmin käyttää semanttisessa mallissa.
Semanttinen korostus
Semanttinen korostus sisältyy koodieditoriin, mikä parantaa luettavuutta käyttämällä eri värejä koodin osissa merkityksen perusteella. Tällaisen värikoodauksen avulla on helpompi ymmärtää TMDL-koodin rakenne ja toiminnallisuus seuraavassa kuvassa esitetyllä tavalla.
Voit myös laajentaa tai kutistaa TMDL-komentosarjan osia seuraavassa kuvassa esitetyllä tavalla:
Automaattinen täydennys
Automaattinen täydennys on sisäänrakennettu koodieditoriin, ja se tarjoaa älykkäitä ehdotuksia kirjoittaessasi. Automaattinen täydennys voi nopeuttaa työnkulkua, pienentää virheiden todennäköisyyttä ja auttaa ymmärtämään koodivaihtoehtoja ehdottamalla dynaamisesti mahdollisia arvoja tai ominaisuuksia huomioimalla kohdistimen sijainnin.
Voit myös käynnistää automaattisen täydennystoiminnon missä tahansa sijainnissa painamalla Ctrl + välilyönti.
Työkaluvihjeet
Kontekstin työkaluvihje tulee näkyviin hiirellä osoitetessa ja antaa tietoja kustakin TMDL-objektista tai -ominaisuudesta.
Kooditoiminnot
Kun kohdistin on aaltoviivalla tai valitulla tekstillä, TMDL-näkymä näyttää hehkulamppukuvakkeen, joka ilmaisee käytettävissä olevat kooditoiminnot, kuten tietojen historiatietojen tunnisteiden luominen tai ominaisuuksien nimien kirjoitusjen korjaaminen.
Koodin muotoilu
Muotoile TMDL-koodia painamalla Vaihto + Alt + F tai napsauttamalla Muoto-vaihtoehtoa valintanauhassa.
Voit myös muotoilla valittua tekstiä pikavalikon Muotoile valinta -vaihtoehdon avulla.
Virhediagnostiikka
Koodieditorin sisäinen virhediagnostiikka auttaa tunnistamaan ja korjaamaan ongelmia korostamalla TMDL-kielivirheitä koodieditorissa ja antamalla yksityiskohtaisia sanomia, jotka antavat ohjeita niiden ratkaisemiseen. Lisäksi virheyhteenveto on käytettävissä Ongelmat-ruudun, mikä mahdollistaa helpon siirtymisen virhesijaintiin koodieditorissa seuraavassa kuvassa esitetyllä tavalla.
Ota muutokset käyttöön semanttisessa mallissa
Kun olet valmis, valitse Käytä -painike. Sen avulla voit suorittaa TMDL-komentosarjan semanttista mallia vasten ja ottaa TMDL-koodisi muutokset käyttöön.
Kun tämä onnistuu, näkyviin tulee ilmoitus ja mallinnusmuutoksesi otetaan käyttöön semanttisessa mallissa.
Virhetilanteessa näyttöön tulee virheilmoitus, joka näyttää, että mallinnusmuutoksia ei otettu käyttöön semanttisessa mallissa. Saat lisätietoja virheestä valitsemalla ilmoituksesta Näytä tiedot -linkin. Tämän jälkeen voit laajentaa Tuloste-ruudun ja näyttää virhetiedot.
Muistiinpano
TMDL-näkymä muokkaa vain semanttisen mallin metatietoja päivittämättä tietoja tai vaikuttamatta raporttiin. Jos muutoksesi edellyttävät tietojen päivittämistä, kuten PowerQuery-lausekkeen tai lasketun sarakkeen lausekkeen muokkaamista, taulukko tai malli on päivitettävä manuaalisesti, jotta muutokset tulevat voimaan. Lisäksi kentän nimeäminen uudelleen TMDL-näkymässä voi rikkoa visualisointeja kyseistä kenttää käyttävässä raportissa.
Esikatsele semanttisen mallin muutoksia
TMDL-näkymän avulla voit esikatsella komentosarjan muutoksia näyttämällä semanttisen mallin esikatselun ennen komentosarjan suorittamista ja sen jälkeen. Tämä näytetään TMDL-koodin erotuksena. Komentosarjan muutosten esikatselu on erityisen hyödyllistä, kun kopioit komentosarjoja muista lähteistä, jolloin voit arvioida niiden vaikutusta ennen niiden suorittamista semanttisessa mallissasi.
Esikatselu-painikkeen valitseminen näyttää semanttisen mallin TMDL-erotuksen ennen TMDL-komentosarjan suorittamista avatussa välilehdessä ja sen jälkeen.
Oikeanpuoleiseen ruutuun tulee näkyviin vierekkäinen ikkuna seuraavassa kuvassa esitetyllä tavalla.
Punaiset ja vihreät ruudut korostavat muutokset niin, että punaiset ruudut on poistettu tai muutettu ja vihreä osoittaa uudet viivat.
Muistiinpano
Vertailu ei ole suoraa näytettyyn TMDL-komentosarjaan verrattuna, vaan pikemminkin kattava semanttinen mallivertailu ennen komentosarjan suorittamista ja sen jälkeen. Joten jotkin ominaisuudet voidaan tilata eri tavalla kuin välilehdessä, noudattaen oletusarvoista TMDL-ominaisuutta/objektien järjestystä.
Esikatselu on vain luku -tilassa, mutta voit jatkaa komentosarjan muokkaamista. Voit päivittää esikatselun muutosten jälkeen valitsemalla Päivitä esikatselu - painikkeen seuraavan kuvan bannerissa esitetyllä tavalla.
Esikatselunäytön oikeassa yläkulmassa on työkalurivi, jolla voit siirtyä kaikkien koodi-erojen välillä. Voit sen avulla siirtyä sisäisestä ja vierekkäistä eroa, tarkastella tai piilottaa muuttumattomia alueita ja sulkea esikatselunäkymän.
Sinun on huomioitava muutamia seikkoja, kun esikatselet semanttisen mallin muutoksia:
- TMDL-näkymä palauttaa tarkastelumääritykset oletukset kunkin esikatselun suorittamisen kohdalla.
- Esikatselu suoritetaan vain käyttämällä kelvollista TMDL-muutosta. Virheelliset TMDL-komentosarjat eivät suorita esikatselua, ja tulosteruudussa näkyy virhe.
TMDL-komentosarjan välilehdet
TMDL-näkymässä voi olla kerralla useita komentosarjavälilehtiä, joista mikä tahansa voidaan nimetä uudelleen tai poistaa.
Ruudut Ongelmat- ja Tuloste- näyttävät tällä hetkellä valittuna ja näytettävässä komentosarjavälilehdessä olevat virheet ja sanomat. Eri TMDL-komentosarjavälilehteen siirtyminen päivittää molemmat ruudut valittuun ja parhaillaan näytettävään välilehteen liittyvät tiedot.
Voit tyhjentää Output -ruudun viestit valitsemalla Tyhjennä -painikkeen.
Viestit säilytetään vain jokaisessa Power BI Desktop -istunnossa, joten Power BI Desktopin uudelleenkäynnistäminen tyhjentää kaikki tulosteviestit kaikista komentosarjavälilehdistä.
Power BI Desktopin TMDL-näkymässä raporttitiedosto tallentaa TMDL-näkymän välilehtien sisällön, joten voit jatkaa siitä, mihin jäit, kun avaat Power BI Desktop -raporttitiedoston. Kun tallennat Power BI -projektiin (PBIP), jokainen komentosarjavälilehti tallennetaan .tmdl-tiedostona kansioon \TMDLScripts seuraavan kuvan mukaisesti.
Juomaraha
Voit avata ja muokata TMDL-skriptejä Visual Studio Code:ssa, ja ne latautuvat kunnolla Power BI Desktopin uudelleenkäynnistyksen jälkeen.
TMDL-näkymässä verkossa skriptivälilehtiä ja skriptin sisältöä ei säilytetä. Ne hylätään, kun semanttinen malli tai selainistunto suljetaan.
Yhteensopivuustason päivityskehote
Power BI:n semanttisen mallin yhteensopivuustaso määrittää ominaisuudet, jotka ovat käytettävissä. TMDL-näkymän avulla voit lisätä minkä tahansa Analysis Services -objektin tai -ominaisuuden, vaikka se ei olisikaan käytettävissä nykyisellä yhteensopivuustasolla. Kun otat käyttöön yhteensopivuustason päivitystä edellyttävän muutoksen, TMDL-näkymässä on kehote, joka ilmaisee, mikä objekti tai objekti edellyttää päivitystä.
Objektin uudelleennimeäminen TMDL-näkymässä
Jos haluat nimetä objektin uudelleen TMDL-näkymässä, on komentosarja sen pääkohteessa. Esimerkiksi sarakkeen uudelleennimeäminen edellyttää taulukon komentosarjaa, mutta taulukon uudelleennimeäminen edellyttää koko semanttisen mallin komentosarjoja. Lisätietoja taulukkomuotoisen objektimallin hierarkiasta on seuraavassa asiakirjassa: Taulukko-objektimallin hierarkia.
TMDL-näkymässä joukkonimeäminen voidaan suorittaa tehokkaasti käyttämällä yksinkertaisia etsi- ja korvaamismalleja. Voit esimerkiksi nimetä kaikki taulukon sarakkeet uudelleen pieniksi kirjaimiksi toimimalla seuraavasti.
Avaa TMDL-näkymä ja komentosarja muokattava taulukko.
Avaa Etsi ja korvaa -valintaikkuna painamalla CTRL + F. Varmista, että Säännönmukainen lauseke -asetus on käytössä.
Anna seuraavat mallit Etsi ja korvaa -kenttiin ja valitse Korvaa kaikki.
| Toimi | Malli / korvaaminen |
|---|---|
| Löytää | (^\s+column\s+)(.+) |
| Korvaa | $1\L$2 |
Suorita TMDL-komentosarja, jotta voit nimetä kaikki taulukon sarakkeet uudelleen pieniksi kirjaimiksi heti:
Huomaa, että sarakkeen nimi eroaa sourceColumn-ominaisuudesta.
Semanttisen mallitaulukon ja Power Query -kyselyn välinen synkronointi perustuu sourceColumn-sarakkeeseen, jolloin nimet pysyvät riippumattomina. Kun avaat Power Query -editorin, se näyttää sourceColumn-saraketta vastaavat sarakenimet mallin sarakkeen nimen sijaan. Lisäksi sarakkeen nimeäminen uudelleen käyttöliittymässä ei lisää automaattisesti uudelleennimeämisvaihetta kyselyyn, ennen kuin sourceColumn ja sarakkeen nimi ovat samat.
TMDL-näkymä ja Power BI -projekti
Kun tallennat työsi Power BI -projektina (PBIP), saat käyttöösi semanttisen mallin määrityksen metatiedot, kuten TMDL-tiedostoja. Ne tarjoavat hyödyllisen lähdekoodin hallinnan ja rinnakkaiskehityskokemuksen. Samalla voit myös tehdä muutoksia semanttiseen malliin Power BI Desktopin ulkopuolella. Jos kuitenkin muokkaat TMDL-tiedostoja PBIP:ssä, sinun on käynnistettävä Power BI Desktop uudelleen, jotta voit ladata nämä muutokset uudelleen. Sitä vastoin TMDL-näkymä noudattaa komentosarjojen henkistä mallia, jonka avulla voit tehokkaasti ottaa käyttöön muutokset suoraan semanttiseen malliin, jota muokataan Power BI Desktopissa TMDL:n avulla riippumatta siitä, onko tiedostomuoto PBIX vai PBIP.
Voit integroida molemmat käyttökokemukset saumattomasti. Voit esimerkiksi päivittää TMDL-määrityksen PBIP:ssä nopeita muutoksia varten käynnistämättä Power BI Desktopia, ja käyttää TMDL-näkymää, kun Power BI Desktop on jo avoin, jotta voit tehokkaasti ottaa käyttöön joukon muutoksia semanttiseen malliin TMDL:n avulla. Molemmat menetelmät tarjoavat monipuolisen ja yhtenäisen TMDL-koodauskokemuksen.
Juomaraha
Jos haluat parantaa TMDL-luontikokemusta, kun muokataan TMDL-tiedostoja ulkoisesti Visual Studio Codessa, käytä TMDL Visual Studio Code Extensionia. Tämä laajennus tarjoaa DAX- ja Power Query -semanttisen korostustuen, automaattisen täydennyksen, diagnostiikan, kooditoiminnot, koodin muotoilun, leivänmurunavigoinnin ja lokalisoinnin TMDL-dokumenteille.
TMDL view in Power BI -palvelu (preview)
Käytä TMDL-näkymää verkossa skriptataksesi, muokataksesi ja soveltaaksesi muutoksia julkaistuihin semanttisiin malleihisi. TMDL-näkymä verkossa tarjoaa saman kokemuksen kuin Power BI Desktop, muutamia poikkeuksia lukuun ottamatta.
| Keskeinen ero | TMDL-näkymä Power BI Desktopissa | TMDL-näkymä verkossa (Esikatselu) |
|---|---|---|
| Näkymätila ja muokkaustila | Ei erillistä pelimuotoa – voit tehdä ja tehdä muutoksia malliin milloin tahansa. | Esittelee kaksi tilaa: Näkymätila (skriptien ja esikatselumuutosten tekemiseen) ja Muokkaustilan (mallin soveltamiseen). Tämä ominaisuus mahdollistaa turvallisemman kokeilun ennen muutosten tekemistä. |
| Skriptin pysyvyys | TMDL-skriptit tallennetaan osana semanttista mallia. Malli saattaa sisältää aiemmin tallennettuja skriptejä. | Käsikirjoituksia ei säilytetä. Järjestelmä hylkää ne, kun semanttinen malli tai selain suljetaan. Aiemmin tallennettuja skriptejä ei näytetä. |
| Versiohistorian tuki | Ei käytettävissä. | Hyödyntää työtilan versiohistoriaa palauttaakseen aiemmat semanttisen mallin versiot tarvittaessa. |
| Kirjoitusoikeudet | Ei käytettävissä. Työpöydän luominen ei perustu työtilan käyttöoikeustasoihin. | Vaatii kirjoitusoikeudet semanttiseen malliin** avatakseen ja käyttääkseen kokemusta. |
Yleisiä TMDL-näkymän käyttötapauksia
skenaario: minun on käytettävä semanttinen mallitaulukko uudelleen tai jaettava semanttinen taulukko, jossa on täydellinen määritys, mukaan lukien sarakkeet, Power Query -lauseke ja lajittelu määritysten mukaan ja muut toisen semanttisen mallin kohteet.
Ratkaisu: Avaa semanttinen malli taulukolla ja komentosarja sen TMDL-näkymän avulla. Kopioi komentosarja toiseen Power BI Desktop -ikkunaan, avaa TMDL-näkymän välilehti ja ota komentosarja käyttöön.
skenaario: olen nimennyt kaikki taulukkoni etuliitteillä "dim_" tai "fact_". Haluan poistaa nämä etuliitteet päivittämättä manuaalisesti kutakin yli 100 taulukkoa.
ratkaisu: Avaa TMDL-näkymä, komentosarja semanttinen malli, etsi etuliite (säännönmukaisia lausekkeita tuetaan) ja korvaa se tyhjällä tekstillä.
skenaario: minun on luotava perspektiivi semanttiseen malliini, jotta voin käyttää mukautettujen visualisointien ominaisuutta. En kuitenkaan voi luoda tai muokata sitä Power BI Desktopin graafisella käyttöliittymällä.
ratkaisu: Avaa TMDL-näkymä, luo uusi tyhjä välilehti (tai käytä komentosarjaa olemassa olevasta perspektiivistä) ja luo tai muokkaa perspektiiviä TMDL:n avulla. Tämä menetelmä koskee myös muita semanttisia mallin metatietoja, joista puuttuu graafinen liittymä, kuten käännökset, yksityiskohtaiset rivilausekkeet ja muut.
createOrReplace
perspective SalesView
perspectiveTable Sales
perspectiveMeasure 'Sales Amount'
perspectiveMeasure 'Sales Qty'
perspectiveColumn Quantity
perspectiveColumn 'Amount'
skenaario: minun on muokattava taulukkoni Power Query -lauseketta käynnistämättä päivitystä.
Ratkaisu: taulukon komentosarjaa, muokkaa Power Query -lauseketta ja ota muutokset käyttöön. TMDL-näkymä ei vaadi tietojen päivittämistä.
skenaario: minun on vaihdettava taulukkoni tallennustila DirectQuerystä tuontitilaan ja päinvastoin
Ratkaisu: Taulukon komentosarja, päivitä osiotila ja ota muutokset käyttöön.
skenaario: minun on varmuuskopioitava semanttinen mallimääritelmäni ennen merkittävien muutosten tekemistä ja tarvittaessa helppo palata edelliseen määritykseen.
ratkaisu: Komentosarjaan semanttinen malli tai tietyt osat, jotka haluat varmuuskopioida, tee muutokset muissa näkymissä ja palaa tarvittaessa TMDL-näkymään palauttamaan edelliset metatiedot suorittamalla tallennettu komentosarja.
Huomioitavat asiat ja rajoitukset
- TMDL-näkymän avulla voit muokata mitä tahansa semanttisen mallin objektia tai ominaisuutta. Puutteelliset tai virheelliset muutokset voivat kuitenkin johtaa odottamattomaan toimintaan. Lisätietoja näistä toiminnoista on artikkelissa Mallin luominen.
- Komento - näyttää komentoja, joita ei tällä hetkellä tueta.
- ensimmäisen Git -integroinnin määrittäminen työtila ei sisällä julkaistuun semanttiseen malliin tallennettuja TMDL-näkymän komentosarjoja. Lue lisää artikkelista Fabric Git -integrointi.
Aiheeseen liittyvä sisältö
Seuraavissa artikkeleissa kerrotaan lisää TMDL:stä ja sen käytöstä.
- TMDL- käytön aloittaminen
- TMDL (Tabular Model Definition Language) -
- Power BI Desktopin projektien (esikatselu)
- Power BI Desktop -projektin semanttisen mallin kansio