Zum Inhalt springen

Elasticsearch-Connector für Jitterbit Studio

Zusammenfassung

Der Elasticsearch-Connector ermöglicht den Zugriff auf Elasticsearch.

Der Connector bietet eine Schnittstelle zur Erstellung einer Elasticsearch-Verbindung, die als Grundlage für die Generierung von Instanzen von Elasticsearch-Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Elasticsearch.

Der Elasticsearch-Connector wird über die Registerkarte Projektendpunkte und Connectoren in der Design-Komponentenpalette aufgerufen (siehe Design-Komponentenpalette).

Übersicht über den Connector

Dieser Connector wird zunächst verwendet, um eine Elasticsearch-Verbindung zu konfigurieren. Die mit dieser Verbindung verbundenen Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (Daten bereitstellend) oder Ziele (Daten empfangend) in einem Vorgang verwendet werden sollen.

Zusammen werden eine spezifische Elasticsearch-Verbindung und ihre Aktivitäten als Elasticsearch-Endpunkt bezeichnet:

Elasticsearch-Aktivitätstypen

  • Suche: Ruft vorhandene Datensätze aus Elasticsearch ab und ist dazu gedacht, als Quelle in einem Vorgang verwendet zu werden.

  • Index abrufen: Ruft eine Liste von Indizes aus Elasticsearch ab und ist dazu gedacht, als Quelle in einem Vorgang verwendet zu werden.

  • Dokument abrufen: Ruft ein Dokument aus Elasticsearch ab und ist dazu gedacht, als Quelle in einem Vorgang verwendet zu werden.

  • Dokument löschen: Löscht ein Dokument aus Elasticsearch und ist dazu gedacht, als Ziel in einem Vorgang verwendet zu werden.

  • Index öffnen: Öffnet einen zuvor geschlossenen Index in Elasticsearch und ist dazu gedacht, als Ziel in einem Vorgang verwendet zu werden.

  • Index schließen: Schließt einen Index in Elasticsearch und ist dazu gedacht, als Ziel in einem Vorgang verwendet zu werden.

  • Index erstellen: Erstellt einen neuen Index in Elasticsearch und ist als Ziel in einer Operation vorgesehen.

  • Dokument erstellen: Erstellt ein neues Dokument in Elasticsearch und ist als Ziel in einer Operation vorgesehen.

  • Index löschen: Löscht einen oder mehrere Indizes aus Elasticsearch und ist als Ziel in einer Operation vorgesehen.

  • Dokument aktualisieren: Aktualisiert ein Dokument in Elasticsearch und ist als Ziel in einer Operation vorgesehen.

Hinweis

Dieser Connector ist ein auf dem Connector SDK basierender Connector, auf den Jitterbit möglicherweise verweist, wenn Änderungen an mit dem Connector SDK erstellten Connectors kommuniziert werden.

Endpunkte, die mit diesem Connector erstellt wurden, sind in der Endpunktnutzungsberichterstattung enthalten und zählen zu Ihrer Lizenz.

Voraussetzungen und unterstützte API-Versionen

Der Elasticsearch-Connector erfordert die Verwendung einer Agenten-Version 10.1 oder höher. Diese Agenten-Versionen laden automatisch die neueste Version des Connectors herunter, wenn dies erforderlich ist.

Der Elasticsearch-Connector verwendet die Elasticsearch REST API 7.14.1. Weitere Informationen zu den Schema-Knoten und -Feldern finden Sie in der API-Dokumentation.

Fehlersuche

Wenn Sie Probleme mit dem Elasticsearch-Connector haben, werden die folgenden Schritte zur Fehlersuche empfohlen:

  1. Klicken Sie auf die Schaltfläche Test in der Verbindungs-Konfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, Sie verwenden die Organisation Richtlinie Automatische Connector-Aktualisierung deaktivieren).

  2. Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung der Operation protokolliert wurden.

  3. Aktivieren Sie das Debug-Logging für Operationen (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Wenn Sie private Agenten verwenden, können Sie das ausführliche Logging für den Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:

    <logger name="org.jitterbit.connector.elasticsearch" level="DEBUG"/>

    Weitere Informationen zum ausführlichen Logging für Connectoren finden Sie unter Ausführliches Logging für Connectoren, die Jitterbit private Agenten verwenden.

  5. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle überprüfen, um weitere Informationen zu erhalten.

  6. Für zusätzliche Überlegungen zur Fehlersuche siehe Fehlerbehebung bei Operationen.