En una próxima versión, la JVM incluida para el complemento de rastreo y las funciones de conector de cliente pasarán a IBM Semeru Runtimes, Versión 21. Si su plug-in de rastreo o sus conectores personalizados utilizan alguna función incompatible entre IBM SDK, Java Technology Edition, Versión 8 y IBM Semeru Runtimes, Versión 21, deberá revisar su código para garantizar la compatibilidad con futuras versiones, como Discovery 5.2.x y posteriores.

Para la migración de JVM, consulte las páginas siguientes:

Creación de un conector personalizado

Discovery proporciona conectores a muchas fuentes de datos populares, como se describe en Configuración de fuentes de datos Cloud Pak for Data. Si necesita conectarse a una fuente de datos diferente, puede escribir e implantar un conector personalizado.

IBM Cloud Pak for Data IBM Software Hub

Esta información sólo se aplica a los despliegues instalados.

Cualquier código personalizado que se utilice con IBM Watson® Discovery es responsabilidad del desarrollador y no está cubierto por el soporte de IBM.

Se incluye un código de ejemplo y archivos de configuración para un conector básico personalizado.

Temas relacionados:

Requisitos de un conector personalizado

Un conector personalizado es un componente que utiliza el SDK y el marco de rastreo que se documenta aquí para conectarse y rastrear una fuente de datos específica. Los conectores personalizados tienen los mismos requisitos generales que los conectores que se proporcionan. Para obtener más información, consulte Requisitos de orígenes de datos.

Antes de implementar un conector personalizado, debe conocer la siguiente información sobre el origen de datos:

  • La ubicación en la red de la fuente de datos (nombre o dirección del servidor, incluido el puerto, o URL, incluido el puerto)
  • El método de autenticación y las credenciales de seguridad del origen de datos
  • La vía o las vías de acceso del origen de datos que el conector debe rastrear
  • El método o el protocolo de conexión al que da soporte el origen de datos

Diseño de un conector personalizado

Un conector personalizado necesita las funciones siguientes:

  • Configuración de un rastreador.

    • Configuración de todos los valores necesarios para conectarse al origen de datos.
    • Descubrir un crawl space en la fuente de datos. Se necesita al menos un espacio de rastreo.

  • Rastreo de documentos.

    • Rastreo de los documentos de cada conjunto de datos.
    • Adición de información de lista de control de accesos (ACL) a cada documento.

  • Recuperación de información de ACL correspondiente al nombre de usuario que se autentica en el origen de datos.

Estas capacidades pueden implementarse utilizando las interfaces y métodos que se describen en Desarrollar código de conector personalizado.

Limitaciones del conector personalizado

Tenga en cuenta las siguientes notas y advertencias cuando implemente un conector personalizado.

  • Los conectores personalizados no dan soporte a las características siguientes:

    • Valores de sincronización
    • Filtrar documentos basándose en el acceso de usuario en el momento de la consulta. (Durante el rastreo y el índice, sólo se devuelven los documentos a los que el usuario actual tiene derecho de acceso.)
    • Los valores de validación required y hidden. Se ignoran cuando el conector se visualiza en Discovery
    • El uso de etiquetas <condition /> en el archivo de definición. Estas etiquetas se pasan por alto actualmente.

  • Cuando se utiliza el código del conector de ejemplo en la versión actual, Discovery no contrae ni agrupa la configuración de autenticación para las propiedades del conector personalizado. Por ejemplo, incluso cuando el conmutador {connector_name}_DATASOURCE_SETTINGS_USE_KEY_LABEL se establece en Off, la interfaz de usuario muestra los campos para {connector_name}_DATASOURCE_SETTINGS_KEY_LABEL y {connector_name}_DATATSOURCE_SETTINGS_PASSPHRASE_LABEL.

  • El tipo de parámetro list no está soportado.

  • Si un conector personalizado no puede conectarse a su origen por cualquier motivo, emite un mensaje de error genérico como Failed to create connector o Timed out, o bien un error HTTP 500. Actualmente no se proporciona información específica del error.

    Consulte las Notas del release para ver más problemas posibles.