Zum Inhalt springen

Pinecone-Connector in Jitterbit Studio

Zusammenfassung

Der Pinecone-Connector stellt Zugriff auf Pinecone bereit.

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

Der Pinecone-Connector wird über die Registerkarte Projektendpunkte und Connectors der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer Pinecone-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann zum Erstellen von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) dienen sollen.

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

Pinecone-Aktivitätstypen

  • Query Vectors: Fragt Vektoren von Pinecone mit Vektor- oder Zeichenfolgendaten ab und soll als Quelle in einem Vorgang verwendet werden.

  • Fetch Vectors: Ruft Vektoren von Pinecone mithilfe von Identifiern ab und soll als Quelle in einem Vorgang verwendet werden.

  • Upsert Vectors: Aktualisiert einen vorhandenen Vektor oder erstellt einen neuen Vektor in Pinecone und soll als Ziel in einem Vorgang verwendet werden.

  • Update Vectors: Aktualisiert einen Vektor in Pinecone und soll als Ziel in einem Vorgang verwendet werden.

  • Delete Vectors: Löscht einen Vektor aus Pinecone und soll als Ziel in einem Vorgang verwendet werden.

Mit diesem Connector erstellte Endpunkte sind in der Endpunktnutzungsberichterstellung enthalten und werden auf Ihre 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 Sie diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update aussetzen.

Der Pinecone-Connector verwendet die Pinecone-API und erfordert einen gültigen Pinecone-API-Schlüssel. Weitere Informationen finden Sie in der API-Dokumentation.

Fehlerbehebung

Bei Problemen mit dem Pinecone-Connector werden diese 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 Vorgangsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

  3. Aktivieren Sie das Debug-Protokollieren von Vorgängen (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-Protokollieren für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten einfügen:

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

Weitere Informationen zur ausführlichen Protokollierung von Connectoren finden Sie unter Ausführliche Protokollierung für Connectoren mit privaten Jitterbit-Agenten.

  1. Bei Verwendung von privaten Agenten können Sie die Agent-Protokolle für weitere Informationen überprüfen.

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