Zum Inhalt springen

Elasticsearch Aktivität „Dokument abrufen“

Einführung

Eine Elasticsearch Aktivität Get Document unter Verwendung ihrer Elasticsearch Verbindung, ruft eine Dokument von Elasticsearch und soll als Quelle zur Bereitstellung von Daten in einer Operation verwendet werden.

Notiz

Wenn die Elasticsearch Sicherheitsfunktionen in Ihrer Elasticsearch Instanz aktiviert sind, müssen Sie über die read Indexberechtigung für den Zielindex oder Indexalias.

Erstellen einer Elasticsearch Aktivität „Get Document“

Eine Instanz einer Elasticsearch Get Document-Aktivität wird erstellt aus einem Elasticsearch Verbindung mithilfe des Aktivitätstyps Dokument abrufen.

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 es auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Elasticsearch Aktivität Dokument abrufen kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Elasticsearch Aktivität „Dokument abrufen“

Befolgen Sie diese Schritte, um eine Elasticsearch Aktivität Dokument abrufen zu konfigurieren:

Schritt 1: Namen eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität an und geben Sie den Namen des Index ein, der das zu abgerufen:

Elasticsearch Get Document-Aktivitätskonfigurationsschritt 1

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.

  • Name: Geben Sie einen Namen zur Identifizierung der Aktivität ein. Der Name muss für jedes Elasticsearch Get Document eindeutig sein. Aktivität und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:).

  • Index: Geben Sie den Namen des Index ein, der das Dokument enthält.

  • Routing: Geben Sie den Routing-Wert für den Index-Shard ein.

  • Versionstyp: Geben Sie den zu verwendenden Versionstyp an, einen von Intern, Extern oder Externes GTE.

  • Aktualisieren: Geben Sie die Aktualisierung an zu verwenden, entweder True oder False.

  • Speichern und beenden: Wenn aktiviert, klicken Sie, 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: Überprüfen der Datenschemata

Alle vom Endpoint generierten Anforderungs- oder Antwortschemata werden angezeigt:

Elasticsearch Get Document-Aktivitätskonfigurationsschritt 2

  • Datenschemata: Diese Datenschemata werden von benachbarten Transformations übernommen und bei der Transformation.

!!! note "Notiz" Die in einer Transformation bereitgestellten Daten haben Vorrang vor der Aktivitätskonfiguration.

Der Elasticsearch Konnektor verwendet die Elasticsearch REST API 7.14.1. Siehe die API Dokumentation für Informationen zu den Schema und -feldern.

Die Datenschemata bestehen aus diesen Knoten und Feldern:

Schemaknoten/-feld anfordern Beschreibung
id Die ID des Dokuments
Version Die Dokumentversion
Antwortschemaknoten/-feld Beschreibung
Index Name des Index, der das Dokument enthält
Typ Dokumenttyp
id Die ID des Dokuments
Version Die Dokumentversion
seq_no Die dem Dokument zugewiesene Sequenznummer
primary_term Der dem Dokument zugewiesene primäre Begriff
gefunden Gibt an, ob das Dokument existiert
Quelle Wenn found Ist true, enthält die im JSON formatierten Dokumentdaten

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Elasticsearch Endpoint neu generieren. Diese Aktion generiert auch ein Schema in anderen Stellen im gesamten Projekt, 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 auf, um die Konfiguration zu schließen, ohne die Änderungen an Schritt. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Elasticsearch Aktivität Get Document konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie und Konfigurieren anderer Aktivitäten, Transformations oder Scripts als Operation. Sie können auch die Operation, die die Möglichkeit umfassen, Operationen miteinander zu verketten, die sich im gleichen oder in verschiedenen Workflows.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktionsmenü in Grundlagen zu Konnektoren.

Elasticsearch Get Document-Aktivitäten können als Quelle verwendet werden mit diesen Operation:

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. Speicherort in der Skriptfunktion.

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