Zum Inhalt springen

Apache Kafka „Get Messages“-Aktivität

Einführung

Eine Apache Kafka Aktivität Get Messages unter Verwendung ihrer Apache Kafka-Verbindung, ruft Datenströme aus einem Thema ab in einem Apache Kafka Cluster und soll als Quelle zur Bereitstellung von Daten in einer Operation verwendet werden.

Erstellen einer Apache Kafka Get Messages-Aktivität

Eine Instanz einer Apache Kafka Get Messages-Aktivität wird aus einer Apache Kafka-Verbindung erstellt mithilfe des Aktivitätstyps Nachrichten 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 ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Apache Kafka Aktivität Nachrichten abrufen kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Apache Kafka-Aktivität „Nachrichten abrufen“

Führen Sie die folgenden Schritte aus, um eine Apache Kafka Aktivität Nachrichten abrufen zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein

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

Apache Kafka Get Messages-Aktivität - Konfigurationsschritt 1

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

  • 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: Überprüfen der Datenschemata

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

Apache Kafka Get Messages-Aktivität - Konfigurationsschritt 2

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

Der Apache Kafka Konnektor verwendet die Apache Kafka Core API. Informationen zu den Schema und -feldern finden Sie in der API -Dokumentation.

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

Schemaknoten/-feld anfordern Beschreibung
getMessagesRequest Knoten, der die Aktivitätsanforderung darstellt
consumerGroup Zeichenfolge, die die Verbrauchergruppe enthält, die zum Konsumieren von Daten aus dem Thema verwendet werden soll
sessionTimeoutMS Ganzzahlige Zeitspanne (in Millisekunden) zum Erkennen von Clientfehlern bei Verwendung der Gruppenverwaltungsfunktion von Apache Kafka
maxPollRecords Ganzzahl der maximalen Anzahl von Datensätzen, die in einem einzelnen Aufruf zurückgegeben werden
topic String mit dem Namen des Themas, das die Nachrichten enthält
pollDurationSec Ganzzahlige Zeit (in Sekunden), nach der ein leerer Datensatz zurückgegeben wird, wenn keine Nachrichten abgerufen werden.
Antwortschemaknoten/-feld Beschreibung
getMessagesResponse Knoten, der die Aktivitätsantwort darstellt
message Knoten, der die abgerufene Nachricht darstellt
item Knoten, der die Elemente innerhalb einer Nachricht darstellt
key String, der den Schlüssel der abgerufenen Nachricht enthält
value Zeichenfolge, die den Wert der abgerufenen Nachricht enthält
offset Zeichenfolge, die den Offset enthält, dem die Nachricht zugewiesen ist
topic String mit dem Namen des Themas, zu dem die Nachricht gehört

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Apache Kafka 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 Apache Kafka Aktivität Get Messages konfiguriert haben, schließen Sie die Konfiguration des 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, Vorgänge 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.

Apache Kafka Get Messages-Aktivitäten können als Quelle mit diesen Operation 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.