Azure Cosmos DB sorunlarını giderme

Data API builder'daki yaygın Azure Cosmos DB öykünücüsü, bağlantı ve şema yapılandırma sorunları için çözümler.

Sık sorulan sorular

DAB'de Azure Cosmos DB desteği nedir?

Veri API'si oluşturucusu, NoSQL arka ucu olarak Azure Cosmos DB'i destekler. DAB, Azure Cosmos DB .NET SDK'sını kullanarak Cosmos DB'ye bağlanır ve varlıkları GraphQL türleri olarak kullanıma sunar. Cosmos DB için REST desteği sağlanmaz; tüm sorgular GraphQL uç noktası üzerinden sunulur.

DAB, Cosmos DB ile hangi API'leri kullanır?

DAB, NoSQL için Azure Cosmos DB API'sini (eski adı SQL API'sini) kullanır. MongoDB, Gremlin ve Tablo gibi diğer Cosmos DB API'leri desteklenmez. Cosmos DB hesabınızın NoSQL için Azure Cosmos DB API'siyle oluşturulduğundan emin olun.

Cosmos DB öykünücüsü destekleniyor mu?

Evet. Azure Cosmos DB öykünücüsü yerel geliştirme için desteklenmektedir. Bağlantı dizesini öykünücünün varsayılan uç noktasına ayarlayın: AccountEndpoint=https://localhost:8081/;AccountKey=<emulator-key>;. DAB'in bağlanabilmesi için önce geliştirme makinesinde öykünücünün kendi imzaladığı sertifikasına güvenmelisiniz.

Yaygın sorunlar

Öykünücü sertifikası güvenilir değil

Belirti: DAB bir SSL veya sertifika doğrulama hatasıyla öykünücüye bağlanamıyor.

Neden: Azure Cosmos DB öykünücüsü, işletim sisteminde varsayılan olarak güvenilmeyen otomatik olarak imzalanan bir sertifika kullanır.

Çözüm: Öykünücü sertifikasını https://localhost:8081/_explorer/emulator.pem dışa aktarın ve yerel makinenin güvenilir kök sertifika deposuna yükleyin. Windows'da sertifika dosyasını açın ve Yerel Makine > Güvenilen Kök Sertifika Yetkilileri'ne yükleyin. Sertifikayı yükledikten sonra DAB'yi yeniden başlatın.

Öykünücüye bağlanılamıyor

Belirti: DAB The remote name could not be resolved: 'localhost' ile başlayamaz veya 8081 numaralı bağlantı noktasında bağlantı reddedildi hatası alırsınız.

Neden: Öykünücü çalışmıyor veya bağlantı dizesindeki uç nokta veya hesap anahtarı yanlış.

Çözüm: Azure Cosmos DB emülatörünü Başlat menüsünden veya emülatör yürütülebilir dosyasını çalıştırarak başlatın. Bağlantı dizesinin AccountEndpoint=https://localhost:8081/ kullandığını ve öykünücünün veri gezgini sayfasında https://localhost:8081/_explorer/index.html görüntülenen doğru öykünücü anahtarını kullandığını onaylayın.

GraphQL şema dosyası bulunamadı

Belirti: DAB, Schema file not found veya graphql-schema path is invalid gibi bir hatayla başlamaz.

Neden:graphql.schema içindeki dab-config.json yol, varolmayan veya yanlış göreli yol kullanan bir dosyaya işaret eder.

Çözünürlük: şema dosyasının içinde dab-config.jsonbelirtilen yolda mevcut olduğunu doğrulayın. Yol, yapılandırma dosyası konumuna göredir. dab init ile --cosmosdb_nosql-schema çalıştırarak yapılandırmayı doğru şema yolu ile yeniden oluşturun, ardından .gql veya .graphql dosyasının bu konumda bulunduğunu doğrulayın.

Sorgu boş sonuçlar döndürüyor

Belirti: Kapsayıcıda veriler olsa bile GraphQL sorguları boş bir liste döndürür.

Neden: Varlık yapılandırmasındaki kapsayıcı adı veya bölüm anahtarı yolu gerçek Cosmos DB kapsayıcısı ile eşleşmiyor veya veritabanı adı yanlış.

Çözünürlük: içindeki varlığın source değerini dab-config.json denetleyin ve tam kapsayıcı adıyla (büyük/küçük harfe duyarlı) eşleşip eşleşmediğinden emin olun. database altındaki data-source alanın Cosmos DB veritabanı adıyla eşleşir olduğunu doğrulayın. Azure portalında hesabın Veri Gezgini'ni açın ve veritabanı ve kapsayıcı adlarını onaylayın.

Doğrudan modda TCP bağlantıları Linux öykünücüsü ile başarısız olur.

Belirti: AZURE_COSMOS_EMULATOR_IP_ADDRESS_OVERRIDE=127.0.0.1 kümesiyle bile Docker'daki Cosmos DB Linux öykünücüsüne bağlanırken DAB donuyor veya zaman aşımına uğruyor. İstekler, bağlantı yeniden denemeleri sırasında durur.

Neden: DAB şu anda ConnectionMode.Direct'i sabit kodlar. Bu da Cosmos SDK'sının fiziksel bölüm uç noktalarını (172.17.0.2:1025010255 gibi) bulmasına ve bunlara TCP bağlantılarını açmasına neden olur. Konak makineden bu kapsayıcı adreslerine ulaşılamıyor. Ağ geçidi modu tüm trafiği tek bir HTTPS uç noktası üzerinden (öykünücüde 8081 numaralı bağlantı noktası) yönlendirir ve sorundan tamamen kaçınırdı. Bu, GitHub sorunu #3401'de izlenen bilinen bir sınırlamadır.

Çözüm: Öykünücü kapsayıcısını başlatırken AZURE_COSMOS_EMULATOR_IP_ADDRESS_OVERRIDE=127.0.0.1 olarak ayarlayın. Bu, emülatörü adresi olarak 127.0.0.1'i tanıtmaya zorlayarak, bulunan uç noktaların ana bilgisayardan erişilebilir olmasını sağlar. Ağ geçidi modu DAB'de yapılandırılana kadar IP geçersiz kılma, yerel geliştirme için önerilen geçici çözümdür.

Başkası Adına (OBO) kimlik doğrulaması desteklenmiyor

Belirti/Sempton: Azure Cosmos DB destekli DAB örneği için Adına (OBO) kimlik doğrulamasını yapılandırma başarısız olur veya belirteç beklendiği gibi iletilmez.

Neden: OBO kimlik doğrulaması şu anda yalnızca SQL Server ve Azure SQL için desteklenmektedir. Azure Cosmos DB desteği henüz uygulanmadı. Bu, GitHub sorunu #3159'da izlenen bilinen bir sınırlamadır.

Çözünürlük: Cosmos DB hesap anahtarı veya yönetilen kimlik gibi desteklenen bir kimlik doğrulama yöntemi kullanın. OBO desteği SQL Server dışı veritabanlarına genişletildiğinde yapılan güncelleştirmeler için GitHub sorununu izleyin.

Cosmos DB'de filtredeki GraphQL başarısız oluyor

Belirti: Cosmos DB destekli bir varlığa karşı 'in' operatörünü kullanan bir GraphQL sorgusu, introspection aracılığıyla şemada 'in' görünse bile, çalışma zamanında IN bilinmeyen önermesi oluşturulamıyor hatasıyla başarısız olur.

Neden: in işleci IdFilterInput ve StringFilterInput için oluşturulan GraphQL şemasında kullanıma sunulur, ancak temel cosmos DB filtre çeviri mantığı bunu uygulamaz. Şema ve sorgu yürütücüsü arasındaki bu uyuşmazlık , GitHub sorunu #3061'de izlenen bilinen bir hatadır.

Çözünürlük: Cosmos DB varlıklarına yönelik GraphQL sorgularında in işlecini kullanmaktan kaçının. Bunun yerine şu geçici çözümlerden birini kullanın:

• değerini küçük, sabit bir değer listesi için birden çok veya + q ifadesiyle değiştirin.
• Bilinen bir ID listesiyle sorgulama yaparken birden çok nokta okuma takma adı (item_by_pk) kullanın.
• Daha geniş bir sonuç kümesi aldıktan sonra istemci tarafını filtreleyin.

Cosmos DB için toplamalar desteklenmez

Belirti: Cosmos DB destekli bir varlığa karşı GraphQL toplama sorguları (sayı, toplam veya vg gibi) başarısız olur veya şemada kullanılamaz.

Neden: Veri API'si oluşturucusu şu anda Azure Cosmos DB için toplama işlemlerini desteklememektedir. Toplamalar yalnızca ilişkisel veritabanları için kullanılabilir. Bu, GitHub sorunu #2849'da izlenen bilinen bir sınırlamadır.

Çözüm: Şu anda DAB içinde geçici bir çözüm yoktur. Sonuç kümesini aldıktan sonra toplamaları istemci tarafında gerçekleştirin veya toplama işlemleri için cosmos DB'nin yerleşik sorgu API'sini doğrudan kullanın. Güncelleştirmeler için GitHub sorununu izleyin.

Çoğul (liste) sorguları yalnızca nokta okumalarını zorunlu kılmak için devre dışı bırakılamaz

Belirti: İstemciler, amaç item_by_pk aracılığıyla yalnızca nokta okumalarına izin vermek olduğunda yüksek RU kullanan bir Cosmos DB varlığı üzerinde geniş öğe listesi sorguları verebilir.

Neden: Veri API oluşturucusu şu anda çoğul sorguları gizlemeye ve bir varlığı salt okuma işaret etmek üzere kısıtlamaya yönelik bir yapılandırma seçeneği sağlamaz. Bu, GitHub sorunu #2433'te izlenen bilinen bir sınırlamadır.

Çözünürlük: Kısmi bir geçici çözüm olarak, hangi rollerin liste sorguları oluşturabileceğini sınırlamak için varlığın izinlerindeki liste eylemini kısıtlayın. Çoğul sorgu türünün şemadan tam olarak gizlenmesi henüz desteklenmiyor.

Hiyerarşik bölüm anahtarları (MultiHash) desteklenmez

Belirti: Hiyerarşik bölüm anahtarları (birden fazla bölüm anahtarı yolu) kullanan cosmos DB kapsayıcısına yönelik mutasyonlar, bölüm anahtarı tanımında belirtilen 'tür' değeri 'MultiHash' geçersiz hatasıyla başarısız oluyor. Lütfen 'Hash' bölüm türünü seçin.

Neden: Veri API oluşturucusu yalnızca tek anahtarlı (Karma) bölüm anahtarı tanımlarını destekler. Hiyerarşik bölüm anahtarları (MultiHash) ile yapılandırılan kapsayıcılar desteklenmez. Bu, GitHub sorunu #1733'te izlenen bilinen bir sınırlamadır.

Çözünürlük: ŞU anda DAB içinde geçici bir çözüm yoktur. Mümkünse kapsayıcıyı tek bir bölüm anahtarı kullanacak şekilde yeniden tasarlayın. Veri modeliniz için hiyerarşik bölüm anahtarları gerekiyorsa, çoklu hash desteği eklendiğinde güncellemeler için GitHub konusunu izleyin.

MultiHash bölüm anahtarları desteklenmiyor

Belirti: Hiyerarşik (çoklu karma) bölüm anahtarı kullanan Cosmos DB kapsayıcısına yönelik mutasyonlar, bölüm anahtarı tanımında belirtilen 'kind' değeri 'MultiHash' geçersiz olduğu için başarısız oluyor. Lütfen 'Hash' bölüm türünü seçin.

Neden: Veri API oluşturucusu, Azure Cosmos DB için yalnızca tek değerli Karma bölüm anahtarlarını destekler. Hiyerarşik bölüm anahtarları (MultiHash) ile yapılandırılan kapsayıcılar (örneğin, /TenantId, /EntityType, /EntityId) desteklenmez. Bu, GitHub sorunu #1733'te izlenen bilinen bir sınırlamadır.

Çözüm: Şu anda DAB içinde geçici bir çözüm yoktur. Bunun yerine tek bir Hash bölme anahtarına sahip bir kapsayıcı kullanın. Hiyerarşik bölümleme gerekiyorsa, MultiHash bölüm anahtarı desteği eklendiğinde güncelleştirmeler için kapsayıcıyı yeniden yapılandırmayı veya GitHub sorununu takip etmeyi göz önünde bulundurun.

Cosmos DB'de birden çok mutasyon atomik değildir

Belirti: Cosmos DB varlıklarına karşı tek bir istekte birden çok GraphQL mutasyonu gönderildiğinde, bir mutasyondaki bir hata diğerlerini geri almaz. Kısmi yazma işlemleri gerçekleşebilir.

Neden: Veri API'si oluşturucusu birden çok Cosmos DB mutasyonunu işlemsel bir toplu iş içinde sarmalamaz. bir istekteki birden çok mutasyonların atomik olarak yürütüldüğü ilişkisel veritabanlarının aksine Cosmos DB mutasyonları bağımsız olarak verilir. Bu, GitHub sorunu #1621'de izlenen bilinen bir sınırlamadır.

Çözünürlük: Uygulamanızı her Cosmos DB mutasyona bağımsız olarak davranacak şekilde tasarlar. Bölünmezlik gerekiyorsa, aynı mantıksal bölüm içindeki öğelere odaklanan işlemsel toplu işleme desteğiyle Cosmos DB SDK'sını doğrudan kullanın. Cosmos DB için işlemsel mutasyon desteği eklendiğinde güncelleştirmeler için GitHub sorununu izleyin.

Şema dosyasındaki GraphQL tür adı varlık yapılandırmasıyla eşleşmiyor

Belirti: DAB hatasız başlar, ancak schema.gql dosyasında tanımlanan GraphQL tür adı dab-config.jsonvarlığı için yapılandırılan tekil tür adıyla eşleşmediğinden sorgular beklenmeyen sonuçlar veya yanlış tür döndürür.

Neden: Veri API'si oluşturucusu şu anda şema dosyasındaki GraphQL tür adının varlık için bildirilen tekil tür adıyla eşleşdiğini doğrulamaz. Uyuşmazlık belirsiz bir şekilde tutarsız bir şema oluşturur. Bu, GitHub sorunu #1556'da izlenen bilinen bir sınırlamadır.

Çözüm: schema.gql dosyasındaki tür adının (@model yönergesiyle ayarlanır) varlığın dab-config.json içindeki graphql.type yapılandırmasındaki tekil değerle eşleştiğini manuel olarak doğrulayın. Örneğin, dab-config.json "tekil": "Konum" bildiriminde bulunursa, şema dosyası ype Konumu @model(name:"Konum") içermelidir.

Şema dosyasındaki GraphQL tür adı varlığın tekil tür adıyla eşleşmiyor

Belirti: DAB hatasız başlar, ancak schema.gql dosyasında tanımlanan GraphQL tür adı dab-config.jsonvarlığı için yapılandırılan tekil tür adıyla eşleşmediğinden sorgular beklenmeyen sonuçlar veya yanlış tür döndürür.

Neden: Veri API oluşturucusu şu anda GraphQL şema dosyasındaki yönerge adının varlık için ayarlanan tekil tür adıyla eşleşdiğini @model doğrulamaz. Bunlar farklı olduğunda, uyuşmazlık sessizce yanlış şema davranışı üretir. Bu, GitHub sorunu #1556'da izlenen bilinen bir sınırlamadır.

Çözünürlük: schema.gql dosyasındaki tür adının dab-config.jsonvarlığın graphql.type yapılandırmasındaki tekil değerle tam olarak eşleştiğinden emin olun. Örneğin, varlık "tekil" tanımlarsa: "Konum", şema dosyası ype Konum @model(name:"Konum") bildirmelidir. Diğer yapılandırma hatalarını yakalamak için değişiklik yaptıktan sonra dab validate komutunu çalıştırın.

GraphQL şema dosyasındaki numaralandırma türleri şema derleme hatasına neden oluyor

Belirti: DAB, HotChocolate.SchemaException ile başlayamıyor: Tür başvurusu çözümlenemiyor ... Cosmos DB schema.gql dosyası nesne türü alanında kullanılan bir GraphQL sayı türünü tanımladığında OrderByInput hatası.

Neden: Veri API oluşturucusu şu anda Cosmos DB şema dosyasında GraphQL sabit listesi türlerini desteklememektedir. Enum bir alan türü olarak kullanıldığında, şema oluşturucusu karşılık gelen OrderByInput türünü oluşturamaz ve işlenemeyen bir özel durum fırlatır. Bu, GitHub sorunu #748'de izlenen bilinen bir sınırlamadır.

Çözüm: enum alanlarını schema.gql dosyasındaki skaler eşdeğerleriyle değiştirin (örneğin, özel enum türü yerine Dize kullanın). DAB şema tanımı yerine uygulama katmanınızda enum doğrulaması uygulayın.

GraphQL şemasındaki numaralandırma türleri BAŞLANGıÇTA DAB'nin başarısız olmasına neden oluyor

Belirti: Cosmos DB GraphQL şema dosyası bir modelde kullanılan bir sabit listesi türünü tanımladığında DAB, 'None: FooOrderByInput' tür başvurusu çözümlenemiyor gibi bir HotChocolate.SchemaException hatasıyla başlayamaz.

Neden: Veri API'si oluşturucusunda şema oluşturucusu schema.gql dosyasında tanımlanan GraphQL sabit listesi türlerini doğru şekilde işlemez. Bir numaraya modelde alan türü olarak başvurulduğunda, iç OrderByInput türü oluşturma işlemi şema başlatmayı kilitleyerek sorunu çözemiyor. Bu, GitHub sorunu #748'de izlenen bilinen bir sınırlamadır.

Çözünürlük: Cosmos DB varlıkları için schema.gql dosyasında GraphQL sabit listesi türlerini tanımlamaktan kaçının. Geçici bir çözüm olarak, numaralandırma alanlarını Dize ile değiştirin ve uygulama katmanında geçerli değerleri sağladığınızdan emin olun. Enum desteği eklendiğinde güncellemeleri almak için GitHub konusunu takip edin.

Cosmos DB varlıkları için alan eşlemeleri (takma adlar) desteklenmez

Belirti: dab-config.json'da bir Cosmos DB varlığı için tanımlanan eşlemeler bölümü, yapılandırılmış diğer adlar yerine hala özgün alan adlarının GraphQL şemasında görüntülenmesine neden olur.

Neden: Veritabanı sütun adlarını API'de farklı alan adları altında kullanıma sunan eşlemeler özelliği yalnızca ilişkisel veritabanları için uygulanır. Cosmos DB varlıkları şu anda alan eşlemelerini desteklememektedir. Bu, GitHub sorunu #1512'de izlenen bilinen bir sınırlamadır.

Çözünürlük: Alan adlarını Cosmos DB belgelerinde göründükleri gibi kullanın. Diğer ad gerekiyorsa, istemci uygulama katmanında uygulayın. Cosmos DB için eşleme desteği eklendiğinde güncelleştirmeler için GitHub sorununu izleyin.

GraphQL mutasyon değişkenleri, değerler yerine depolanan değişken adları çözümlenmez

Belirti: Değişkenleri kullanan bir GraphQL mutasyonu (örneğin createExample(item: { id: , name: })) değişken adlarını ariables yükünde geçirilen gerçek değerler yerine veritabanında depolar.

Neden: Veri API oluşturucusu şu anda Cosmos DB için mutasyon girişlerindeki GraphQL değişken başvurularını çözümlememektedir. Değişken değiştirme atlanır ve değişmez değişken adı alan değeri olarak yazılır. Bu, GitHub sorunu #1482'de izlenen bilinen bir hatadır.

Çözünürlük: GraphQL değişkenlerini kullanmak yerine değişken değerlerini doğrudan mutasyon gövdesinde satır içi yapın. Örneğin, id: değerini id: "1234" ile değiştirin. Bu, üretim kullanımı için ideal değildir, bu nedenle Cosmos DB mutasyonları için değişken işlemenin ne zaman düzeltilmesiyle ilgili güncelleştirmeler için GitHub sorununu izleyin.

GraphQL şema dosyasındaki birleşim türleri 500 hatasına neden oluyor

Belirti: SCHEMA.gql bir GraphQL birleşim türü tanımladığında DAB, tüm GraphQL isteklerinde 500 durum kodu döndürür. Başlatma kayıtları, HotChocolate.SchemaException: Tür başvurusu çözümlenemedi ... OrderByInput.

Neden: Veri API'si oluşturucusu, Cosmos DB şema dosyasındaki GraphQL birleşim türlerini desteklemez. Numaralandırma türleri gibi birleşim türleri de sıralama/filtre giriş türleri oluşturulurken şema oluşturucusunun başarısız olmasına neden olur. Bu, GitHub sorunu #1384'te izlenen bilinen bir hatadır.

Çözünürlük: schema.gql'den birleşim türü tanımlarını kaldırın. İsteğe bağlı alanlara sahip tek bir nesne türü kullanarak çok biçimli verileri modelleyin veya verileri ayrı varlıklara bölün. Birleşim türü desteği eklendiğinde güncelleştirmeler için GitHub sorununu izleyin.

Şemada id null olabilir olarak tanımlandığında mutasyon yaratma çalışma zamanında başarısız oluyor.

Belirti: Şema geçerli görünse bile, oluşturma mutasyonu bir çalışma zamanı hatası döndürür. Kimlik alanı sağlanmadığından veya null olduğundan hata oluşur.

Neden: Cosmos DB, her belge için kimlik alanını gerektirir ve bölüm anahtarının bir parçası olarak kullanır. schema.gql id'yi null olabilir olarak bildirirse (örneğin, id: ID! yerine id: ID), DAB şemayı kabul eder ancak oluşturma mutasyonu alanı yoksa çalışma zamanında başarısız olur. Şemanın doğrulama sırasında null olamaz kısıtlamasını uygulaması gerekir, ancak şu anda bu kısıtlamayı uygulamamaktadır. Bu boşluk GitHub sorunu #1238'de izlenir.

Çözünürlük: Cosmos DB GraphQL şemanızda kimlik alanını her zaman null olmayan olarak bildirin:

graphql type MyEntity @model(name: "MyEntity") { id: ID! ... }

Kimliğin Doğrulanması: Kimlik! kimlik atlanırsa, istemcilerin belirsiz çalışma zamanı hatası yerine net bir şema düzeyi hatası almasına neden olur.

Döngüsel GraphQL ilişkileri başlangıçta yığın taşması hatasına neden olur

Belirti: Schema.gql bir döngüde birbirine başvuran türleri tanımladığında (örneğin, Oyuncu Oyun'a, Oyun oyuncuya başvurduğunda) DAB başlangıçta çalıştırıldığında yığın taşması hatasıyla kilitleniyor.

Neden: Şema oluşturucusu, mutasyon giriş türleri oluşturmak için tüm tür başvurularını özyinelemeli olarak dolaşır. Döngüsel ilişkiler, çağrı yığınını tüketerek sonsuz özyinelemelere neden olur. Bu, GitHub sorunu #746'da izlenen bilinen bir hatadır.

Çözünürlük: schema.gql dosyasında döngüsel tür başvurularından kaçının. Türlerden birinden geri başvuruyu kaldırarak döngüyü bölün veya ilişkiyi iç içe nesne türleri yerine kimlik listesi (skaler alanlar) olarak modelleyin. Döngüsel ilişkilerin ne zaman desteklendiğine ilişkin güncelleştirmeler için GitHub sorununu izleyin.

Bölüm anahtarı daima kimlik olarak belirlenmiştir, özel bölüm anahtar yolları desteklenmemektedir.

Belirti: DAB yalnızca bölüm anahtarı olarak /id kullanan Cosmos DB kapsayıcılarıyla çalışır. Başka bir alan (örneğin, /userId veya /category) tarafından bölümlenmiş kapsayıcılar doğru şekilde sorgulanamaz veya değiştirilemez.

Neden: Data API oluşturucusu, "id"yi tüm Cosmos DB varlıkları için bölüm anahtarı olarak sabit kodlar. dab-config.json veya schema.gql içinde özel bölüm anahtarı yolu belirtmenin bir yolu yoktur. Bu, GitHub sorunu #747'de izlenen bilinen bir sınırlamadır.

Çözünürlük: DAB kullanırken bölüm anahtarı olarak /id ile yeni kapsayıcılar tasarla. Farklı bir bölüm anahtarına sahip mevcut kapsayıcılar için DAB şu anda desteklenmiyor. Yapılandırılabilir bölüm anahtarları eklendiğinde güncelleştirmeler için GitHub sorununu izleyin.

Belge içinde iç içe dizileri sorgulama (öğe içi birleşimler) desteklenmez

Belirti: DAB kullanarak Cosmos DB belgesinde iç içe dizi özelliklerini filtreleyemez veya çapraz geçiş yapamazsınız. Dizi öğeleri arasında Cosmos DB JOIN gerektiren sorgular hiçbir sonuç veya hata döndürmez.

Neden: Veri API oluşturucusu, tek bir belge içinde iç içe dizileri sorgulamak için gereken Cosmos DB belge içi birleştirmeleri (öğe içi birleşimler olarak da adlandırılır) desteklemez. Bu, GitHub sorunu #262'de izlenen bilinen bir sınırlamadır.

Çözünürlük: İçeriklerine göre filtreleme yapmanız gerekiyorsa, iç içe dizileri ayrı varlıklara veya alt dökümanlara düzleştirin. Alternatif olarak, uygulama katmanınızdaki belgenin tamamının son işlemesini gerçekleştirebilirsiniz. Belge içi birleştirme desteği ne zaman eklenecek, güncellemeleri görmek için GitHub sorunu izleyin.