Zum Inhalt springen

Elasticsearch-Connector in Jitterbit Studio

Zusammenfassung

Der Elasticsearch-Connector stellt Zugriff auf Elasticsearch bereit.

Der Connector bietet eine Schnittstelle zum Erstellen einer Elasticsearch-Verbindung, die Grundlage für die Generierung von Elasticsearch-Aktivitätsinstanzen. Diese Aktivitäten interagieren nach der Konfiguration mit Elasticsearch über die Verbindung.

Der Elasticsearch-Connector wird über die Registerkarte Projektendpunkte und Connectoren der Palette der Designkomponenten aufgerufen (siehe Palette der Designkomponenten).

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer Elasticsearch-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann verwendet, um Aktivitätsinstanzen zu erstellen, die als Quellen (Datenbereitstellung) oder Ziele (Datenempfang) in einer Operation fungieren sollen.

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

Elasticsearch-Aktivitätstypen

  • Search: Ruft vorhandene Datensätze aus Elasticsearch ab und ist für die Verwendung als Quelle in einer Operation vorgesehen.

  • Get Index: Ruft eine Liste von Indizes aus Elasticsearch ab und ist für die Verwendung als Quelle in einer Operation vorgesehen.

  • Get Document: Ruft ein Dokument aus Elasticsearch ab und ist für die Verwendung als Quelle in einer Operation vorgesehen.

  • Delete Document: Löscht ein Dokument aus Elasticsearch und ist für die Verwendung als Ziel in einer Operation vorgesehen.

  • Open Index: Öffnet einen zuvor geschlossenen Index in Elasticsearch und ist für die Verwendung als Ziel in einer Operation vorgesehen.

  • Close Index: Schließt einen Index in Elasticsearch und ist für die Verwendung als Ziel in einer Operation vorgesehen.

  • Create Index: Erstellt einen neuen Index in Elasticsearch und ist für die Verwendung als Ziel in einer Operation vorgesehen.

  • Create Document: Erstellt ein neues Dokument in Elasticsearch und ist für die Verwendung als Ziel in einer Operation vorgesehen.

  • Delete Index: Löscht einen oder mehrere Indizes aus Elasticsearch und ist für die Verwendung als Ziel in einer Operation vorgesehen.

  • Update Document: Aktualisiert ein Dokument in Elasticsearch und ist für die Verwendung als Ziel in einer Operation vorgesehen.

Mit diesem Connector erstellte Endpunkte sind in der Endpunktnutzungsberichterstellung enthalten und werden auf die Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update ausgesetzt werden.

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

Fehlerbehebung

Bei Problemen mit dem Elasticsearch-Connector werden folgende Schritte zur Fehlerbehebung empfohlen:

  1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Disable Auto Connector Update verwendet wird).

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

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

  4. Bei Verwendung von privaten Agenten können Sie das ausführliche Connector-Logging für diesen 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 Connector-Logging finden Sie unter Ausführliches Logging für Connectors mit Jitterbit-Privatagenten.

  5. Bei Verwendung von privaten Agenten können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

  6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.