Aracılığıyla paylaş


MongoDB (Önizleme)

MongoDB, geliştiriciler tarafından sevilen ve çeşitli iş yüklerini çalıştırmak için kuruluşlar arasında kullanılan genel amaçlı, dağıtılmış bir belge veri platformudur. Artık MongoDB Bağlayıcısı'nı kullanarak çeşitli uç noktaları keşfedebilir ve koleksiyonunuz üzerinde CRUD işlemleri ve toplamaları gerçekleştirebilirsiniz.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet Class Bölgeler
Copilot Studio Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Logic Apps Standart Aşağıdakiler dışında tüm Logic Apps bölgeleri :
     - Azure Kamu bölgeleri
     - Azure Çin bölgeleri
     - ABD Savunma Bakanlığı (DoD)
Power Apps - Mevcut değil
Power Automate Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
İletişim
İsim MongoDB Desteği
URL https://www.mongodb.com/community/forums/
E-posta support-operations@mongodb.com
Bağlayıcı Meta Verileri
Publisher MongoDB Corp
Web sitesi https://www.mongodb.com
Gizlilik ilkesi https://www.mongodb.com/legal/privacy-policy
Kategoriler Data

MongoDB Bağlayıcısı, MongoDB Atlas koleksiyonlarına veri okumak ve yazmak için kiracınızdaki Azure işlevi kullanılarak barındırılan Veri API'leri aracılığıyla MongoDB Atlas'a bağlanmak için basit bir yol sağlar. MongoDB bağlayıcısı, verileriniz üzerinde CRUD işlemlerini ve toplamalarını dakikalar içinde gerçekleştirmenizi kolaylaştırır ve Power Apps, Power Automate ve Logic Apps'te zengin uygulamalar ve iş akışları oluşturmak için MongoDB'yi sorgulamanıza olanak tanır.

*** MongoDB'nin Atlas Veri API'lerini Eylül 2025'ten itibaren kullanımdan kaldırdığını ve bu nedenle bu bağlayıcı yaklaşımını kullanarak Uygulamalarınızda ve Akışlarınızda Atlas'ınkiler yerine bir Azure işlevi ayarlayıp url ve API anahtarlarını kullandığını lütfen unutmayın. ***

Önkoşullar

  1. Atlas Ortamını Yapılandırma

Buradan yeni bir Atlas Hesabına kaydolun. Atlas ortamını ayarlamak için 1 ile 4 (Atlas hesabı oluşturma, Ücretsiz küme dağıtma, IP erişim listesine IP'nizi ekleme ve Veritabanı kullanıcısı oluşturma) adımlarını izleyin.

  1. Azure İşlevini Atlas Veri API'si olarak ayarlama Kodu Atlas Veri API'leri işlevi görecek şekilde barındıracak Azure işlevini ayarlamak için iki seçeneğimiz vardır: 1. GitHub Actions VEYA 2 kullanma. Zip Dağıtımı Kullanma

    Geçerli deponun çatalını oluşturabiliyorsanız GitHub eylemleri yöntemini seçin; bu depoda GitHub eylemlerini etkinleştirebilir ve daha fazla API eklemek ve kutudan ci/CD veya DevOps'un ayarlanmasını tercih edebilirsiniz. Bununla birlikte, hızlı ve kolay bir dağıtım yolu arıyorsanız ve Yalnızca Atlas Veri API'lerini değiştirmek için Azure işlevinin ayarlanması gerekiyorsa Zip dağıtımı seçeneğiyle gidin.

    1. Seçenek: GitHub eylemlerini kullanarak Azure işlevini ayarlama

    a.MongoDB deposu çatalı. Yeni çatallanmış depo url'sini not edin. GitHub eylemleri varsayılan olarak ETKINLEŞTIRILMEZse, çatallanmış deponuzda Ayarlar - Eylemler ->> Genel'e gidip Eylemlere/ yeniden kullanılabilir iş akışlarına izin ver seçeneklerinden birini belirleyerek bunları etkinleştirin.

    b.Azure işlevinin kiracınızda oluşturulması için aşağıdaki Azure'a dağıt düğmesine tıklayın.

    Azure’a dağıtın

    c. Azure işlevini ve ilişkili bileşenlerini (App Service Planı, Depolama Hesabı ve App Insights) içerecek Kaynak grubunuzu seçin veya oluşturun. İşlev adını ve SKU'yu varsayılan olarak tutabilir veya bazı belirli standartları izlemek isterseniz değiştirebilirsiniz. Benzersiz ve kolayca tanımlanabilmesi için işlev uygulaması adına Küme adınızı eklemenizi öneririz.

    Bu Azure işlevinin çalıştırılacağı Küme için MongoDB bağlantı url'sini verin. Bu bağlantı dizesi bir Environmnet değişkeni olarak kaydedilir. Çatallanmış depo url'nizi GitHub deposu olarak verin. Oluştur'u seçtiğinizde ilişkili kaynaklarla Azure işlevi oluşturulur. Bu aşamada işlev uygulamasının oluşturulduğuna, env değişkenlerinin doldurulduğunu ancak gerçek işlevin henüz işlev uygulamasına dağıtılmadığını unutmayın.

    d. GitHub eylemlerinin deponuzdan çalıştırılmasını ve işlevin dağıtılması için, oluşturduğunuz Azure işlevinden yayımlama profilini alın.

    İndirilir, metin düzenleyicisinde açılır ve tüm içeriği kopyalanır.

    GetPublishProfile.png

    e. GitHub deponuza gidin -> Ayarlar -> Gizli diziler ve değişkenler -> Eylemler Yeni Depo gizli dizisi'ne tıklayın ve yayımlama profilinizdeki değerin tamamını "AZUREAPPSERVICE_PUBLISHPROFILE" adlı yeni bir gizli diziye kopyalayın

    f. Python kodunu Azure işlevine işlev uygulamanıza dağıtacak GitHub eylemlerini çağırmak için BENİOKU ve Değişiklikleri İşleme'de küçük bir değişiklik yapın. Şimdi Functon Uygulamasında kullanılabilen işlevi ve dağıtılan function_app.py kodunu görmeniz gerekir.

    g. GitHub deposundaki GitHub eylemleri sekmesi dağıtımdaki adımları (bağımlılıkların yüklenmesi dahil) ve her adımın sonucunu gösterir.

    2. Seçenek: ZipDeploy Kullanarak Azure işlevini ayarlama

    a. Azure işlevinin kiracınızda oluşturulması için aşağıdaki Azure'a dağıt düğmesine tıklayın.

    Azure’a dağıtın

    b. Azure işlevini ve ilişkili bileşenlerini (App Service Planı, Depolama Hesabı ve App Insights) içerecek Kaynak grubunuzu seçin veya oluşturun. İşlev adını ve SKU'yu varsayılan olarak tutabilir veya bazı belirli standartları izlemek isterseniz değiştirebilirsiniz. Benzersiz ve kolayca tanımlanabilmesi için işlev uygulaması adına Küme adınızı eklemenizi tavsiye ettik.

    Dağıtılması gereken zip'e sahip Depolama hesabının SAS url'si olduğundan lütfen ** DONOT değiştirin ** packageUrl. Oluştur'u seçtiğinizde Azure işlev uygulaması oluşturulur ve ilişkili kaynaklarla birlikte azure işlevi dağıtılır.

Kimlik bilgilerini alma

BaseUrl ve API Anahtarını alma

a. İşlev Uygulaması'ndan işlevinizi seçin ve İşlev URL'sini al 'a tıklayın. İşlev URL'sini, aşağıdaki ekran görüntüsünde gösterildiği gibi baştan "/action" öncesine kadar kopyalayın. Bu, MongoDB CRUD/ Toplama API'lerinden herhangi birini çağırmak için kullanacağınız Temel Url'dir .

GetFunctionUrl.png

b. İşlev Uygulamanıza gidin -> İşlevler -> Uygulama anahtarları altında, Azure işlevinizin _master veya varsayılan API anahtarını alın Bu, MongoDB CRUD/ Toplama API'lerinden herhangi birini çağırmak üzere bir MongoDB bağlantısı oluşturmak için Temel Url ile birlikte kullanacağınız API Anahtarıdır.

Bağlayıcınızı kullanmaya başlama

  1. Önkoşullar tamamlandıktan sonra PowerAutomate -> Bağlantılar'a gidin. "Yeni Bağlantı"ya tıklayın ve ekran görüntüsünde gösterildiği gibi sağ üstteki Arama Çubuğu'nda MongoDB'yi arayın.

MongoDBPremiumConnector.png

  1. MongoDB bağlantısına tıkladığınızda AŞAĞıDAKI açılan pencerede API anahtarını ve Temel URL'yi girmenizi istersiniz.

MongoDBConnection.png

  1. "Temel Url" ve "API Anahtarı" alanları için yukarıdaki Kimlik bilgilerini alma bölümünden alınan değerleri girin

MongoDB Atlas Kümenize yönelik tüm CRUD işlemleri için 8 Veri API'lerinden birini kullanın. Karmaşık sorgularda, bir aşamadan diğerine çıkışa masaj yapmak üzere toplama aşamalarını kullanmak için "Toplama İşlem Hattı Çalıştır" API'sini kullanın. MongoDB'nin esnekliği ve dinamizmi sayesinde zengin uygulamalar oluşturabilir ve zaman alan süreçleri otomatikleştirebilirsiniz. Aynı koleksiyona daha fazla özellik ve alan ekleyerek uygulamaları geliştirmeye devam edebilirsiniz.

Bilinen sorunlar ve sınırlamalar

MongoDB bir şemayı zorlamadığından, geçerli bağlayıcı yalnızca Api yanıtı için dinamik şemayı destekleyen Power Automate ve Logic Apps ile kullanılabilir ve daha sonra "JSON Ayrıştır" yapıları kullanılarak ayrıştırılabilir. Her MongoDB etkileşimi için bir Power Automate akışı çağırarak Power Apps'te kullanılabilir. Ayrıca, Yanıt şemasını MongoDB koleksiyon şemanıza göre özelleştirmek üzere doğrudan Power Apps'te kullanmak için Microsoft Github deposundaki sertifikalı MongoDB bağlayıcısını Özel bağlayıcı olarak kullanmaya devam edebilirsiniz.

MongoDB Veri işlemleri için geçerli olan kısıtlamalar MongoDB bağlayıcısı için de geçerlidir. Veri API'lerinin Kullanıcı bağlamı altında desteklenmeyen toplama aşamaları hakkında daha fazla bilgi edinmek için lütfen bu bağlantıya bakın.

Zaman aşımları ve her kaynak planı için diğer hizmet sınırları gibi Azure işlevleriyle ilgili bilinen sınırlamalar için lütfen bu bağlantıyı izleyin.

Yaygın hatalar ve çözümler

Tipik API yanıt kodları burada da geçerlidir. 4XX hataları istemciden gelen istekle ilgili bir sorun olduğunu gösterir. dataSource, veritabanı, koleksiyonun geçerli bir JSON biçiminde sağlandığından emin olun. Örnekler için bu Postman Koleksiyonuna bakın. 5XX hataları için Azure işlevinin çalışır durumda olduğundan emin olun ve daha fazla araştırma yapmak için izlemesini denetleyin.

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:

Varsayılan Bağlantı oluşturmak için parametreler. Tüm bölgeler Paylaşılamaz

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim Türü Description Gerekli
API Anahtarı securestring Bu API için API Anahtarı Doğru
BaseUrl String Azure İşlevi URL'si (Örnek:https://mdb-dataapi-repl.azurewebsites.net/api/mdb_dataapi) Doğru

Azaltma Sınırları

Name Çağrılar Yenileme Dönemi
Bağlantı başına API çağrıları 100 60 saniye

Eylemler

Belge Bul

findOne uç noktasını kullanmak, bir koleksiyondan tek bir belge almanıza olanak sağlar. Arama ölçütlerini belirtmek için istek gövdesindeki filter özelliğini kullanın. Ölçütle eşleşen birden fazla belge varsa, yalnızca ilk eşleşme döndürülür.

Belge Ekle

insertOne uç noktasını kullanarak koleksiyona belge ekleyebilirsiniz. Oluşturulacak belgeyi belirtmek için istek gövdesindeki belge özelliğini kullanın.

Belgeyi Güncelleştir

Tek bir kaydı güncelleştirmek için updateOne uç noktasını kullanabilirsiniz. Arama ölçütlerini belirtmek için istek gövdesindeki filter özelliğini kullanın. Ölçütle eşleşen birden fazla belge varsa, yalnızca ilk eşleşme döndürülür. Ardından güncelleştirilmesi gerekenleri belirtmek için güncelleştirme alanını kullanın. Belgelerinizi güncelleştirmek için güncelleştirme işleçlerinden birini kullanmanız gerekir.

Belgeyi Sil

Tek bir belgeyi silmek için deleteOne uç noktasını kullanın. Arama ölçütlerini belirtmek için istek gövdesindeki filter özelliğini kullanın. Ölçütle eşleşen birden fazla belge varsa, yalnızca ilk eşleşme silinir.

Birden Çok Belge Bul

Bulma uç noktasını kullanarak aynı anda birden çok belge getirebilirsiniz. Filtreleme ölçütü belirtmek için isteğin gövdesindeki filter özelliğini kullanın. Boş bir nesne geçirirseniz koleksiyondaki tüm belgeler döndürülür.

Birden Çok Belge Ekle

insertMany uç noktasını kullanarak aynı anda birden fazla belge ekleyebilirsiniz. Bu durumda, koleksiyona eklemek istediğiniz belge dizisini belirtmek için isteğin gövdesindeki documents özelliğini kullanmanız gerekir.

Birden Çok Belgeyi Güncelleştirme

updateMany kullanarak, isteğin gövdesinde belirtilen belirli bir filtreyle eşleşen tüm belgeleri güncelleştirebilirsiniz. Belgelerinizi güncelleştirmek için güncelleştirme alanındaki güncelleştirme işleçlerinden birini kullanın.

Birçok Belgeyi Sil

Aynı anda birden çok belgeyi silmek için deleteMany kullanabilirsiniz. Hangi belgelerin silineceğini belirtmek için filter özelliğini kullanın. Bu API'yi filtre olmadan kullanmanın koleksiyondaki tüm belgeleri sileceğine dikkat edin. Deletemany'i dikkatli kullanın.

Toplama İşlem Hattını Çalıştırma

Veri API'siyle toplama işlem hatlarını bile çalıştırabilirsiniz. Bunu yapmak için toplama uç noktasını kullanın ve işlem hattınızı istek gövdesinin işlem hattı alanında belirtin.

Belge Bul

findOne uç noktasını kullanmak, bir koleksiyondan tek bir belge almanıza olanak sağlar. Arama ölçütlerini belirtmek için istek gövdesindeki filter özelliğini kullanın. Ölçütle eşleşen birden fazla belge varsa, yalnızca ilk eşleşme döndürülür.

Parametreler

Name Anahtar Gerekli Tür Description
MongoDB Küme Adı
dataSource True string

Kümenin adı.

MongoDB Veritabanı Adı
database True string

Veritabanının adı.

MongoDB Koleksiyon Adı
collection True string

Koleksiyonun adı.

filtre
filter object

MongoDB Sorgu Filtresi. findOne eylemi koleksiyondaki bu filtreyle eşleşen ilk belgeyi döndürür.

projeksiyon
projection object

MongoDB Sorgu Projeksiyonu. Projeksiyona bağlı olarak, döndürülen belge belirli alanları atlar veya yalnızca belirtilen alanları veya değerleri içerir

Döndürülenler

Name Yol Tür Description
belge
document object

belge

Belge Ekle

insertOne uç noktasını kullanarak koleksiyona belge ekleyebilirsiniz. Oluşturulacak belgeyi belirtmek için istek gövdesindeki belge özelliğini kullanın.

Parametreler

Name Anahtar Gerekli Tür Description
MongoDB Küme Adı
dataSource True string

Kümenin adı.

MongoDB Veritabanı Adı
database True string

Veritabanının adı.

MongoDB Koleksiyon Adı
collection True string

Koleksiyonun adı.

belge
document True object

Koleksiyona eklenecek bir EJSON belgesi.

Döndürülenler

Name Yol Tür Description
insertedId
insertedId string

insertedId

Belgeyi Güncelleştir

Tek bir kaydı güncelleştirmek için updateOne uç noktasını kullanabilirsiniz. Arama ölçütlerini belirtmek için istek gövdesindeki filter özelliğini kullanın. Ölçütle eşleşen birden fazla belge varsa, yalnızca ilk eşleşme döndürülür. Ardından güncelleştirilmesi gerekenleri belirtmek için güncelleştirme alanını kullanın. Belgelerinizi güncelleştirmek için güncelleştirme işleçlerinden birini kullanmanız gerekir.

Parametreler

Name Anahtar Gerekli Tür Description
MongoDB Küme Adı
dataSource True string

Kümenin adı.

MongoDB Veritabanı Adı
database True string

Veritabanının adı.

MongoDB Koleksiyon Adı
collection True string

Koleksiyonun adı.

filtre
filter True object

MongoDB Sorgu Filtresi.UpdateOne eylemi koleksiyondaki bu filtreyle eşleşen ilk belgeyi değiştirir.

güncelleştirmek
update True object

Eşleşen belgenin nasıl değiştirildiğini belirten bir MongoDB Güncelleştirme İfadesi.

upsert
upsert boolean

Upsert bayrağı yalnızca belirtilen filtreyle eşleşen belge yoksa uygulanır. True ise, updateOne eylemi belirtilen güncelleştirmenin uygulandığı filtreyle eşleşen yeni bir belge ekler.

Döndürülenler

Name Yol Tür Description
matchedCount
matchedCount integer

matchedcount

modifiedCount
modifiedCount integer

modifiedcount

Belgeyi Sil

Tek bir belgeyi silmek için deleteOne uç noktasını kullanın. Arama ölçütlerini belirtmek için istek gövdesindeki filter özelliğini kullanın. Ölçütle eşleşen birden fazla belge varsa, yalnızca ilk eşleşme silinir.

Parametreler

Name Anahtar Gerekli Tür Description
MongoDB Küme Adı
dataSource True string

Kümenin adı.

MongoDB Veritabanı Adı
database True string

Veritabanının adı.

MongoDB Koleksiyon Adı
collection True string

Koleksiyonun adı.

filtre
filter True object

MongoDB Sorgu Filtresi. DeleteOne eylemi koleksiyondaki bu filtreyle eşleşen ilk belgeyi siler.

Döndürülenler

Name Yol Tür Description
deletedCount
deletedCount integer

deletedcount

Birden Çok Belge Bul

Bulma uç noktasını kullanarak aynı anda birden çok belge getirebilirsiniz. Filtreleme ölçütü belirtmek için isteğin gövdesindeki filter özelliğini kullanın. Boş bir nesne geçirirseniz koleksiyondaki tüm belgeler döndürülür.

Parametreler

Name Anahtar Gerekli Tür Description
MongoDB Küme Adı
dataSource True string

Kümenin adı.

MongoDB Veritabanı Adı
database True string

Veritabanının adı.

MongoDB Koleksiyon Adı
collection True string

Koleksiyonun adı.

filtre
filter object

MongoDB Sorgu Filtresi.Bul eylemi koleksiyondaki bu filtreyle eşleşen belgeleri döndürür. Filtre belirtmezseniz, eylem koleksiyonun tüm belgeleriyle eşleşir.

projeksiyon
projection object

MongoDB Sorgu projeksiyonu. Projeksiyona bağlı olarak, döndürülen belgeler belirli alanları atlar veya yalnızca belirtilen alanları ve değerleri içerir.

sort
sort object

MongoDB Sıralama ifadesi. Eşleşen belgeler, ifadede belirtilen alanların artan veya azalan sırada döndürülür.

limit
limit integer

Döndürülen sonuç kümesine eklenecek eşleşen belge sayısı üst sınırı. Her istek en fazla 50.000 belge döndürebilir.

skip
skip integer

Sonuç kümesine eşleşen belgeleri eklemeden önce atlanan eşleşen belge sayısı.

Döndürülenler

Name Yol Tür Description
evrak
documents array of object

evrak

items
documents object

Birden Çok Belge Ekle

insertMany uç noktasını kullanarak aynı anda birden fazla belge ekleyebilirsiniz. Bu durumda, koleksiyona eklemek istediğiniz belge dizisini belirtmek için isteğin gövdesindeki documents özelliğini kullanmanız gerekir.

Parametreler

Name Anahtar Gerekli Tür Description
MongoDB Küme Adı
dataSource True string

Kümenin adı.

MongoDB Veritabanı Adı
database True string

Veritabanının adı.

MongoDB Koleksiyon Adı
collection True string

Koleksiyonun adı.

evrak
documents object

items

Döndürülenler

Name Yol Tür Description
insertedIds
insertedIds array of string

insertedIds

Birden Çok Belgeyi Güncelleştirme

updateMany kullanarak, isteğin gövdesinde belirtilen belirli bir filtreyle eşleşen tüm belgeleri güncelleştirebilirsiniz. Belgelerinizi güncelleştirmek için güncelleştirme alanındaki güncelleştirme işleçlerinden birini kullanın.

Parametreler

Name Anahtar Gerekli Tür Description
MongoDB Küme Adı
dataSource True string

Kümenin adı.

MongoDB Veritabanı Adı
database True string

Veritabanının adı.

MongoDB Koleksiyon Adı
collection True string

Koleksiyonun adı.

filtre
filter True object

MongoDB Sorgu Filtresi. updateMany eylemi koleksiyondaki bu filtreyle eşleşen tüm belgeleri değiştirir.

güncelleştirmek
update True object

Eşleşen belgelerin nasıl değiştirildiğini belirten bir MongoDB Güncelleştirme İfadesi.

upsert
upsert boolean

Upsert bayrağı yalnızca belirtilen filtreyle eşleşen belge yoksa uygulanır. True ise, updateMany eylemi filtreyle eşleşen ve belirtilen güncelleştirmenin uygulandığı yeni bir belge ekler.

Döndürülenler

Name Yol Tür Description
matchedCount
matchedCount integer

matchedcount

modifiedCount
modifiedCount integer

modifiedcount

Birçok Belgeyi Sil

Aynı anda birden çok belgeyi silmek için deleteMany kullanabilirsiniz. Hangi belgelerin silineceğini belirtmek için filter özelliğini kullanın. Bu API'yi filtre olmadan kullanmanın koleksiyondaki tüm belgeleri sileceğine dikkat edin. Deletemany'i dikkatli kullanın.

Parametreler

Name Anahtar Gerekli Tür Description
MongoDB Küme Adı
dataSource True string

Kümenin adı.

MongoDB Veritabanı Adı
database True string

Veritabanının adı.

MongoDB Koleksiyon Adı
collection True string

Koleksiyonun adı.

filtre
filter True object

MongoDB Sorgu Filtresi. deleteMany eylemi koleksiyondaki bu filtreyle eşleşen tüm belgeleri siler.

Döndürülenler

Name Yol Tür Description
deletedCount
deletedCount integer

deletedCount

Toplama İşlem Hattını Çalıştırma

Veri API'siyle toplama işlem hatlarını bile çalıştırabilirsiniz. Bunu yapmak için toplama uç noktasını kullanın ve işlem hattınızı istek gövdesinin işlem hattı alanında belirtin.

Parametreler

Name Anahtar Gerekli Tür Description
MongoDB Küme Adı
dataSource True string

Kümenin adı.

MongoDB Veritabanı Adı
database True string

Veritabanının adı.

MongoDB Koleksiyon Adı
collection True string

Koleksiyonun adı.

pipeline
pipeline object

items

Döndürülenler

Name Yol Tür Description
evrak
documents array of object

evrak

items
documents object