Azure Cosmos DB for MongoDB vCore

Yhteenveto

Vaihtoehto	Kuvaus
Julkaisutila	Beeta
Tuetut tuotteet	Power BI (semanttiset mallit) Power BI (tietovuot) Fabric (Tietovuo Gen2)
Tuetut todennustyypit	Perus (käyttäjänimi/salasana) kaikille Power BI Desktopille, Power Query Onlinelle yhdyskäytävän kanssa ja Power Query Onlinelle
Funktioiden viitedokumentaatio	Direct Query -funktion tuki Power Query M -funktion viittaus

Ennakkovaatimukset

Tuetut toiminnot

• Tuontitila
• DirectQuery-tila (semanttiset Power BI -mallit)
  • Tuetut Power Query -funktiot
• Alkuperäiset Mongo-kyselyt

Yhteyden muodostaminen Azure Cosmos DB for MongoDB vCore -tietokantaan Power Query Desktopista

Jos haluat muodostaa yhteyden Power Query Desktopista Azure Cosmos DB for MongoDB vCoreen, toimi seuraavasti:

1. Valitse Azure Cosmos DB for MongoDB vCoreKohdassa Nouda tiedot . Power Query Desktopin Nouda tiedot -käyttökokemus vaihtelee sovellusten välillä. Lisätietoja sovelluksen Power Query Desktopin Nouda tiedot -käyttökokemuksesta on kohdassa Tietojen noutaminen.

2. Anna Azure Cosmos DB for MongoDB vCoressa Cosmos DB -päätepiste. Anna valinnaisesti tietokannan nimi ja kokoelman nimi. Jos tietokannan nimeä ei ole annettu, tuleva Siirtymistoiminto-näyttö näyttää kaikki tietokannat ja niiden kokoelmat. Sekä tietokannan että kokoelman nimien määrittäminen näyttää vain kyseisen kokoelman. Kokoelman nimen määrittäminen ilman tietokannan nimeä aiheuttaa yhteysvirheen.

   .

3. Valitse joko Tuo-- tai DirectQuery--yhteystila.

4. Valitse OK.

5. Jos muodostat yhteyden tietokantaan ensimmäistä kertaa, kirjoita käyttäjänimesi ja salasanasi ennen Yhdistä-kohdan valitsemista.

   

6. Valitse siirtymistoiminnossa haluamasi tietokantatiedot. Kokoelmaluettelo näkyy jokaisessa tietokannassa. Valitse yksi tai useampi kokoelma ja valitse sitten Lataa ladataksesi tiedot tai Muunna tiedot jatkaaksesi tietojen muuntamista Power Query -editorissa. Tämä vaikuttaa tietokantojen ja kokoelmien luetteloon, jos valinnainen tietokannan nimi ja kokoelman nimi on annettu aiemmin.

   

Yhteyden muodostaminen Azure Cosmos DB for MongoDB vCore -tietokantaan Power Query Onlinesta

Yhteyden muodostaminen Azure Cosmos DB for MongoDB vCore -tietokantaan Power Query Onlinesta:

1. Valitse Azure Cosmos DB for MongoDB vCore -vaihtoehto Nouda tiedot -käyttökokemuksessa. Eri sovelluksilla on eri tapoja päästä Power Query Onlinen tietojen noutamiseen. Lisätietoja siitä, miten pääset Power Query Onlinen tietojen noutamiseen sovelluksestasi, on kohdassa Mistä tiedot noudataan.

   

2. Anna näkyviin tulevassa Azure Cosmos DB for MongoDB vCore -valintaikkunassa Cosmos DB -päätepiste. Anna valinnaisesti tietokannan nimi ja kokoelman nimi. Jos tietokannan nimeä ei ole annettu, tuleva Siirtymistoiminto-näyttö näyttää kaikki tietokannat ja niiden kokoelmat. Sekä tietokannan että kokoelman nimien määrittäminen näyttää vain kyseisen kokoelman. Kokoelman nimen määrittäminen ilman tietokannan nimeä aiheuttaa yhteysvirheen.

   

3. Voit valita aiemmin luodun yhteyden tai tietoyhdyskäytävän. Voit muodostaa yhteyden määrittämällä perustodentamislajin, joka määrittää päätepisteeseen liittyvän käyttäjänimen ja salasanan yhteyden tunnistetiedot -osiossa ja valitsemalla Seuraava.

4. Valitse yksi tai useampi taulukko tuotavana ja käytettävänä ja valitse sitten Muunna tiedot tietojen muuntamista varten Power Query -editorissa.

Alkuperäiset Mongo-kyselyt

Mukautettu Value.NativeQuery funktio mahdollistaa alkuperäisten MongoDB-kyselyiden lähettämisen tietolähteeseen. Seuraavassa esimerkissä näytetään, miten voit luoda taulukon funktion avulla tietoja ladattaessa. Tämä funktio voidaan kuitenkin käynnistää milloin tahansa, kun Muunna tiedot - vaihtoehto on käytettävissä.

Alkuperäisiä Mongo-kyselyitä tuetaan vain Direct Query - tilassa.

1. Valitse siirtymistoiminnossa vähintään yksi kokoelma ja valitse sitten Muunna tiedot.

   

2. Valitse Laajennettu editori. Näyttöön tulee Laajennettu editori -valintaikkuna, jossa näkyy alkuperäinen kysely, jota käytettäisiin kaikkien valitun kokoelman tietojen noutamiseen.

   

3. Funktiolla Value.NativeQuery on kaksi argumenttia: Lähde ja itse kysely. Source-muuttujaan täytetään kaikki tiedot, joita tarvitaan yhteyden muodostamiseen tietokantaan. Päivitä tarvittaessa sen kokoelman nimi, jota vastaan kysely suoritetaan. Kokoelman ei tarvitse olla sama kuin siirtymistoiminnossa valittu kokoelma.

   

4. Toinen argumentti on kelvollinen MongoDB-kysely lainausmerkeissä. Kyselyn lainausmerkit on lainausmerkeissä, jossa on lainausmerkki, "num1" esimerkiksi kohteeseen ""$num1""

5. Muunna tiedot valitsemalla Valmis .

6. Koska Cosmos DB:stä ei palauteta rakennetietoja kyselyn suorittamisen jälkeen, tuloksena oleva taulukko tunnistaa kaikki saraketyypit minä tahansa. Muunna sarakkeet käyttämällä Tunnista tietotyyppi -toimintoa tai muuta tietotyyppi manuaalisesti kiinnostavien sarakkeiden kohdalla. Päivitä tulostaulukon nimi tarvittaessa.

   

7. Kun Power Query -editori on suljettu ja muutokset otettu käyttöön, tuloksena oleva taulukko tulee näkyviin Tieto-ruutuun .

   

Katso funktion rajoitukset Value.NativeQuerykohdasta Vianmääritys ja rajoitukset.

Suorien kyselyjen tuki

Suora kysely tukee seuraavia Power Query -funktioita:

• Date.From, DateTime.From, DateTimeZone.From, Date.Day, Date.DayOfWeekDate.DayOfYear, Date.Month, , Date.WeekOfYearDate.Year
• List.Average, List.Contains, List.First, List.LastList.Max, , List.MinList.Sum
• Int64.From, Currency.From, Percentage.From, Text.FromLogical.From, , Logical.FromTextLogical.ToText
• Number.Abs, Number.Mod, Number.Round, Number.RoundAwayFromZeroNumber.RoundDown, , Number.RoundTowardZeroNumber.RoundUp
• Table.RowCount
• Time.Hour, Time.Minute, Time.Second
• Value.Add, Value.Divide, Value.Equals, Value.Multiply, Value.NullableEquals, Value.Subtract

Vianmääritys ja rajoitukset

• Koska Power Query -tekstifunktioita ei vielä tueta, kumpikaan ei käytä tekstisuodattimia sarakkeessa muuntaessasi tietojaDirect Query - tilassa.

  • Esimerkkejä tällaisista suodattimista: Alkaa merkkijonolla, päättyy merkkijonolla, Sisältää jne.
  • Näyttöön tulee virhesanoma, joka muistuttaa toimintoa Ei tueta: Ei tueta -funktiokutsu: 'Text.StartsWith'

• Koska kaikkia Power Query -funktioita ei tueta Direct Querya käytettäessä, siirry joko tuontitilaan tai lähetä alkuperäinen Mongo-kysely , joka suorittaa yhden tai useamman puuttuvan Power Query -funktion tarkoituksen.

• Rakenteen tietoja ei palauteta, kun käytössä on Native Mongo Queries. Kaikki sarakkeet otetaan huomioon any , ja ne on muunnettava manuaalisesti haluttuun tietotyyppiin.

• Mukautettu Value.NativeQuery funktio ottaa mallit vain ensimmäisestä kyselystä palautetusta asiakirjasta tuloksena olevan taulukon muodostamiseksi. Tästä seuraa, että jos myöhemmissä asiakirjoissa on enemmän kenttiä, nämä kentät eivät sisälly tuloksena syntyvään taulukkoon. Joko projektikohtaiset sarakkeet tai kyselyt tietystä käsittelynäkymästä.

• Mukautettua Value.NativeQuery funktiota voi käyttää vain suoran kyselyn kanssa tuontitilan sijaan.

• Power BI jättää millisekunnit pois päivämäärätyypeistä, kun sisäistä suodatinta käytetään. Jos päivämäärätyypissä on millisekunteja, nämä sisäiset suodattimet eivät toimi.

• Negatiiviset OLE-ajat (päivämäärät ennen vuotta 1899, 30. joulukuuta) arvolle Date.From, DateTime.Fromja DateTimeZone.From eivät toimi.

• Power BI -funktion käyttö aiheuttaa virheen (400): Cosmos DB -DateTimeZone.Frompalvelimessa oleva Virheellinen pyyntö -virhesanoma, koska dateFromString toimintoa ei lisätä Cosmos DB for MongoDB:hen.

• Erikoismerkkejä sisältäviä kenttien nimiä ei tueta (esimerkiksi $, ., @, jne.).

• Kun jako 0:lla ilmenee Direct Queryn avulla, kysely epäonnistuu. Se eroaa tavallisesta #infinity Power BI -tuloksesta, mutta on yhdenmukainen MongoDB:n toiminnan kanssa.

• Seuraavia tietotyyppejä pidetään tällä hetkellä merkkijonoina. Tällaisten tietotyyppien arvoja ei voi käyttää suodattamiseen Direct Queryssa, koska lähettäminen epäonnistuu:

  • desimaali128
  • regularExpression
  • aikaleima

• Suositus mille tahansa Kentälle, jota haluat käyttää Power BI:ssä, on varmistaa, että kyseinen kenttä on kokoelmasi jokaisessa asiakirjassa. Se varmistaa, että se näkyy aina Power BI:ssä.