MongoDB için Azure Cosmos DB sanal çekirdeği

Özet

Ürün	Açıklama
Sürüm durumu	Beta sürümü
Desteklenen ürünler	Power BI (Anlam modelleri) Power BI (Veri Akışları) Fabric (2. Nesil Veri Akışı)
Desteklenen kimlik doğrulama türleri	Tüm Power BI Desktop, ağ geçidi ile Power Query Online ve Power Query Online için temel (kullanıcı adı / parola)
İşlev Başvurusu Belgeleri	Doğrudan Sorgu İşlevi Desteği Power Query M işlev başvurusu

Önkoşullar

Desteklenen özellikler

• İçe Aktarım Modu
• Doğrudan Sorgu Modu (Power BI anlam modelleri)
  • Desteklenen Power Query İşlevleri
• Native Mongo Sorguları

Power Query Desktop'tan MongoDB için Azure Cosmos DB sanal çekirdek veritabanına bağlanma

Power Query Desktop'tan MongoDB için Azure Cosmos DB sanal çekirdeğine bağlanmak için aşağıdaki adımları izleyin:

1. Veri Al deneyiminde MongoDB sanal çekirdeği için Azure Cosmos DB'yi seçin. Power Query Desktop'taki Veri Al deneyimi uygulamalar arasında farklılık gösterir. Uygulamanız için Power Query Desktop Veri Al deneyimi hakkında daha fazla bilgi için Veri alma yeri'ne gidin.

2. MongoDB için Azure Cosmos DB sanal çekirdeğinde Cosmos DB uç noktasını sağlayın. İsteğe bağlı olarak bir Veritabanı Adı ve Koleksiyon Adı sağlayın. Bir veritabanı adı sağlanmazsa, gelecek Gezgin ekranında tüm veritabanları ve onların kendi koleksiyonları gösterilir. Hem veritabanı hem de koleksiyon adlarının belirtilmesi yalnızca bu koleksiyonu gösterir. Veritabanı adı olmadan bir koleksiyon adı belirtilmesi bağlantı hatasıyla sonuçlanır.

   .

3. İçeri aktar veya DirectQuery veri bağlantısı modunu seçin.

4. Tamam'ı seçin.

5. Bu veritabanına ilk kez bağlanıyorsanız Bağlan'ı seçmeden önce kullanıcı adınızı ve parolanızı girin.

   

6. Gezgin'de, istediğiniz veritabanı bilgilerini seçin. Her veritabanının altında bir koleksiyon listesi görüntülenir. Bir veya daha fazla koleksiyon seçin ve ardından Verileri yüklemek için Yükle'yi veya Power Query Düzenleyicisi'nde verileri dönüştürmeye devam etmek için Verileri Dönüştür'ü seçin. veritabanı ve koleksiyon listesi, isteğe bağlı Veritabanı Adı ve Koleksiyon Adı daha önce sağlandıysa etkilenir.

   

Power Query Online'dan MongoDB için Azure Cosmos DB sanal çekirdek veritabanına bağlanma

Power Query Online'dan MongoDB için Azure Cosmos DB sanal çekirdek veritabanına bağlanmak için:

1. Veri alma deneyiminde MongoDB için Azure Cosmos DB sanal çekirdek seçeneğini belirleyin. Farklı uygulamaların Power Query Online veri alma deneyimine ulaşmak için farklı yolları vardır. Power Query Online'a uygulamanızdan veri alma deneyimine nasıl ulaşabileceğiniz hakkında daha fazla bilgi için Verinereden edinileceği bölümüne gidin.

   

2. Görünen Azure Cosmos DB for MongoDB vCore iletişim kutusunda Cosmos DB uç noktasını girin. İsteğe bağlı olarak bir Veritabanı Adı ve Koleksiyon Adı sağlayın. Bir veritabanı adı sağlanmazsa, Gezgin ekranında tüm veritabanları ve bunlara ait koleksiyonlar gösterilir. Hem veritabanı hem de koleksiyon adlarının belirtilmesi yalnızca bu koleksiyonu gösterir. Veritabanı adı olmadan bir koleksiyon adı belirtilmesi bağlantı hatasıyla sonuçlanır.

   

3. Mevcut bir bağlantıyı veya veri ağ geçidini seçebilirsiniz. Bağlantı kimlik bilgileri bölümünde uç noktayla ilişkili kullanıcı adını ve parolayı belirten temel kimlik doğrulama türünü belirterek bağlanabilirsiniz ve İleri'yi seçin.

4. İçeri aktarmak ve kullanmak için bir veya birden çok tablo seçin ve ardından Power Query düzenleyicisinde verileri dönüştürmek için Verileri Dönüştür'ü seçin.

Yerel Mongo Sorguları

Özel Value.NativeQuery işlev, yerel MongoDB sorgularının veri kaynağına gönderilmesini sağlar. Aşağıdaki örnekte, verileri ilk yüklerken tablo oluşturmak için işlevinin nasıl kullanılacağı gösterilmektedir. Ancak bu işlev, Verileri Dönüştür seçeneğinin kullanılabilir olduğu herhangi bir zamanda çağrılabilir.

Yerel Mongo Sorguları yalnızca Doğrudan Sorgu modunda desteklenir.

1. Gezgin'i kullanarak en az bir koleksiyon seçin ve Verileri Dönüştür'ü seçin.

   

2. Gelişmiş Düzenleyici'yi seçin. Gelişmiş Düzenleyici iletişim kutusu, seçilen koleksiyondaki tüm verileri getirmek için kullanılacak ilk sorguyu gösterir.

   

3. Value.NativeQuery işlevi iki bağımsız değişken alır: Kaynak ve sorgunun kendisi. Source değişkeni veritabanına bağlanmak için gereken tüm bilgilerle doldurulur. İsterseniz, sorgunun çalıştığı koleksiyonun adını güncelleştirin. Koleksiyonun Gezgin'de seçilen koleksiyonla aynı olması gerekmez.

   

4. İkinci bağımsız değişken, çift tırnak içinde yer alan geçerli bir MongoDB sorgusudur. Sorgudaki tırnak işaretleri başka bir tırnak işaretiyle kaçırılır. Örneğin, ""num1"""$num1""" şeklinde.

5. Verileri dönüştürmek için Bitti'yi seçin.

6. Sorgu yürütüldükten sonra Cosmos DB'den şema bilgisi döndürülmedikçe, sonuç tablosu tüm sütun türlerini herhangi bir şekilde tanımlar. Veri Türünü Algıla seçeneğini kullanarak sütunları dönüştürün veya ilgilendiğiniz sütunların veri türünü el ile değiştirin. İsterseniz sonuç tablosunun adını güncelleştirin.

   

7. Power Query Düzenleyicisi kapatılıp değişiklikler uygulandıktan sonra, sonuç tablosu Veri bölmesinde görünür.

   

İşlevin sınırlamaları için Sorun Giderme ve Sınırlamalar bölümüne Value.NativeQuery bakın.

Doğrudan Sorgu Desteği

Direct Query aşağıdaki Power Query işlevlerini destekler:

• Date.From, DateTime.From, DateTimeZone.From, , Date.Day, Date.DayOfWeek, Date.DayOfYear, Date.Month, Date.WeekOfYear, Date.Year
• List.Average, List.Contains, List.First, , List.Last, List.Max, List.Min, List.Sum
• Int64.From, Currency.From, Percentage.From, , Text.From, Logical.From, Logical.FromText, Logical.ToText
• Number.Abs, Number.Mod, Number.Round, , Number.RoundAwayFromZero, Number.RoundDown, Number.RoundTowardZero, Number.RoundUp
• Table.RowCount
• Time.Hour, Time.Minute, Time.Second
• Value.Add, Value.Divide, Value.Equals, , Value.Multiply, Value.NullableEquals, Value.Subtract

Sorun Giderme ve Sınırlamalar

• Power Query Metin işlevleri henüz desteklenmediği için, Doğrudan Sorgu modunda Verileri dönüştürürken sütunda Metin Filtreleri de kullanılamaz.

  • Bu tür filtrelere örnekler: Şununla Başlar, İle Biter, İçerir vb.
  • Desteklenmeyen İşlem: Desteklenmeyen işlev çağrısına benzer bir hata iletisi görüntülenir: 'Text.StartsWith'

• Direct Query kullanılırken tüm Power Query işlevleri desteklenmediğinden, İçeri Aktarma Moduna geçin veya bir veya daha fazla eksik Power Query işlevinin amacını yerine getiren bir Yerel Mongo Sorgusu oluşturun.

• Yerel Mongo Sorguları kullanılırken şema bilgisi döndürülmüyor. Tüm sütunlar dikkate alınır any ve el ile istenen veri türüne dönüştürülmesi gerekir.

• Özel Value.NativeQuery işlev, sonuç tablosunu oluşturmak için sorgudan döndürülen yalnızca ilk belgeyi örnekler. Bunun sonucu, sonraki belgelerde daha fazla alan varsa, bu alanların sonuç tablosuna dahil olmamasıdır. Belirli sütunları yansıt veya belirli bir telafi görünümünü sorgula.

• Özel Value.NativeQuery işlev yalnızca Direct Query ile kullanılabilir, İçeri Aktarma Modu ile kullanılamaz.

• Power BI, yerleşik filtre uygularken tarih türlerinden milisaniyeleri kaldırır. Bu nedenle, bir tarih türünün içinde milisaniye varsa, bu yerleşik filtreler çalışmaz.

• 1899, 30 Aralık'tan önceki tarihler için Date.From, DateTime.From ve DateTimeZone.From negatif OLE süreleri çalışmaz.

• Power BI DateTimeZone.From işlevini kullanmak, işlevi MongoDB için Cosmos DB'ye eklenmediğinden, Cosmos DB sunucusundan (400): Kötü İstek hatası almanıza neden olur.

• Özel karakterler içeren alan adları desteklenmez (örneğin, $, ., @vb.).

• Direct Query kullanılarak 0'a bölündüğünde sorgu başarısız olur. Her zamanki #infinity Power BI sonucundan farklıdır, ancak MongoDB davranışıyla uyumlu olur.

• Aşağıdaki veri türleri şu anda dize olarak kabul edilir. Bu nedenle, bu veri türleriyle değerlerin kullanılması Direct Query'de filtreleme için kullanılamaz çünkü aşağı gönderme başarısız olur:

  • decimal128
  • regularExpression
  • Tarih damgası

• Power BI'da kullanmak istediğiniz herhangi bir alan için öneri, alanın koleksiyonunuzdaki her belgede yer almaktır. Her zaman Power BI'da gösterildiğini güvence altına alır.