Elasticsearch Update Document-Aktivität

Einführung

Eine Elasticsearch Update Document-Aktivität, die ihre Elasticsearch-Verbindung verwendet, aktualisiert ein Dokument in Elasticsearch und ist als Ziel in einem Vorgang vorgesehen.

Erstellen einer Elasticsearch Update Document-Aktivität

Eine Instanz einer Elasticsearch Update Document-Aktivität wird aus einer Elasticsearch-Verbindung unter Verwendung des Aktivitätstyps Update Document erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsgrafik oder kopieren Sie den Aktivitätstyp und fügen Sie ihn in die Entwurfsgrafik ein. Für weitere Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

Eine vorhandene Elasticsearch Update Document-Aktivität kann von diesen Orten aus bearbeitet werden:

• Die Entwurfsgrafik (siehe Komponentenaktionsmenü in Entwurfsgrafik).
• Der Komponenten-Tab im Projektbereich (siehe Komponentenaktionsmenü in Projektbereich Komponenten-Tab).

Konfigurieren einer Elasticsearch Update Document-Aktivität

Befolgen Sie diese Schritte, um eine Elasticsearch Update Document-Aktivität zu konfigurieren:

• Schritt 1: Geben Sie einen Namen ein und spezifizieren Sie die Einstellungen
  Geben Sie einen Namen für die Aktivität ein und geben Sie den Namen des Index an, der das zu aktualisierende Dokument enthält.
• Schritt 2: Überprüfen Sie die Datenschemas
  Alle Anforderungs- oder Antwortschemas, die von dem Endpunkt generiert wurden, werden angezeigt.

Schritt 1: Geben Sie einen Namen ein und spezifizieren Sie die Einstellungen

In diesem Schritt geben Sie einen Namen für die Aktivität an und tragen den Namen des Index ein, der das zu aktualisierende Dokument enthält:

• Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Elasticsearch Update Document-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

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

• Aktualisierung mit Skript: Wählen Sie aus, um das Dokument mit einem angegebenen Skript zu aktualisieren. Siehe Elasticsearch-Skripting für Details.

• Upsert: Wählen Sie aus, um das Dokument durch Upserting zu aktualisieren.

• Timeout (in Millisekunden): Geben Sie das Timeout in Millisekunden für die Update Document-Aktivität ein. Ein Timeout von null läuft nie ab, in diesem Fall blockiert der Aufruf unbegrenzt. Der Standardwert beträgt 30000.

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

• Aktualisierungsrichtlinie: Geben Sie die zu verwendende Aktualisierungsrichtlinie an, eine von Sofort, oder Keine, oder Warten bis.

• Speichern & 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 zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

• Änderungen verwerfen: Nach dem Vornehmen von Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Überprüfen der Datenschemas

Alle von dem Endpunkt generierten Anforderungs- oder Antwortschemas werden angezeigt:

• Datenschemas: Diese Datenschemas werden von benachbarten Transformationen geerbt und während der Transformation Mapping erneut angezeigt.

!!! note "Hinweis" Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration.

Der Elasticsearch-Connector verwendet die Elasticsearch REST API 7.14.1. Konsultieren Sie die API-Dokumentation für Informationen zu den Schema-Knoten und -Feldern.

Die Datenschemas bestehen aus diesen Knoten und Feldern:

• Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemata vom Elasticsearch-Endpunkt neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen dasselbe Schema referenziert wird, wie beispielsweise in einer benachbarten Transformation.

• Zurück: Klicken Sie, 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: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Elasticsearch Dokument aktualisieren-Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration des Vorgangs, indem Sie weitere Aktivitäten oder Werkzeuge als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit umfassen, Vorgänge zusammenzuschalten, die sich in denselben oder unterschiedlichen Workflows befinden.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfsgrafik zugänglich. Für Details siehe Aktivitätsaktionsmenü in Connector-Grundlagen.

Elasticsearch Dokument aktualisieren-Aktivitäten können als Ziel mit diesen Vorgangsmustern verwendet werden:

• Transformationsmuster
• Zwei-Transformationsmuster (als erstes oder zweites Ziel)

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

Wenn Sie bereit sind, bereitstellen und ausführen Sie den Vorgang und validieren Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.