Zum Inhalt springen

MongoDB Abfrageaktivität

Einführung

Eine MongoDB Query-Aktivität unter Verwendung ihrer MongoDB -Verbindung, ruft Daten aus einer MongoDB Sammlung ab und soll als Quelle zum Bereitstellen von Daten in einer Operation verwendet werden.

Erstellen einer MongoDB Abfrageaktivität

Eine Instanz einer MongoDB Query-Aktivität wird aus einer MongoDB -Verbindung erstellt mithilfe des Aktivitätstyps Abfrage.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene MongoDB -Query-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer MongoDB Abfrageaktivität

Führen Sie die folgenden Schritte aus, um eine MongoDB -Abfrage-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein und wählen Sie eine Sammlung aus

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und wählen Sie eine Sammlung aus. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

MongoDB Abfrageaktivität - Konfigurationsschritt 1

  • Name: Geben Sie einen Namen zur Identifizierung der Aktivität ein. Der Name muss für jede MongoDB Query-Aktivität eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :.

  • Wählen Sie ein Objekt aus: Dieser Abschnitt zeigt die im MongoDB Endpoint verfügbaren Sammlungen an.

    • Ausgewähltes MongoDB Objekt: Nachdem eine Sammlung ausgewählt wurde, wird sie hier aufgelistet.

    • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Sammlungen zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Wenn in der Tabelle bereits Sammlungen angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Sammlungen während der Suche vom Endpoint neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Sammlungen vom MongoDB Endpoint neu zu laden. Dies kann nützlich sein, wenn Sammlungen zu MongoDB hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Sammlungstabelle verwendet werden.

    • Auswahl einer Sammlung: Klicken Sie in der Tabelle irgendwo auf eine Zeile, um eine Sammlung auszuwählen. Es kann nur eine Sammlung ausgewählt werden. Die für jede Sammlung verfügbaren Informationen werden vom MongoDB Endpoint abgerufen:

      • Name: Der Name der Sammlung.

      • Beschreibung: Die Beschreibung der Sammlung.

    Tipp

    Wenn die Tabelle nicht mit verfügbaren Sammlungen gefüllt wird, wird die MongoDB -Verbindung ist möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

  • Speichern und beenden: Klicken Sie, wenn aktiviert, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Einstellungen festlegen

Geben Sie in diesem Schritt Filter, Limit, Projektionstyp und Projektion an. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

MongoDB Abfrageaktivität - Konfigurationsschritt 2

Tipp

Felder mit variablem Symbol Unterstützung der Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Filter: Geben Sie einen Filter ein (in MongoDB Extended JSON-Format), das beim Abrufen von Dokumenten der angegebenen Sammlung verwendet werden soll.

  • Limit: Geben Sie die maximale Anzahl von Dokumenten ein, die aus der Sammlung abgerufen werden sollen.

  • Projektionstyp: Wählen Sie einen Projektionstyp aus, entweder Einschließen oder Ausschließen:

    • Einschließen: Gibt bestimmte Felder (angegeben im Feld Projektion) in der Antwort zurück.

    • Ausschließen: Schließt bestimmte Felder (angegeben im Feld Projektion) aus der Antwort aus.

  • Projektion: Geben Sie eine Projektion ein, um in der Abfrage-Antwort zurückgegebene Felder ein- oder auszuschließen. Mehrere Werte müssen durch Kommas getrennt sein.

  • Sortieren: Definieren Sie die Sortierreihenfolge Der Antwort dieser Aktivität. Klicken Sie auf das Symbol „Hinzufügen“ um der folgenden Tabelle eine Eigenschaft und einen Sortiertyp hinzuzufügen:

    • Eigenschaft: Geben Sie den Namen des zu sortierenden Felds ein.
    • Sortiertyp: Geben Sie an, ob die Dokumente, die das Feld enthalten, in aufsteigender Reihenfolge sortiert werden (1) oder absteigende Reihenfolge (-1).

    Um die Zeile zu speichern, klicken Sie auf das Senden-Symbol in der Spalte ganz rechts.

    Um eine einzelne Zeile zu bearbeiten oder zu löschen, bewegen Sie den Mauszeiger über die Spalte ganz rechts und verwenden Sie das Bearbeitungssymbol oder Symbol „Löschen“ .

    Um alle Zeilen zu löschen, klicken Sie auf Alle löschen.

  • Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. In einer Meldung werden Sie aufgefordert zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Überprüfen der Datenschemata

Alle Anforderungs- oder Antwortschemata werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

MongoDB Abfrageaktivität - Konfigurationsschritt 3

  • Datenschemata: Diese Datenschemata werden von benachbarten Transformations übernommen und beim Transformation erneut angezeigt.

    Notiz

    Die in einer Transformation bereitgestellten Daten haben Vorrang vor der Aktivitätskonfiguration.

    Der MongoDB Konnektor verwendet den MongoDB Java Driver v4.1. Weitere Informationen finden Sie in der Treiber und in der MongoDB Referenz für Informationen zu den Schema und -feldern.

    Die Abfrage-Aktivität verwendet XML sowohl in ihren Anforderungs- als auch in ihren Antwortschemata.

    Die Anforderungs- und Antwortdatenschemata bestehen aus diesen Knoten und Feldern:

    • Anfrage:

      Anforderungsschemafeld/-knoten Beschreibung
      queryRequest Anfrage zur Abfrage
      filter Ein Filter im MongoDB Extended JSON Format wird verwendet, um die Dokumente in der ausgewählten Sammlung abzugleichen
      projection Die Projektionszeichenfolge
      limit Maximale Anzahl von Dokumenten, die aus der Sammlung abgerufen werden sollen
      projectionType Der Projektionstyp, entweder include oder exclude
      sort Die Sortierreihenfolge der Antwort auf diese Aktivität
      key Geben Sie das zu sortierende Feld ein
      value Geben Sie an, ob die Dokumente, die das Feld enthalten, aufsteigend sortiert werden sollen (1) oder absteigende Reihenfolge (-1)
      aggregrate Knoten, der die Spezifikationen einer Operation enthält
      unwind Geben Sie das zu abwickelnde Feld ein
      match Knoten, der das Key-Value Paar der Bedingungen für die Match-Pipeline Phase enthält
      key Geben Sie das abgefragte Feld ein
      value Geben Sie den gewünschten Wert des abgefragten Feldes ein
      sortAggregrate Knoten, der die Sortierreihenfolge enthält der Gesamtergebnisse
      key Geben Sie das zu sortierende Feld ein
      value Geben Sie an, ob die Dokumente, die das Feld enthalten, in aufsteigender Reihenfolge zurückgegeben werden (1) oder absteigende Reihenfolge (-1)
      project Knoten mit Bedingungen für die Pipeline
      exclude Geben Sie das Feld ein, das in der Antwort ausgeschlossen werden soll
      include Geben Sie das Feld ein, das in die Antwort aufgenommen werden soll
      group Knoten mit Bedingungen für die Pipeline
      key Geben Sie den Gruppenschlüssel ein
      value Gruppenwert eingeben
      accumulator Geben Sie den Akkumulator ein
      nameNewField Geben Sie den Namen des hinzuzufügenden Felds ein
      out Geben Sie die Sammlung für die Out-Pipeline Phase ein

    • Antwort:

      Antwortschemafeld/-knoten Beschreibung
      queryResponse Antwort der Datenbankabfrage
      records Anzahl der zurückgegebenen Dokumente (Datensätze)
      documents Knoten, der den documents
      document Dokumentinhalt

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom MongoDB Endpoint neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im gesamten Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine MongoDB -Query-Aktivität konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie andere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation konfigurieren, die die Möglichkeit umfassen, Operationen zu verketten, die sich im gleichen oder in unterschiedlichen Workflows befinden.

Auf Menüaktionen für eine Aktivität kann über den Projektbereich und die Design-Canvas zugegriffen werden. Weitere Informationen finden Sie unter Aktionsmenü in Connector-Grundlagen.

MongoDB Query-Aktivitäten können mit diesen Operation als Quelle verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie dann diesen temporären Speicherort in der Skriptfunktion.

Wenn Sie bereit sind, einsetzen und ausführen den Operation und validieren Sie das Verhalten durch Überprüfen der Operation.