Azure Cosmos DB pro MongoDB vCore

Shrnutí

Položka	Popis
Stav vydání	Beta
Podporované produkty	Power BI (sémantické modely) Power BI (Datové toky) Datová struktura (Dataflow Gen2)
Podporované typy ověřování	Základní přihlašovací údaje (uživatelské jméno / heslo) pro všechny aplikace: Power BI Desktop, Power Query Online s bránou i bez ní.
Referenční dokumentace k funkcím	Podpora Referenční informace k funkcím Power Query M

Požadavky

Podporované možnosti

• Režim importu
• Režim direct query (sémantické modely Power BI)
  • Podporované funkce Power Query
• Nativní dotazy Mongo

Připojení k databázi virtuálních jader Azure Cosmos DB pro MongoDB z Power Query Desktopu

Pokud se chcete připojit k virtuálnímu jádru Azure Cosmos DB pro MongoDB z Power Query Desktopu, proveďte následující kroky:

1. V prostředí Získat data vyberte Azure Cosmos DB pro MongoDB vCore. Prostředí získávání dat v Power Query Desktop se liší mezi různými aplikacemi. Další informace o prostředí Získat data v Power Query Desktopu pro vaši aplikaci najdete v části Kde získat data.

2. Ve službě Azure Cosmos DB pro virtuální jádro MongoDB zadejte koncový bod Cosmos DB. Volitelně zadejte název databáze a název kolekce. Pokud není zadaný název databáze, zobrazí se na nadcházející obrazovce Navigátor všechny databáze a jejich příslušné kolekce. Zadání názvů databází i kolekcí zobrazuje pouze tuto kolekci. Zadání názvu kolekce bez názvu databáze způsobí chybu připojení.

   

3. Vyberte buď režim připojení k datům Import, nebo DirectQuery.

4. Vyberte OK.

5. Pokud se k této databázi připojujete poprvé, zadejte své uživatelské jméno a heslo před výběrem možnosti Připojit.

   

6. V Navigátoru vyberte požadované informace o databázi. V každé databázi se zobrazí seznam kolekcí. Vyberte jednu nebo více kolekcí a pak buď výběrem Načíst načtěte data, nebo Transformovat data pokračujte v transformaci dat v Editoru Power Query. Seznam databází a kolekcí je ovlivněn, pokud byl dříve zadán volitelný název databáze a název kolekce.

   

Připojení k databázi virtuálních jader Azure Cosmos DB pro MongoDB z Power Query Online

Připojení k databázi virtuálních jader Azure Cosmos DB pro MongoDB z Power Query Online:

1. V prostředí pro získávání dat vyberte možnost Azure Cosmos DB pro MongoDB vCore. Různé aplikace mají různé způsoby, jak se dostat k získání dat v prostředí Power Query Online. Další informace o tom, jak získat data z aplikace do Power Query Online, najdete v tématu Kde získat data.

   

2. V dialogovém okně Azure Cosmos DB for MongoDB vCore, které se zobrazí, zadejte koncový bod Cosmos DB. Volitelně zadejte název databáze a název kolekce. Pokud není zadaný název databáze, zobrazí se na nadcházející obrazovce Navigátor všechny databáze a jejich příslušné kolekce. Zadání názvů databází i kolekcí zobrazuje pouze tuto kolekci. Zadání názvu kolekce bez názvu databáze způsobí chybu připojení.

   

3. Můžete vybrat existující připojení nebo bránu dat. Můžete se připojit zadáním základního typu ověřování a zadáním uživatelského jména a hesla přidruženého ke koncovému bodu v části přihlašovacích údajů připojení a výběrem možnosti Další.

4. Vyberte jednu nebo více tabulek, které chcete importovat a použít, a pak vyberte Transformovat data a transformovat data v editoru Power Query.

Nativní dotazy Mongo

Vlastní Value.NativeQuery funkce umožňuje odesílání nativních dotazů MongoDB do zdroje dat. Následující příklad ukazuje, jak pomocí funkce vytvořit tabulku při počátečním načítání dat. Tuto funkci však lze vyvolat kdykoli, když je k dispozici možnost Transformovat data .

Nativní dotazy Mongo jsou podporovány pouze v režimu přímého dotazu .

1. Vyberte pomocí Navigátoru alespoň jednu kolekci a zvolte Transformovat data.

   

2. Zvolte Rozšířený editor. Zobrazí se dialogové okno Rozšířený editor s počátečním dotazem, který by se použil k načtení všech dat ve vybrané kolekci.

   

3. Funkce Value.NativeQuery má dva argumenty : zdroj a samotný dotaz. Proměnná source se naplní všemi informacemi potřebnými pro připojení k databázi. V případě potřeby aktualizujte název kolekce, pro kterou se dotaz spouští. Kolekce nemusí být stejná jako kolekce vybraná v navigátoru.

   

4. Druhým argumentem je platný dotaz MongoDB uzavřený do dvojitých uvozovek. Uvozovky v dotazu jsou ošetřeny dalšími uvozovkami, například "num1" na ""$num1""

5. Zvolte Hotovo a transformujte data.

6. Vzhledem k tomu, že po spuštění dotazu se z Cosmos DB nevrátí žádné informace o schématu, výsledná tabulka identifikuje všechny typy sloupců jako všechny. Transformujte sloupce pomocí funkce Zjistit datový typ nebo ručně změňte datový typ pro sloupce, které jsou zajímavé. V případě potřeby aktualizujte název výsledné tabulky.

   

7. Po zavření Editoru Power Query a použitých změnách se výsledná tabulka zobrazí v podokně Data .

   

Informace o omezeních funkce najdete v tématu Value.NativeQuery.

Podpora přímých dotazů

Direct Query podporuje následující funkce Power Query:

• Date.From, DateTime.From, , DateTimeZone.FromDate.DayDate.DayOfWeekDate.DayOfYearDate.Month, , Date.WeekOfYearDate.Year
• List.Average, List.Contains, List.First, List.Last, List.Max, , List.MinList.Sum
• Int64.From, Currency.From, Percentage.From, Text.From, Logical.From, , Logical.FromTextLogical.ToText
• Number.Abs, Number.Mod, Number.Round, Number.RoundAwayFromZero, Number.RoundDown, , Number.RoundTowardZeroNumber.RoundUp
• Table.RowCount
• Time.Hour, Time.MinuteTime.Second
• Value.Add, Value.Divide, Value.Equals, Value.Multiply, , Value.NullableEqualsValue.Subtract

Řešení potíží a omezení

• Vzhledem k tomu, že textové funkce Power Query ještě nejsou podporované, ani při transformaci dat v režimu Direct Query nepoužívá filtry textu ve sloupci.

  • Příklady takových filtrů: Začíná na, Končí na, Obsahuje atd.
  • Chybová zpráva se podobá Nepodporovaná operace: Nepodporované vyvolání funkce: 'Text.StartsWith'

• Protože se při použití Direct Query nepodporují všechny funkce Power Query, přepněte do režimu importu nebo zadejte nativní dotaz Mongo, který provádí záměr jedné nebo více chybějících funkcí Power Query.

• Při použití nativních dotazů Mongo se nevrátí žádné informace o schématu. Všechny sloupce se považují any a je potřeba je ručně transformovat na požadovaný datový typ.

• Vlastní Value.NativeQuery funkce vzorkuje pouze první dokument vrácený z dotazu, aby se vytvořila výsledná tabulka. Výsledkem je, že pokud v následných dokumentech existuje více polí, nebudou tato pole zahrnuta do výsledné tabulky. Promítání konkrétních sloupců nebo dotazování na konkrétní kompenzační zobrazení

• Vlastní Value.NativeQuery funkci lze použít pouze s přímým dotazem a ne s režimem importu.

• Power BI při použití integrovaného filtru zahodí milisekundy z typů kalendářních dat. Pokud tedy typ data obsahuje milisekundy, nebudou tyto předdefinované filtry fungovat.

• Záporné časy OLE (data z období před 1899, prosinec 30) pro Date.From, DateTime.Froma DateTimeZone.From nefungují.

• Výsledkem použití funkce Power BI DateTimeZone.From je (400): Špatný požadavek ze serveru Cosmos DB, protože funkce dateFromString není přidána do Cosmos DB pro MongoDB.

• Názvy polí, které obsahují speciální znaky, $nejsou podporovány (například , ., @atd.).

• Pokud při použití Direct Query dojde k dělení nulou, dotaz selže. Liší se od obvyklého #infinity výsledku Power BI, ale odpovídá chování MongoDB.

• Následující datové typy jsou aktuálně považovány za řetězce. Proto nelze hodnoty s těmito datovými typy použít k filtrování v Direct Query, protože prosazování selže.

  • decimal128
  • regularExpression
  • časové razítko

• Doporučení pro jakékoli pole, které chcete použít v Power BI, je zajistit, aby se toto pole nachází v každém dokumentu v kolekci. Zajišťuje, aby se vždy zobrazoval v Power BI.