In una prossima release, la JVM in bundle per il plug-in crawler e le funzionalità del connettore cliente passerà a IBM Semeru Runtimes, Versione 21. Se il plug-in del crawler o i connettori personalizzati utilizzano funzioni incompatibili tra IBM SDK, Java Technology Edition, versione 8 e IBM Semeru Runtimes, versione 21, è necessario rivedere il codice per garantire la compatibilità con le versioni future, come Discovery 5.2.x e successive.

Per la migrazione della JVM, vedere le pagine seguenti:

Costruzione di un connettore personalizzato

Discovery fornisce connettori a molte fonti di dati popolari, come descritto in Configurazione delle fonti di dati Cloud Pak for Data. Se è necessario connettersi a un'origine dati diversa, è possibile scrivere e distribuire un connettore personalizzato.

IBM Cloud Pak for Data IBM Software Hub

Queste informazioni si applicano solo alle distribuzioni installate.

Qualsiasi codice personalizzato utilizzato con IBM Watson® Discovery è responsabilità dello sviluppatore e non è coperto dal supporto IBM.

Vengono inclusi i codici di esempio e i file di configurazione per un connettore personalizzato di base.

Argomenti correlati:

Requisiti del connettore personalizzato

Un connettore personalizzato è un componente che utilizza l'SDK e il framework di crawler qui documentato per connettersi a una fonte di dati specifica ed eseguirne il crawling. I connettori personalizzati hanno gli stessi requisiti generali dei connettori forniti. Per ulteriori informazioni, vedi Requisiti dell'origine dati.

Prima di implementare un connettore personalizzato, è necessario conoscere le seguenti informazioni sull'origine dati:

  • La posizione di rete dell'origine dei dati (nome o indirizzo del server, inclusa la porta, o URL, inclusa la porta)
  • Il metodo di autenticazione e le credenziali di sicurezza dell'origine dati
  • Il percorso o i percorsi sull'origine dati di cui il connettore deve eseguire la ricerca per indicizzazione
  • Il metodo o protocollo di connessione supportato dall'origine dati

Progettazione di un connettore personalizzato

Un connettore personalizzato richiede le seguenti funzionalità:

  • Configurazione di un crawler.

    • Configurazione di tutte le impostazioni necessarie per la connessione all'origine dati.
    • Individuazione di un crawl space nell'origine dati. È richiesto almeno uno spazio di ricerca per indicizzazione.

  • Ricerca per indicizzazione dei documenti.

    • Ricerca per indicizzazione dei documenti su ogni insieme di dati.
    • Aggiunta delle informazioni dell'ACL (Access Control List) a ciascun documento.

  • Recupero delle informazioni dell'ACL per il nome utente che esegue l'autenticazione nell'origine dati.

Queste funzionalità possono essere implementate utilizzando le interfacce e i metodi descritti in Developing custom connector code.

Limitazioni del connettore personalizzato

Osservare le seguenti note e avvertenze quando si implementa un connettore personalizzato.

  • I connettore personalizzati non supportano le seguenti funzioni:

    • Impostazioni di sincronizzazione
    • Filtraggio dei documenti in base all'accesso utente al momento della query. (Al momento della ricerca per indicizzazione e dell'indicizzazione, vengono restituiti solo i documenti a cui l'utente corrente ha il diritto di accedere.)
    • Le impostazioni di convalida required e hidden. Vengono ignorati quando il connettore viene visualizzato in Discovery
    • L'uso dei tag <condition /> nel file di definizione. Queste tag sono attualmente ignorate.

  • Quando si utilizza il codice del connettore di esempio nella release corrente, Discovery non collassa e non raggruppa le impostazioni di autenticazione per le proprietà del connettore personalizzato. Ad esempio, anche quando {connector_name}_DATASOURCE_SETTINGS_USE_KEY_LABEL è impostato su Off, l'interfaccia utente mostra i campi per {connector_name}_DATASOURCE_SETTINGS_KEY_LABEL e {connector_name}_DATATSOURCE_SETTINGS_PASSPHRASE_LABEL.

  • Il tipo di parametro list non è supportato.

  • Se per un motivo qualsiasi un connettore personalizzato non riesce a connettersi alla sua origine, emette un messaggio di errore generico come Failed to create connector o Timed out oppure un errore HTTP 500. Al momento non vengono fornite informazioni specifiche sull'errore.

    Consulta le Note sulla release per ulteriori possibili problemi.