MongoDB (förhandsversion)
MongoDB är en allmän, distribuerad dokumentdataplattform som är älskad av utvecklare och används i olika företag för att köra olika arbetsbelastningar. Nu kan du utforska de olika slutpunkterna och utföra CRUD-åtgärder och sammansättningar i din samling med hjälp av MongoDB Connector.
Den här anslutningsappen är tillgänglig i följande produkter och regioner:
| Tjänster | Class | Regioner |
|---|---|---|
| Copilot Studio | Premie | Alla Power Automate-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Logiska appar | Norm | Alla Logic Apps-regioner utom följande: – Azure Government-regioner – Regioner i Azure Kina - US Department of Defense (DoD) |
| Power Apps | - | Ej tillgänglig |
| Power Automate | Premie | Alla Power Automate-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Namn | MongoDB Support |
| URL | https://www.mongodb.com/community/forums/ |
| E-postmeddelande | support-operations@mongodb.com |
| Metadata för anslutningsprogram | |
|---|---|
| Utgivare | MongoDB Corp |
| Webbplats | https://www.mongodb.com |
| Sekretesspolicy | https://www.mongodb.com/legal/privacy-policy |
| Kategorier | Uppgifter |
MongoDB Connector är ett enkelt sätt att ansluta till MongoDB Atlas via data-API:er som hanteras med hjälp av Azure-funktionen i din klientorganisation för att läsa och skriva data till MongoDB Atlas-samlingar. MongoDB-anslutningsprogrammet gör det enkelt att utföra CRUD-åtgärder och sammansättningar på dina data på några minuter och gör att du kan köra frågor mot MongoDB för att skapa omfattande appar och arbetsflöden i Power Apps, Power Automate och Logic Apps.
*** Observera att MongoDB inaktuella Atlas Data-API:er från september 2025 och därmed använder den här anslutningsmetoden för att konfigurera en Azure-funktion och använda dess URL- och API-nycklar i stället för Atlas i dina appar och flöden. ***
Förutsättningar
- Konfigurera Atlas-miljön
Registrera dig för ett nytt Atlas-konto här. Följ stegen 1 till 4 (Skapa ett Atlas-konto, Distribuera ett kostnadsfritt kluster, Lägg till din IP-adress i IP-åtkomstlistan och Skapa en databasanvändare) för att konfigurera Atlas-miljön.
Konfigurera Azure Function som Atlas Data API För att konfigurera Azure-funktionen som ska vara värd för koden för att fungera som Atlas Data-API:er har vi två alternativ – 1. Använda GitHub Actions ELLER 2. Använda Zip Deploy
Om du kan förgrena den aktuella lagringsplatsen kan GitHub-åtgärder vara aktiverade på lagringsplatsen och att du vill lägga till fler API:er och föredrar en CI/CD eller DevOps som har konfigurerats direkt. Men om du letar efter ett snabbt och enkelt sätt att distribuera och bara behöver azure-funktionen konfigurerad för att ersätta Atlas Data-API:erna går du med alternativet Zip-distribution.
Alternativ 1: Konfigurera Azure-funktionen med Hjälp av GitHub-åtgärder
a.Fork MongoDB-lagringsplatsen. Observera url: en för den nya förgrenade lagringsplatsen. Om GitHub-åtgärder INTE är aktiverade som standard aktiverar du dem genom att gå till Inställningar –> Åtgärder –> Allmänt i din förgrenade lagringsplats och välja något av alternativen Tillåt åtgärder/återanvändbara arbetsflöden.
b.Klicka på knappen Distribuera till Azure nedan för att skapa Azure-funktionen i din klientorganisation.
c. Välj eller Skapa resursgruppen som ska innehålla Azure-funktionen och dess associerade komponenter (App Service-plan, lagringskonto och App Insights). Du kan behålla funktionsnamnet och SKU:n som standardvärden eller ändra om du vill följa vissa specifika standarder. Vi rekommenderar att du lägger till klusternamnet i funktionsappens namn så att det är unikt och enkelt att identifiera.
Ge MongoDB-anslutnings-URL:en för klustret som den här Azure-funktionen ska köras mot. Den här anslutningssträngen sparas som en Environmnet-variabel. Ge din förgrenade lagringsplats-URL som GitHub-lagringsplats. Välj Skapa så skapas Azure-funktionen med de associerade resurserna. Observera att i det här skedet skapas funktionsappen, env-variabler fylls i men den faktiska funktionen har ännu inte distribuerats till funktionsappen.
d. Om du vill att GitHub-åtgärder ska köras från lagringsplatsen och distribuera funktionen hämtar du publiceringsprofilen från din skapade Azure-funktion.
Den laddas ned, öppnar den i en textredigerare och kopierar allt innehåll.
e. Gå till din GitHub-lagringsplats –> Inställningar –> Hemligheter och variabler –> Åtgärder Klicka på Ny respositoryhemlighet och kopiera hela värdet i publiceringsprofilen till en ny hemlighet med namnet "AZUREAPPSERVICE_PUBLISHPROFILE"
f. Gör en mindre ändring i README och Checka in ändringar för att anropa GitHub-åtgärder som distribuerar Python-koden till Azure-funktionen i din funktionsapp. Nu bör du se funktionen som är tillgänglig i Functon-appen och koden i function_app.py distribuerad.
g. Fliken GitHub-åtgärder i GitHub-lagringsplatsen visar stegen i distributionen (inklusive installation av beroenden) och resultatet av varje steg.
Alternativ 2: Konfigurera Azure-funktionen med ZipDeploy
a. Klicka på knappen Distribuera till Azure nedan för att skapa Azure-funktionen i din klientorganisation.
b) Välj eller Skapa resursgruppen som ska innehålla Azure-funktionen och dess associerade komponenter (App Service-plan, lagringskonto och App Insights). Du kan behålla funktionsnamnet och SKU:n som standardvärden eller ändra om du vill följa vissa specifika standarder. Vi kom på nytt att du lägger till ditt klusternamn i funktionsappens namn så att det är unikt och enkelt att identifiera.
Ändra ** DONOT ** packageUrl eftersom det är SAS-URL:en för lagringskontot som har den zip som måste distribueras. Välj Skapa så skapar den Azure-funktionsappen, distribuerar azure-funktionen tillsammans med de associerade resurserna.
Hämta autentiseringsuppgifter
Hämta BaseUrl- och API-nyckeln
a. I funktionsappen väljer du din funktion och klickar på Hämta funktions-URL . Kopiera funktions-URL:en från början till före "/action" enligt skärmbilden nedan. Det här är bas-URL:en som du använder för att anropa någon av MongoDB CRUD/Aggregate-API:erna.
b) Gå till funktionsappen –> Under Funktioner –> Appnycklar hämtar du antingen _master eller standard-API-nyckeln för din Azure-funktion Detta är den API-nyckel som du använder tillsammans med bas-URL:en för att skapa en MongoDB-anslutning för att anropa någon av MongoDB CRUD/Aggregate API:er.
Kom igång med anslutningsappen
- När kraven har slutförts går du till PowerAutomate –> Anslutningar. Klicka på "Ny anslutning" och sök efter MongoDB i sökfältet längst upp till höger, som du ser nedan på skärmbilden.
- Klicka på MongoDB-anslutningen så visas popup-fönstret nedan där du uppmanas att ange API-nyckeln och bas-URL:en.
- För fälten "Bas-URL" och "API Key" anger du de värden som hämtats från avsnittet Hämta autentiseringsuppgifter ovan
Använd en av de 8 data-API:erna för crud-åtgärder mot ditt MongoDB Atlas-kluster. För komplexa frågor använder du API:et "Kör en aggregeringspipeline" för att använda aggregeringssteg för att massera utdata från en fas till en annan. Med MongoDB:s flexibilitet och dynamik kan du skapa omfattande appar och automatisera tidskrävande processer. Du fortsätter att förbättra apparna genom att lägga till fler funktioner och fält i samma samling.
Kända problem och begränsningar
Eftersom MongoDB inte tillämpar ett schema kan den aktuella anslutningsappen endast användas med Power Automate och Logic Apps, som stöder dynamiskt schema för API-svaret, som sedan kan parsas med hjälp av konstruktionerna "Parsa JSON". Det kan användas i Power Apps genom att anropa ett Power Automate-flöde för varje MongoDB-interaktion. Du kan också fortsätta att använda den certifierade MongoDB-anslutningsappen från Microsoft Github-lagringsplatsen som en anpassad anslutningsapp för att använda den i Power Apps direkt för att anpassa svarsschemat enligt mongoDB-samlingsschemat.
Begränsningar som gäller för MongoDB-dataåtgärder gäller även för MongoDB-anslutningsappen. Se den här länken om du vill veta mer om de aggregeringssteg som inte stöds i användarkontexten för data-API:er.
Följ den här länken för kända begränsningar med Azure-funktioner som tidsgränser och andra tjänstgränser för varje resursplaner.
Vanliga fel och åtgärder
Vanliga API-svarskoder gäller även här. Eventuella 4XX-fel indikerar problem med begäran från klienten. Kontrollera att dataSource, databas, samling tillhandahålls i ett giltigt JSON-format. Se den här Postman-samlingen för exempel. För 5XX-fel kontrollerar du att Azure-funktionen är igång och kontrollerar spårningen för att undersöka den ytterligare.
Skapa en anslutning
Anslutningsappen stöder följande autentiseringstyper:
| Standardinställning | Parametrar för att skapa anslutning. | Alla regioner | Går inte att dela |
Standard
Tillämpligt: Alla regioner
Parametrar för att skapa anslutning.
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
| Namn | Typ | Description | Krävs |
|---|---|---|---|
| API-nyckel | securestring | API-nyckeln för det här API:et | Sann |
| BaseUrl | snöre | Url:en för Azure-funktionen (exempel:https://mdb-dataapi-repl.azurewebsites.net/api/mdb_dataapi) | Sann |
Begränsningsgränser
| Name | Anrop | Förnyelseperiod |
|---|---|---|
| API-anrop per anslutning | 100 | 60 sekunder |
Åtgärder
| Hitta flera dokument |
Med hjälp av sökslutpunkten kan du hämta flera dokument samtidigt. Använd filteregenskapen i brödtexten i begäran för att ange de kriterier som ska filtreras på. Om du skickar ett tomt objekt returneras alla dokument i samlingen. |
| Infoga dokument |
Med hjälp av insertOne-slutpunkten kan du lägga till ett dokument i en samling. Använd dokumentegenskapen i begärandetexten för att ange det dokument som ska skapas. |
| Infoga flera dokument |
Du kan lägga till fler än ett dokument i taget med hjälp av insertMany-slutpunkten. I så fall måste du använda dokumentegenskapen i brödtexten i begäran för att ange matrisen med dokument som du vill infoga i samlingen. |
| Kör aggregeringspipeline |
Du kan till och med köra aggregeringspipelines med data-API:et. Det gör du genom att använda den aggregerade slutpunkten och ange din pipeline i pipelinefältet i begärandetexten. |
| Sök dokument |
Med hjälp av findOne-slutpunkten kan du hämta ett enda dokument från en samling. Använd filteregenskapen i begärandetexten för att ange sökvillkoren. Om fler än ett dokument matchar kriterierna returneras endast den första matchningen. |
| Ta bort dokument |
Om du vill ta bort ett enskilt dokument använder du deleteOne-slutpunkten. Använd filteregenskapen i begärandetexten för att ange sökvillkoren. Om fler än ett dokument matchar kriterierna tas endast den första matchningen bort. |
| Ta bort många dokument |
Du kan använda deleteMany för att ta bort flera dokument samtidigt. Använd filteregenskapen för att ange vilka dokument som ska tas bort. Se upp för att alla dokument i samlingen tas bort om du använder det här API:et utan filter. Använd deletemany med försiktighet. |
| Uppdatera dokument |
Du kan använda updateOne-slutpunkten för att uppdatera en enskild post. Använd filteregenskapen i begärandetexten för att ange sökvillkoren. Om fler än ett dokument matchar kriterierna returneras endast den första matchningen. Använd sedan uppdateringsfältet för att ange vad som ska uppdateras. Du bör använda en av uppdateringsoperatorerna för att uppdatera dina dokument. |
| Uppdatera flera dokument |
Med updateMany kan du uppdatera alla dokument som matchar ett specifikt filter som anges i brödtexten i begäran. Använd någon av uppdateringsoperatorerna i uppdateringsfältet för att uppdatera dina dokument. |
Hitta flera dokument
Med hjälp av sökslutpunkten kan du hämta flera dokument samtidigt. Använd filteregenskapen i brödtexten i begäran för att ange de kriterier som ska filtreras på. Om du skickar ett tomt objekt returneras alla dokument i samlingen.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
MongoDB-klusternamn
|
dataSource | True | string |
Namnet på klustret. |
|
MongoDB-databasnamn
|
database | True | string |
Namnet på databasen. |
|
MongoDB-samlingsnamn
|
collection | True | string |
Namnet på samlingen. |
|
filter
|
filter | object |
Ett MongoDB-frågefilter.Sökåtgärden returnerar dokument i samlingen som matchar det här filtret. Om du inte anger något filter matchar åtgärden alla dokument i samlingen. |
|
|
projection
|
projection | object |
En MongoDB-frågeprojektion. Beroende på projektionen utelämnar de returnerade dokumenten antingen specifika fält eller innehåller endast angivna fält och värden. |
|
|
sort
|
sort | object |
Ett MongoDB-sorteringsuttryck. Matchade dokument returneras i stigande eller fallande ordning för de fält som anges i uttrycket. |
|
|
limit
|
limit | integer |
Det maximala antalet matchade dokument som ska inkluderas i den returnerade resultatuppsättningen. Varje begäran kan returnera upp till 50 000 dokument. |
|
|
skip
|
skip | integer |
Antalet matchade dokument som ska hoppa över innan du lägger till matchade dokument i resultatuppsättningen. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Dokument
|
documents | array of object |
Dokument |
|
items
|
documents | object |
Infoga dokument
Med hjälp av insertOne-slutpunkten kan du lägga till ett dokument i en samling. Använd dokumentegenskapen i begärandetexten för att ange det dokument som ska skapas.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
MongoDB-klusternamn
|
dataSource | True | string |
Namnet på klustret. |
|
MongoDB-databasnamn
|
database | True | string |
Namnet på databasen. |
|
MongoDB-samlingsnamn
|
collection | True | string |
Namnet på samlingen. |
|
dokument
|
document | True | object |
Ett EJSON-dokument som ska infogas i samlingen. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
insertedId
|
insertedId | string |
insertedId |
Infoga flera dokument
Du kan lägga till fler än ett dokument i taget med hjälp av insertMany-slutpunkten. I så fall måste du använda dokumentegenskapen i brödtexten i begäran för att ange matrisen med dokument som du vill infoga i samlingen.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
MongoDB-klusternamn
|
dataSource | True | string |
Namnet på klustret. |
|
MongoDB-databasnamn
|
database | True | string |
Namnet på databasen. |
|
MongoDB-samlingsnamn
|
collection | True | string |
Namnet på samlingen. |
|
Dokument
|
documents | object |
items |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
insertedIds
|
insertedIds | array of string |
insertedIds |
Kör aggregeringspipeline
Du kan till och med köra aggregeringspipelines med data-API:et. Det gör du genom att använda den aggregerade slutpunkten och ange din pipeline i pipelinefältet i begärandetexten.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
MongoDB-klusternamn
|
dataSource | True | string |
Namnet på klustret. |
|
MongoDB-databasnamn
|
database | True | string |
Namnet på databasen. |
|
MongoDB-samlingsnamn
|
collection | True | string |
Namnet på samlingen. |
|
pipeline
|
pipeline | object |
items |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Dokument
|
documents | array of object |
Dokument |
|
items
|
documents | object |
Sök dokument
Med hjälp av findOne-slutpunkten kan du hämta ett enda dokument från en samling. Använd filteregenskapen i begärandetexten för att ange sökvillkoren. Om fler än ett dokument matchar kriterierna returneras endast den första matchningen.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
MongoDB-klusternamn
|
dataSource | True | string |
Namnet på klustret. |
|
MongoDB-databasnamn
|
database | True | string |
Namnet på databasen. |
|
MongoDB-samlingsnamn
|
collection | True | string |
Namnet på samlingen. |
|
filter
|
filter | object |
Ett MongoDB-frågefilter. Åtgärden findOne returnerar det första dokumentet i samlingen som matchar det här filtret. |
|
|
projection
|
projection | object |
En MongoDB-frågeprojektion. Beroende på projektionen utelämnar det returnerade dokumentet antingen specifika fält eller inkluderar endast angivna fält eller värden |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
dokument
|
document | object |
dokument |
Ta bort dokument
Om du vill ta bort ett enskilt dokument använder du deleteOne-slutpunkten. Använd filteregenskapen i begärandetexten för att ange sökvillkoren. Om fler än ett dokument matchar kriterierna tas endast den första matchningen bort.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
MongoDB-klusternamn
|
dataSource | True | string |
Namnet på klustret. |
|
MongoDB-databasnamn
|
database | True | string |
Namnet på databasen. |
|
MongoDB-samlingsnamn
|
collection | True | string |
Namnet på samlingen. |
|
filter
|
filter | True | object |
Ett MongoDB-frågefilter. Åtgärden deleteOne tar bort det första dokumentet i samlingen som matchar det här filtret. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
deletedCount
|
deletedCount | integer |
deletedcount |
Ta bort många dokument
Du kan använda deleteMany för att ta bort flera dokument samtidigt. Använd filteregenskapen för att ange vilka dokument som ska tas bort. Se upp för att alla dokument i samlingen tas bort om du använder det här API:et utan filter. Använd deletemany med försiktighet.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
MongoDB-klusternamn
|
dataSource | True | string |
Namnet på klustret. |
|
MongoDB-databasnamn
|
database | True | string |
Namnet på databasen. |
|
MongoDB-samlingsnamn
|
collection | True | string |
Namnet på samlingen. |
|
filter
|
filter | True | object |
Ett MongoDB-frågefilter . Åtgärden deleteMany tar bort alla dokument i samlingen som matchar det här filtret. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
deletedCount
|
deletedCount | integer |
deletedCount |
Uppdatera dokument
Du kan använda updateOne-slutpunkten för att uppdatera en enskild post. Använd filteregenskapen i begärandetexten för att ange sökvillkoren. Om fler än ett dokument matchar kriterierna returneras endast den första matchningen. Använd sedan uppdateringsfältet för att ange vad som ska uppdateras. Du bör använda en av uppdateringsoperatorerna för att uppdatera dina dokument.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
MongoDB-klusternamn
|
dataSource | True | string |
Namnet på klustret. |
|
MongoDB-databasnamn
|
database | True | string |
Namnet på databasen. |
|
MongoDB-samlingsnamn
|
collection | True | string |
Namnet på samlingen. |
|
filter
|
filter | True | object |
Ett MongoDB-frågefilter.Åtgärden UpdateOne ändrar det första dokumentet i samlingen som matchar det här filtret. |
|
uppdatering
|
update | True | object |
Ett MongoDB-uppdateringsuttryck som anger hur du ändrar det matchade dokumentet. |
|
lägg till eller uppdatera
|
upsert | boolean |
Upsert-flaggan gäller endast om inga dokument matchar det angivna filtret. Om sant infogar åtgärden updateOne ett nytt dokument som matchar filtret med den angivna uppdateringen som tillämpas på det. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
matchedCount
|
matchedCount | integer |
matchedcount |
|
modifiedCount
|
modifiedCount | integer |
modifiedcount |
Uppdatera flera dokument
Med updateMany kan du uppdatera alla dokument som matchar ett specifikt filter som anges i brödtexten i begäran. Använd någon av uppdateringsoperatorerna i uppdateringsfältet för att uppdatera dina dokument.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
MongoDB-klusternamn
|
dataSource | True | string |
Namnet på klustret. |
|
MongoDB-databasnamn
|
database | True | string |
Namnet på databasen. |
|
MongoDB-samlingsnamn
|
collection | True | string |
Namnet på samlingen. |
|
filter
|
filter | True | object |
Ett MongoDB-frågefilter . Åtgärden updateMany ändrar alla dokument i samlingen som matchar det här filtret. |
|
uppdatering
|
update | True | object |
Ett MongoDB-uppdateringsuttryck som anger hur du ändrar matchade dokument. |
|
lägg till eller uppdatera
|
upsert | boolean |
Upsert-flaggan gäller endast om inga dokument matchar det angivna filtret. Om sant infogar åtgärden updateMany ett nytt dokument som matchar filtret med den angivna uppdateringen. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
matchedCount
|
matchedCount | integer |
matchedcount |
|
modifiedCount
|
modifiedCount | integer |
modifiedcount |