MongoDB (Vorschau)
MongoDB ist eine allgemeine, verteilte, Dokumentdatenplattform, die von Entwicklern geliebt wird und in allen Unternehmen verwendet wird, um verschiedene Workloads auszuführen. Sie können nun die verschiedenen Endpunkte untersuchen und CRUD-Vorgänge und Aggregationen in Ihrer Sammlung mithilfe des MongoDB-Connectors ausführen.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | - | Nicht verfügbar |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | MongoDB-Support |
| URL | https://www.mongodb.com/community/forums/ |
| support-operations@mongodb.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | MongoDB Corp |
| Webseite | https://www.mongodb.com |
| Datenschutzrichtlinie | https://www.mongodb.com/legal/privacy-policy |
| Kategorien | Daten |
MongoDB Connector bietet eine einfache Möglichkeit, eine Verbindung mit dem MongoDB Atlas über Daten-APIs herzustellen, die mithilfe der Azure-Funktion in Ihrem Mandanten gehostet werden, um Daten in MongoDB Atlas-Sammlungen zu lesen und zu schreiben. Der MongoDB-Connector erleichtert das Ausführen von CRUD-Vorgängen und Aggregationen ihrer Daten in Minuten und ermöglicht es Ihnen, MongoDB abzufragen, um umfangreiche Apps und Workflows in Power Apps, Power Automate und Logic Apps zu erstellen.
*** Bitte beachten Sie, dass MongoDB die Atlas-Daten-APIs ab September 2025 nicht mehr unterstützt hat, und verwenden Sie daher diesen Connectoransatz, um eine Azure-Funktion einzurichten und ihre URL- und API-Schlüssel anstelle von Atlass in Ihren Apps und Flüssen zu verwenden. ***
Voraussetzungen
- Konfigurieren der Atlas-Umgebung
Registrieren Sie sich hier für ein neues Atlas-Konto. Führen Sie die Schritte von 1 bis 4 aus (Erstellen eines Atlas-Kontos, Bereitstellen eines kostenlosen Clusters, Hinzufügen Ihrer IP zur IP-Zugriffsliste und Erstellen eines Datenbankbenutzers), um die Atlas-Umgebung einzurichten.
Einrichten der Azure-Funktion als Atlas-Daten-API Um die Azure-Funktion einzurichten, die den Code hostet, um als Atlas-Daten-APIs zu fungieren, haben wir zwei Optionen – 1. Verwenden von GitHub-Aktionen ODER 2. Verwenden der Zip-Bereitstellung
Wählen Sie die GitHub-Aktionsmethode aus, wenn Sie das aktuelle Repository verzweigen können, können GitHub-Aktionen in diesem Repository aktiviert sein und dass Sie weitere APIs hinzufügen und ein CI/CD oder DevOps-Setup außerhalb des Felds bevorzugen möchten. Wenn Sie jedoch schnell und einfach nach einer schnellen und einfachen Bereitstellung suchen und nur die Azure-Funktion einrichten müssen, um die Atlas-Daten-APIs zu ersetzen, verwenden Sie die Zip-Bereitstellungsoption.
Option 1: Einrichten der Azure-Funktion mithilfe von GitHub-Aktionen
a.Fork the MongoDB repo. Beachten Sie die url des neuen Verzweigungs-Repositorys. Wenn GitHub-Aktionen nicht standardmäßig aktiviert sind, aktivieren Sie sie, indem Sie zu "Einstellungen – Aktionen –>> Allgemein" in Ihrem Verzweigungs-Repository wechseln und eine der Optionen "Aktionen zulassen/ wiederverwendbare Workflows" auswählen.
b.Klicken Sie auf die schaltfläche " Bereitstellen in Azure ", um die Azure-Funktion in Ihrem Mandanten zu erstellen.
c. Wählen Oder erstellen Sie Ihre Ressourcengruppe, die die Azure-Funktion und die zugehörigen Komponenten (App Service Plan, Speicherkonto und App Insights) enthält. Sie können den Funktionsnamen und die SKU als Standard beibehalten oder ändern, wenn Sie bestimmte Standards einhalten möchten. Es wird empfohlen, den Clusternamen dem Funktions-App-Namen hinzuzufügen, damit er eindeutig und leicht zu identifizieren ist.
Weisen Sie der MongoDB-Verbindungs-URL für den Cluster zu, für den diese Azure-Funktion ausgeführt wird. Diese Verbindungszeichenfolge wird als Environmnet-Variable gespeichert. Geben Sie Ihrer Verzweigungs-Repository-URL als GitHub-Repository. Wählen Sie "Erstellen" aus, und erstellen Sie die Azure-Funktion mit den zugehörigen Ressourcen. Beachten Sie, dass in dieser Phase die Funktions-App erstellt wird, env-Variablen aufgefüllt werden, die tatsächliche Funktion wird jedoch noch nicht in der Funktions-App bereitgestellt.
d. Damit GitHub-Aktionen aus Ihrem Repository ausgeführt und die Funktion bereitgestellt werden, rufen Sie das Veröffentlichungsprofil aus Ihrer erstellten Azure-Funktion ab.
Er wird heruntergeladen, in einem Text-Editor geöffnet und kopiert den gesamten Inhalt.
e. Wechseln Sie zu Ihrem GitHub-Repository -> Einstellungen -> Geheime Schlüssel und Variablen -> Aktionen klicken Sie auf neues Respository-Geheimnis , und kopieren Sie den gesamten Wert in Ihrem Veröffentlichungsprofil in einen neuen geheimen Schlüssel namens "AZUREAPPSERVICE_PUBLISHPROFILE"
f. Nehmen Sie eine geringfügige Änderung in README vor, und übernehmen Sie Änderungen , um GitHub-Aktionen aufzurufen, die den Python-Code in der Azure-Funktion in Ihrer Funktions-App bereitstellen würden. Nun sollte die Funktion in der Functon-App und dem Code in function_app.py bereitgestellt werden.
g. Die Registerkarte "GitHub-Aktionen" in GitHub-Repository zeigt die Schritte in der Bereitstellung (einschließlich der Installation von Abhängigkeiten) und das Ergebnis der einzelnen Schritte an.
Option 2: Einrichten der Azure-Funktion mithilfe von ZipDeploy
a) Klicken Sie auf die schaltfläche " Bereitstellen in Azure ", um die Azure-Funktion in Ihrem Mandanten zu erstellen.
b. Wählen Oder erstellen Sie Ihre Ressourcengruppe, die die Azure-Funktion und die zugehörigen Komponenten (App Service Plan, Speicherkonto und App Insights) enthält. Sie können den Funktionsnamen und die SKU als Standard beibehalten oder ändern, wenn Sie bestimmte Standards einhalten möchten. Wir haben erneut hinzugefügt, dass Sie Ihren Clusternamen dem Funktions-App-Namen hinzufügen, sodass es eindeutig und leicht zu identifizieren ist.
Bitte ** DONOT change ** the packageUrl as it's the SAS URL of the Storage account which has the zip that needs to be deployed. Wählen Sie "Erstellen" aus, und erstellen Sie die Azure-Funktions-App, stellen Sie die Azure-Funktion zusammen mit den zugehörigen Ressourcen bereit.
So erhalten Sie Anmeldeinformationen
Abrufen des BaseUrl- und API-Schlüssels
a) Wählen Sie in der Funktions-App Ihre Funktion aus, und klicken Sie auf "Funktions-URL abrufen" . Kopieren Sie die Funktions-URL von Anfang bis Anfang vor "/action", wie im folgenden Screenshot gezeigt. Dies ist die Basis-URL , die Sie verwenden, um eine der MongoDB CRUD/Aggregate-APIs aufzurufen.
b. Wechseln Sie zu Ihrer Funktions-App –> Unter Funktionen –> App-Schlüssel, greifen Sie entweder den _master oder den Standard-API-Schlüssel für Ihre Azure-Funktion ab. Dies ist der API-Schlüssel , den Sie zusammen mit der Basis-URL verwenden, um eine MongoDB-Verbindung zu erstellen, um eine der MongoDB CRUD/Aggregate-APIs aufzurufen.
Erste Schritte mit Ihrem Connector
- Nachdem die Voraussetzungen abgeschlossen sind, wechseln Sie zu PowerAutomate –> Connections. Klicken Sie auf "Neue Verbindung", und suchen Sie in der Suchleiste oben rechts nach MongoDB, wie unten im Screenshot gezeigt.
- Klicken Sie auf die MongoDB-Verbindung, und Das folgende Popup wird angezeigt, in dem Sie aufgefordert werden, den API-Schlüssel und die Basis-URL einzugeben.
- Geben Sie für die Felder "Basis-URL" und "API-Schlüssel" die Werte ein, die aus dem Abschnitt "Abrufen von Anmeldeinformationen " oben abgerufen wurden.
Verwenden Sie eine der 8 Daten-APIs für alle CRUD-Vorgänge für Ihren MongoDB Atlas Cluster. Verwenden Sie für komplexe Abfragen die API "Aggregationspipeline ausführen", um Aggregationsstufen zu verwenden, um die Ausgabe von einer Phase in eine andere zu massieren. Mit der Flexibilität und Dynamik von MongoDB können Sie umfangreiche Apps erstellen und zeitaufwendige Prozesse automatisieren. Sie verbessern die Apps weiter, indem Sie der gleichen Sammlung weitere Features und Felder hinzufügen.
Bekannte Probleme und Einschränkungen
Da MongoDB kein Schema erzwingt, kann der aktuelle Connector nur mit Power Automate- und Logic-Apps verwendet werden, die dynamisches Schema für die API-Antwort unterstützt, die dann mithilfe der "Parse JSON"-Konstrukte analysiert werden kann. Sie kann in Power Apps verwendet werden, indem sie einen Power Automate-Fluss für jede MongoDB-Interaktion aufruft. Sie können auch weiterhin den zertifizierten MongoDB-Connector aus dem Microsoft Github-Repository als benutzerdefinierten Connector verwenden, um ihn direkt in Power Apps zu verwenden, um das Antwortschema gemäß Ihrem MongoDB-Sammlungsschema anzupassen.
Einschränkungen, die für MongoDB-Datenvorgänge gelten, gelten auch für den MongoDB-Connector. Weitere Informationen zu den Aggregationsphasen, die im Benutzerkontext von Daten-APIs nicht unterstützt werden, finden Sie unter diesem Link .
Folgen Sie diesem Link für die bekannten Einschränkungen bei den Azure-Funktionen wie Timeouts und anderen Dienstgrenzwerten für die einzelnen Ressourcenpläne.
Häufige Fehler und Abhilfemaßnahmen
Typische API-Antwortcodes gelten hier ebenfalls. Alle 4XX-Fehler deuten auf ein Problem mit der Anforderung vom Client hin. Stellen Sie sicher, dass die DataSource, Datenbank, Sammlung in einem gültigen JSON-Format bereitgestellt wird. Beispiele finden Sie in dieser Postman-Auflistung . Stellen Sie bei 5XX-Fehlern sicher, dass die Azure-Funktion ausgeführt wird, und überprüfen Sie die Ablaufverfolgung, um weitere Untersuchungen durchzuführen.
Eine Verbindung wird erstellt
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| API-Schlüssel | securestring | Der API-Schlüssel für diese API | Richtig |
| BaseUrl | Schnur | Url der Azure-Funktion (Beispiel:https://mdb-dataapi-repl.azurewebsites.net/api/mdb_dataapi) | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Aggregationspipeline ausführen |
Sie können sogar Aggregationspipelinen mit der Daten-API ausführen. Verwenden Sie dazu den Aggregatendpunkt, und geben Sie Ihre Pipeline im Pipelinefeld des Anforderungstexts an. |
| Aktualisieren mehrerer Dokumente |
Mithilfe von updateMany können Sie alle Dokumente aktualisieren, die mit einem bestimmten Filter übereinstimmen, der im Textkörper der Anforderung angegeben ist. Verwenden Sie einen der Aktualisierungsoperatoren im Aktualisierungsfeld, um Ihre Dokumente zu aktualisieren. |
| Dokument aktualisieren |
Sie können den updateOne-Endpunkt verwenden, um einen einzelnen Datensatz zu aktualisieren. Verwenden Sie die Filtereigenschaft im Anforderungstext, um die Suchkriterien anzugeben. Wenn mehr als ein Dokument den Kriterien entspricht, wird nur die erste Übereinstimmung zurückgegeben. Verwenden Sie dann das Aktualisierungsfeld, um anzugeben, was aktualisiert werden soll. Sie sollten einen der Aktualisierungsoperatoren verwenden, um Ihre Dokumente zu aktualisieren. |
| Dokument einfügen |
Mithilfe des insertOne-Endpunkts können Sie einer Auflistung ein Dokument hinzufügen. Verwenden Sie die Dokumenteigenschaft im Anforderungstext, um das Dokument anzugeben, das erstellt werden soll. |
| Dokument löschen |
Verwenden Sie den deleteOne-Endpunkt, um ein einzelnes Dokument zu löschen. Verwenden Sie die Filtereigenschaft im Anforderungstext, um die Suchkriterien anzugeben. Wenn mehr als ein Dokument den Kriterien entspricht, wird nur die erste Übereinstimmung gelöscht. |
| Dokument suchen |
Mit dem findOne-Endpunkt können Sie ein einzelnes Dokument aus einer Sammlung abrufen. Verwenden Sie die Filtereigenschaft im Anforderungstext, um die Suchkriterien anzugeben. Wenn mehr als ein Dokument den Kriterien entspricht, wird nur die erste Übereinstimmung zurückgegeben. |
| Einfügen mehrerer Dokumente |
Sie können mehrere Dokumente gleichzeitig hinzufügen, indem Sie den insertMany-Endpunkt verwenden. In diesem Fall müssen Sie die Eigenschaft "documents" im Textkörper der Anforderung verwenden, um das Array von Dokumenten anzugeben, das Sie in die Auflistung einfügen möchten. |
| Suchen mehrerer Dokumente |
Mithilfe des Endpunkts "Suchen" können Sie mehrere Dokumente gleichzeitig abrufen. Verwenden Sie die Filtereigenschaft im Textkörper der Anforderung, um die Kriterien anzugeben, nach denen gefiltert werden soll. Wenn Sie ein leeres Objekt übergeben, werden alle Dokumente in der Auflistung zurückgegeben. |
| Viele Dokumente löschen |
Sie können deleteMany verwenden, um mehrere Dokumente gleichzeitig zu löschen. Verwenden Sie die Filtereigenschaft, um anzugeben, welche Dokumente gelöscht werden sollen. Achten Sie darauf, dass die Verwendung dieser API ohne Filter alle Dokumente in der Sammlung löscht. Verwenden Sie "deletemany" mit Bedacht. |
Aggregationspipeline ausführen
Sie können sogar Aggregationspipelinen mit der Daten-API ausführen. Verwenden Sie dazu den Aggregatendpunkt, und geben Sie Ihre Pipeline im Pipelinefeld des Anforderungstexts an.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
MongoDB-Clustername
|
dataSource | True | string |
Der Name des Clusters. |
|
MongoDB-Datenbankname
|
database | True | string |
Der Name der Datenbank. |
|
MongoDB-Auflistungsname
|
collection | True | string |
Der Name der Sammlung. |
|
pipeline
|
pipeline | object |
items |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Urkunden
|
documents | array of object |
Urkunden |
|
items
|
documents | object |
Aktualisieren mehrerer Dokumente
Mithilfe von updateMany können Sie alle Dokumente aktualisieren, die mit einem bestimmten Filter übereinstimmen, der im Textkörper der Anforderung angegeben ist. Verwenden Sie einen der Aktualisierungsoperatoren im Aktualisierungsfeld, um Ihre Dokumente zu aktualisieren.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
MongoDB-Clustername
|
dataSource | True | string |
Der Name des Clusters. |
|
MongoDB-Datenbankname
|
database | True | string |
Der Name der Datenbank. |
|
MongoDB-Auflistungsname
|
collection | True | string |
Der Name der Sammlung. |
|
Filter
|
filter | True | object |
Ein MongoDB-Abfragefilter . Die UpdateMany-Aktion ändert alle Dokumente in der Auflistung, die diesem Filter entsprechen. |
|
Aktualisierung
|
update | True | object |
Ein MongoDB-Aktualisierungsausdruck, der angibt, wie übereinstimmende Dokumente geändert werden. |
|
Upsert
|
upsert | boolean |
Das Upsert-Flag gilt nur, wenn keine Dokumente mit dem angegebenen Filter übereinstimmen. Wenn true, fügt die UpdateMany-Aktion ein neues Dokument ein, das mit dem Filter übereinstimmt, auf das das angegebene Update angewendet wurde. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
matchedCount
|
matchedCount | integer |
matchedcount |
|
modifiedCount
|
modifiedCount | integer |
modifiedcount |
Dokument aktualisieren
Sie können den updateOne-Endpunkt verwenden, um einen einzelnen Datensatz zu aktualisieren. Verwenden Sie die Filtereigenschaft im Anforderungstext, um die Suchkriterien anzugeben. Wenn mehr als ein Dokument den Kriterien entspricht, wird nur die erste Übereinstimmung zurückgegeben. Verwenden Sie dann das Aktualisierungsfeld, um anzugeben, was aktualisiert werden soll. Sie sollten einen der Aktualisierungsoperatoren verwenden, um Ihre Dokumente zu aktualisieren.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
MongoDB-Clustername
|
dataSource | True | string |
Der Name des Clusters. |
|
MongoDB-Datenbankname
|
database | True | string |
Der Name der Datenbank. |
|
MongoDB-Auflistungsname
|
collection | True | string |
Der Name der Sammlung. |
|
Filter
|
filter | True | object |
Eine MongoDB-Abfragefilter.Die UpdateOne-Aktion ändert das erste Dokument in der Auflistung, das diesem Filter entspricht. |
|
Aktualisierung
|
update | True | object |
Ein MongoDB-Aktualisierungsausdruck, der angibt, wie das übereinstimmende Dokument geändert wird. |
|
Upsert
|
upsert | boolean |
Das Upsert-Flag gilt nur, wenn keine Dokumente mit dem angegebenen Filter übereinstimmen. Wenn true, fügt die UpdateOne-Aktion ein neues Dokument ein, das dem Filter entspricht, auf das das angegebene Update angewendet wurde. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
matchedCount
|
matchedCount | integer |
matchedcount |
|
modifiedCount
|
modifiedCount | integer |
modifiedcount |
Dokument einfügen
Mithilfe des insertOne-Endpunkts können Sie einer Auflistung ein Dokument hinzufügen. Verwenden Sie die Dokumenteigenschaft im Anforderungstext, um das Dokument anzugeben, das erstellt werden soll.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
MongoDB-Clustername
|
dataSource | True | string |
Der Name des Clusters. |
|
MongoDB-Datenbankname
|
database | True | string |
Der Name der Datenbank. |
|
MongoDB-Auflistungsname
|
collection | True | string |
Der Name der Sammlung. |
|
Dokument
|
document | True | object |
Ein EJSON-Dokument, das in die Auflistung eingefügt werden soll. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
insertedId
|
insertedId | string |
insertedId |
Dokument löschen
Verwenden Sie den deleteOne-Endpunkt, um ein einzelnes Dokument zu löschen. Verwenden Sie die Filtereigenschaft im Anforderungstext, um die Suchkriterien anzugeben. Wenn mehr als ein Dokument den Kriterien entspricht, wird nur die erste Übereinstimmung gelöscht.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
MongoDB-Clustername
|
dataSource | True | string |
Der Name des Clusters. |
|
MongoDB-Datenbankname
|
database | True | string |
Der Name der Datenbank. |
|
MongoDB-Auflistungsname
|
collection | True | string |
Der Name der Sammlung. |
|
Filter
|
filter | True | object |
Ein MongoDB-Abfragefilter. Die deleteOne-Aktion löscht das erste Dokument in der Auflistung, das diesem Filter entspricht. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
deletedCount
|
deletedCount | integer |
deletedcount |
Dokument suchen
Mit dem findOne-Endpunkt können Sie ein einzelnes Dokument aus einer Sammlung abrufen. Verwenden Sie die Filtereigenschaft im Anforderungstext, um die Suchkriterien anzugeben. Wenn mehr als ein Dokument den Kriterien entspricht, wird nur die erste Übereinstimmung zurückgegeben.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
MongoDB-Clustername
|
dataSource | True | string |
Der Name des Clusters. |
|
MongoDB-Datenbankname
|
database | True | string |
Der Name der Datenbank. |
|
MongoDB-Auflistungsname
|
collection | True | string |
Der Name der Sammlung. |
|
Filter
|
filter | object |
Ein MongoDB-Abfragefilter. Die FindOne-Aktion gibt das erste Dokument in der Auflistung zurück, das diesem Filter entspricht. |
|
|
Projektion (projection)
|
projection | object |
Eine MongoDB-Abfrageprojektion. Abhängig von der Projektion wird das zurückgegebene Dokument entweder bestimmte Felder weglassen oder nur angegebene Felder oder Werte enthalten. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Dokument
|
document | object |
Dokument |
Einfügen mehrerer Dokumente
Sie können mehrere Dokumente gleichzeitig hinzufügen, indem Sie den insertMany-Endpunkt verwenden. In diesem Fall müssen Sie die Eigenschaft "documents" im Textkörper der Anforderung verwenden, um das Array von Dokumenten anzugeben, das Sie in die Auflistung einfügen möchten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
MongoDB-Clustername
|
dataSource | True | string |
Der Name des Clusters. |
|
MongoDB-Datenbankname
|
database | True | string |
Der Name der Datenbank. |
|
MongoDB-Auflistungsname
|
collection | True | string |
Der Name der Sammlung. |
|
Urkunden
|
documents | object |
items |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
insertedIds
|
insertedIds | array of string |
insertedIds |
Suchen mehrerer Dokumente
Mithilfe des Endpunkts "Suchen" können Sie mehrere Dokumente gleichzeitig abrufen. Verwenden Sie die Filtereigenschaft im Textkörper der Anforderung, um die Kriterien anzugeben, nach denen gefiltert werden soll. Wenn Sie ein leeres Objekt übergeben, werden alle Dokumente in der Auflistung zurückgegeben.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
MongoDB-Clustername
|
dataSource | True | string |
Der Name des Clusters. |
|
MongoDB-Datenbankname
|
database | True | string |
Der Name der Datenbank. |
|
MongoDB-Auflistungsname
|
collection | True | string |
Der Name der Sammlung. |
|
Filter
|
filter | object |
Ein MongoDB-Abfragefilter.Die Suchaktion gibt Dokumente in der Auflistung zurück, die diesem Filter entsprechen. Wenn Sie keinen Filter angeben, stimmt die Aktion mit allen Dokumenten der Auflistung überein. |
|
|
Projektion (projection)
|
projection | object |
Eine MongoDB-Abfrageprojektion. Je nach Projektion lassen die zurückgegebenen Dokumente entweder bestimmte Felder aus oder enthalten nur angegebene Felder und Werte. |
|
|
sort
|
sort | object |
Ein MongoDB-Sortierausdruck. Übereinstimmende Dokumente werden in aufsteigender oder absteigender Reihenfolge der im Ausdruck angegebenen Felder zurückgegeben. |
|
|
limit
|
limit | integer |
Die maximale Anzahl übereinstimmener Dokumente, die in das zurückgegebene Resultset aufgenommen werden sollen. Jede Anforderung kann bis zu 50.000 Dokumente zurückgeben. |
|
|
skip
|
skip | integer |
Die Anzahl der übereinstimmenden Dokumente, die vor dem Hinzufügen übereinstimmener Dokumente zum Resultset übersprungen werden sollen. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Urkunden
|
documents | array of object |
Urkunden |
|
items
|
documents | object |
Viele Dokumente löschen
Sie können deleteMany verwenden, um mehrere Dokumente gleichzeitig zu löschen. Verwenden Sie die Filtereigenschaft, um anzugeben, welche Dokumente gelöscht werden sollen. Achten Sie darauf, dass die Verwendung dieser API ohne Filter alle Dokumente in der Sammlung löscht. Verwenden Sie "deletemany" mit Bedacht.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
MongoDB-Clustername
|
dataSource | True | string |
Der Name des Clusters. |
|
MongoDB-Datenbankname
|
database | True | string |
Der Name der Datenbank. |
|
MongoDB-Auflistungsname
|
collection | True | string |
Der Name der Sammlung. |
|
Filter
|
filter | True | object |
Ein MongoDB-Abfragefilter . Die DeleteMany-Aktion löscht alle Dokumente in der Auflistung, die diesem Filter entsprechen. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
deletedCount
|
deletedCount | integer |
deletedCount |