Usean asiakkaan sovellusten siirtäminen palvelun päänimiprofiilien malliin
Tässä artikkelissa kuvataan, miten voit parantaa skaalattavuutta siirtämällä upotetun Power BI -analytiikan usean asiakkaan sovellukset palvelun päänimiprofiilien malliin.
Palvelun pääprofiilien avulla on helpompi hallita organisaation sisältöä Power BI:ssä ja käyttää kapasiteettejasi entistä tehokkaammin.
Muistiinpano
Tämä artikkeli on tarkoitettu organisaatioille, joilla on jo sovellus, joka tukee useita asiakkaita yhdestä Power BI -vuokraajasta.
Kaikki sovellukset eivät hyödy palvelun päämallista. Esimerkiksi seuraavien sovellusten ei pitäisi siirtyä:
- Pienet sovellukset, jotka säilyttävät yhden palvelun päänimen ja pienen objektimäärän.
- Sovellukset, jotka käyttävät yhtä, useampaa palvelun päänimeä asiakasta kohti
Edellytykset
On tärkeää lukea palvelun pääprofiilista ennen siirron aloittamista.
Sinun on myös tehtävä seuraavat toimet:
- Voit määrittää palvelun päänimen Power BI -sisällön upottamisen ja palvelun päänimen kolmen ensimmäisen vaiheen avulla.
- Ota käyttöön profiilien luominen vuokraajassa Power BI -vuokraajan järjestelmänvalvojan tililtä.
Palvelun pääprofiiliin siirtyminen
Palvelun pääprofiiliin siirtyminen sisältää seuraavat vaiheet:
- Luo profiileja, yksi profiili asiakasta kohti.
- Voit järjestellä työtiloja.
- Muuta sovelluskoodi käyttämään profiileja.
- Testaa sovellustasi profiilimallin avulla.
- Tyhjennä tarpeettomat käyttöoikeudet.
Profiilien luominen (pakollinen)
Luo yksi profiili kullekin asiakkaalle käyttämällä profiilien REST-ohjelmointirajapintaa luomasi palvelun päänimen kanssa.
On hyvä tallentaa kunkin tietojen asiakastunnuksen yhdistämismääritys, jossa on vastaava profiilitunnus tietokannassasi. Tarvitset tämän yhdistämismäärityksen myöhemmin, jotta voit tehdä API-kutsuja vuokraajaprofiilissa.
Työtilojen järjesteleminen
Helpoin tapa hallita tietoja on ylläpitää yhtä työtilaa asiakasta kohden. Jos sovelluksesi käyttää jo tätä mallia, sinun ei tarvitse luoda uusia työtiloja. Sinun on kuitenkin silti annettava jokaiselle profiilille järjestelmänvalvojan käyttöoikeus vastaavaan työtilaan Lisää ryhmän käyttäjä -ohjelmointirajapinnan avulla.
Jos sinulla ei ole yhtä työtilaa asiakasta kohden, käytä vastaavaa profiilia kutsumaan Luo ryhmän käyttäjä -ohjelmointirajapintaa luodaksesi uuden työtilan kullekin asiakkaalle.
Järjestä kohteet työtiloissa
Sinulla pitäisi nyt olla profiili ja työtila kullekin asiakkaalle. Jos loit uusia työtiloja edellisessä vaiheessa, sinun on tuotava kohteita (kuten raportteja ja semanttisia malleja) näihin työtiloihin. Tuomasi semanttiset mallit riippuvat nykyisestä ratkaisustasi:
Jos sovelluksesi käyttää asiakkaalle erillistä semanttista mallia, semanttinen mallirakenne voi toimia sellaisenaan.
Jos sovelluksesi käyttää yhtä semanttista mallia ja rivitason suojausta (RLS) eri tietojen tarjoamiseen eri asiakkaille, voit parantaa skaalattavuutta luomalla kullekin asiakkaalle erillisen semanttisen mallin ja käyttämällä tässä artikkelissa kuvattuja profiileja.
Kun olet ohittanut skaalattavuuden rajoitukset käyttämällä profiileja ja erillisiä tietolähteitä, voit saada entistä enemmän tietojen erittelyä käyttämällä rivitason suojausta profiilien kanssa.
- Jos käytät dynaamista rivitason suojausta, profiilin nimi palautetaan DAX-funktiossa
UserName()
. - Jos käytät staattista rivitason suojausta ja ohitat roolit upotustunnusta muodostettaessa, voit jatkaa tämän tekemistä.
- Jos käytät dynaamista rivitason suojausta, profiilin nimi palautetaan DAX-funktiossa
Kun kohteet ovat valmiita, tuo ne asianmukaisiin työtiloihin. Voit automatisoida prosessin käyttämällä tuonnin ohjelmointirajapintaa.
Sovelluskoodien muuttaminen profiilien käyttämistä varten
Kun sinulla on profiileja, joilla on järjestelmänvalvojan käyttöoikeus asianmukaisiin työtiloihin, ja tietokannan, jossa on yhdistämismääritys, joka osoittaa, mikä profiili edustaa mitäkin asiakasta, voit tehdä tarvittavat koodimuutokset. Suosittelemme, että pidät kaksi koodityönkulkua rinnakkain ja paljastat profiilikoodin kulun vähitellen asiakkaillesi.
Tee seuraavat koodimuutokset:
Valtuutuskoodin muutos
- Jos käytät pääkäyttäjää Microsoft Entra ID -sovelluksessa, muuta hanki-tunnuskoodia. Lue upotus palvelun päänimellä , niin opit luomaan sovelluksen sisältävän Microsoft Entra -tunnuksen.
- Jos käytät palvelun päänimeä ja olet luonut uuden profiilin profiileille, muuta koodia käyttämään oikeaa palvelun päänimen tunnusta ja salaisia koodeja.
Hallintakoodin muutos
Joissakin sovelluksissa on hallintakoodi, joka automatisoi uuden asiakkaan perehdyttämisen rekisteröinnin yhteydessä. Usein hallintakoodi käyttää Power BI REST -ohjelmointirajapintoja työtilojen luomiseen ja sisällön tuomiseen. Suurimman osan tästä koodista pitäisi pysyä samana, mutta sinun on ehkä mukautettava seuraavia tietoja:
- Aina, kun luot uuden asiakasvuokraajan, luo uusi palveluprofiili kyseisen vuokraajan työtilan luojaksi ja järjestelmänvalvojaksi.
- Jos päätät järjestää Power BI -sisältösi uudelleen, muokkaa koodia muutosten mukaisesti.
Upotustunnuksen koodin muutos
Korvaa ohjelmointirajapinnan soittaja. Varmista, että profiili kutsuu GenerateToken-ohjelmointirajapintaa , koska profiilimallissa vain kyseisellä profiililla on pääsy asiakkaan sisältöön.
Tarkistaminen
On parasta testata sovellus perusteellisesti ennen sen siirtämistä profiilimalliin. Raportit saattavat latautua, vaikka SaaS-sovelluskoodissa olisi virheitä, koska et poistanut työtilojen vanhempia käyttöoikeuksia.
Siivoaminen siirron jälkeen
Nyt kun olet suorittanut siirron ja vahvistanut tulokset, poista se, mitä et enää tarvitse.
- Puhdista koodi: Haluat ehkä poistaa vanhat koodipolut käytöstä varmistaaksesi, että käytät vain uutta koodia, joka käyttää profiileja.
- Puhdista työtiloja ja käyttöoikeuksia Power BI:ssä: Jos olet luonut uusia työtiloja, voit poistaa vanhat työtilat, jotka eivät ole enää käytössä. Jos olet käytät samoja työtiloja uudelleen, haluat ehkä poistaa työtilan vanhemmat käyttöoikeudet (kuten pääkäyttäjän käyttöoikeudet).
Liittyvä sisältö
Palvelun pääprofiilien hallinta
Onko sinulla lisää kysymyksiä? Voit esittää kysymyksiä Power BI -yhteisössä