In einer kommenden Version wird die gebündelte JVM für das Crawler-Plugin und die Kunden-Connector-Funktionen auf IBM Semeru Runtimes, Version 21, umgestellt. Wenn Ihr Crawler-Plug-in oder Ihre benutzerdefinierten Konnektoren Funktionen verwenden, die nicht mit IBM SDK, Java Technology Edition, Version 8 und IBM Semeru Runtimes, Version 21 kompatibel sind, müssen Sie Ihren Code überarbeiten, um die Kompatibilität mit zukünftigen Versionen, wie Discovery 5.2.x und höher, sicherzustellen.

Informationen zur JVM-Migration finden Sie auf den folgenden Seiten:

Erstellen eines benutzerdefinierten Connectors

Discovery bietet Konnektoren zu vielen gängigen Datenquellen, wie in Konfigurieren von Cloud Pak for Data Datenquellen beschrieben. Wenn Sie eine Verbindung zu einer anderen Datenquelle benötigen, können Sie einen benutzerdefinierten Connector schreiben und bereitstellen.

IBM Cloud Pak for Data IBM Software Hub

Diese Informationen gelten nur für installierte Implementierungen.

Jeder benutzerdefinierte Code, der mit IBM Watson® Discovery verwendet wird, liegt in der Verantwortung des Entwicklers und wird nicht vom IBM Support abgedeckt.

Beispielcode und Konfigurationsdateien für einen angepassten Basisconnector sind enthalten.

Referenzinformationen:

Voraussetzungen für einen angepassten Connector

Ein benutzerdefinierter Konnektor ist eine Komponente, die das hier dokumentierte SDK und Crawler-Framework verwendet, um sich mit einer bestimmten Datenquelle zu verbinden und diese zu crawlen. Für angepasste Connectors gelten die gleichen allgemeinen Voraussetzungen wie für bereitgestellte Connectors. Weitere Informationen finden Sie unter Datenquellenvoraussetzungen.

Bevor Sie einen angepassten Connector implementieren, benötigen Sie die folgenden Informationen zur Datenquelle:

  • Netzstandort der Datenquelle (Servername oder -adresse, einschließlich Port, oder URL, einschließlich Port)
  • Authentifizierungsmethode und Sicherheitsberechtigungsnachweise der Datenquelle
  • Pfade der Datenquelle, die der Connector durchsuchen muss
  • Von der Datenquelle unterstützte Verbindungsmethode oder unterstütztes Protokoll

Angepassten Connector entwerfen

Ein angepasster Connector muss die folgende Funktionalität aufweisen:

  • Konfigurieren eines Crawlers

    • Alle Einstellungen konfigurieren, die für die Verbindung mit der Datenquelle erforderlich sind
    • Erkennung eines Crawlerbereichs in der Datenquelle. Mindestens ein Crawlerbereich ist erforderlich.

  • Crawlersuche in Dokumenten

    • Dokumente in jedem Dataset durchsuchen
    • Informationen aus Zugriffssteuerungslisten zu jedem Dokument hinzufügen

  • Abrufen des Benutzernamens, der sich gegenüber der Datenquelle authentifiziert, aus Zugriffssteuerungslisten

Diese Fähigkeiten können mit Hilfe der Schnittstellen und Methoden implementiert werden, die in Developing custom connector code beschrieben sind.

Einschränkungen für angepasste Connectors

Beachten Sie die folgenden Hinweise und Warnungen, wenn Sie einen benutzerdefinierten Anschluss implementieren.

  • Angepasste Connectors unterstützen die folgenden Features nicht:

    • Synchronisationseinstellungen
    • Filtern von Dokumenten auf der Basis des Benutzerzugriffs während der Abfragezeit. (Beim Durchsuchen und Indexieren werden nur Dokumente zurückgegeben, für die der aktuelle Benutzer über die Zugriffsberechtigung verfügt.)
    • Die Validierungseinstellungen für required und hidden Sie werden ignoriert, wenn der Connector in Discovery angezeigt wird
    • Die Verwendung von <condition /> Tags in der Definitionsdatei. Diese Tags werden derzeit ignoriert.

  • Wenn Sie den Beispiel-Connector-Code in der aktuellen Version verwenden, klappt Discovery die Authentifizierungseinstellungen für die Eigenschaften des benutzerdefinierten Connectors nicht zusammen und gruppiert sie nicht. Selbst wenn der Schalter {connector_name}_DATASOURCE_SETTINGS_USE_KEY_LABEL beispielsweise auf Off gesetzt ist, werden in der Benutzerschnittstelle die Felder für {connector_name}_DATASOURCE_SETTINGS_KEY_LABEL und {connector_name}_DATATSOURCE_SETTINGS_PASSPHRASE_LABEL angezeigt.

  • Der Parametertyp list wird nicht unterstützt.

  • Wenn ein angepasster Connector aus irgendeinem Grund keine Verbindung zu seiner Quelle herstellen kann, gibt er eine generische Fehlernachricht aus, z. B. Failed to create connector oder Timed out oder den HTTP-Fehler 500. Derzeit werden keine konkreten Fehlerinformationen angegeben.

    Weitere mögliche Probleme finden Sie in den Releaseinformationen.