Asignación de campos de origen de datos

Los conectores de origen de datos de Amazon Kendra pueden asignar campos de documentos o contenido del origen de datos a los campos del índice de Amazon Kendra. De forma predeterminada, cada conector está diseñado para rastrear campos de origen de datos específicos. Los campos de origen de datos predeterminados y sus propiedades no se pueden cambiar ni personalizar. En la consola de Amazon Kendra, los campos predeterminados y las propiedades de los campos predeterminados que no se pueden editar aparecen atenuados.

Los conectores de Amazon Kendra también le permiten asignar campos de contenido o documentos personalizados del origen de datos a campos personalizados del índice. Por ejemplo, si tiene un campo en su origen de datos llamado “dept” que contiene información de departamento de un documento, puede asignarlo a un campo de índice denominado “Department”. De esta forma, puede utilizar el campo al consultar documentos.

También puede asignar campos reservados o comunes de Amazon Kendra, como _created_at. Si el origen de datos tiene un campo denominado “creation_date”, puede asignarlo al campo reservado equivalente de Amazon Kendra llamado _created_at. Para obtener más información sobre los campos reservados de Amazon Kendra, consulte Atributos o campos del documento.

Puede asignar campos para la mayoría de orígenes de datos. Puede crear asignaciones de campos para los siguientes orígenes de datos:

Si almacena los documentos en un bucket de S3 o en un origen de datos de S3, especifica los campos mediante un archivo de metadatos JSON. Para obtener más información, consulte Conector de origen de datos de S3.

La asignación de los campos de origen de datos a un campo de índice es un proceso de tres pasos:

Para actualizar el índice y agregar campos personalizados, utilice la consola para editar las asignaciones de campos de origen de datos y agregue un campo personalizado o utilice la API UpdateIndex. Puede añadir un total de 500 campos personalizados a su índice.

Para los orígenes de datos de la base de datos, si el nombre de la columna de la base de datos coincide con el nombre de un campo reservado, el campo y la columna se asignan automáticamente.

Con la API UpdateIndex, se agregan campos reservados y personalizados mediante DocumentMetadataConfigurationUpdates.

En el siguiente ejemplo de JSON se utiliza DocumentMetadataConfigurationUpdates para agregar al índice un campo denominado “Department”.

"DocumentmetadataConfigurationUpdates": [
   {
       "Name": "Department",
       "Type": "STRING_VALUE"
   }
]

Al crear el campo, tiene la opción de configurar cómo se utiliza el campo en las búsquedas. Puede elegir entre las siguientes opciones:

En el siguiente ejemplo de JSON se utiliza DocumentMetadataConfigurationUpdates para agregar al índice un campo denominado “Department” y marcarlo como facetable.

"DocumentMetadataConfigurationUpdates": [
   {
       "Name": "Department",
       "Type": "STRING_VALUE",
       "Search": {
           "Facetable": true
       }
   }
]

Uso de campos de documento comunes o reservados de Amazon Kendra

Con la API UpdateIndex, puede crear campos reservados o comunes utilizando DocumentMetadataConfigurationUpdates y especificando el nombre del campo de índice reservado de Amazon Kendra para asignarlos a su atributo de documento o nombre de campo equivalentes. También puede crear campos personalizados. Si utiliza un conector de origen de datos, la mayoría incluye asignaciones de campos que asignan los campos del documento del origen de datos a campos de índice de Amazon Kendra. Si utiliza la consola, los campos se actualizan seleccionando el origen de datos, seleccionando la acción de edición y, a continuación, pasando a la sección de asignación de campos para configurar el origen de datos.

Puede configurar el objeto Search para establecer un campo como visualizable, facetable, buscable y ordenable. Puede configurar el objeto Relevance para establecer el orden de clasificación, duración de potenciación o período de tiempo de un campo para aplicarlos a los valores de potenciación, actualización, valor de importancia y valores de importancia asignados a valores de campo específicos. Si utiliza la consola, puede configurar los ajustes de búsqueda de un campo seleccionando la opción de faceta en el menú de navegación. Para configurar el ajuste de relevancia, seleccione la opción de buscar en su índice en el menú de navegación, introduzca una consulta y utilice las opciones del panel lateral para ajustar la relevancia de la búsqueda. No puede cambiar el tipo de campo una vez que este se ha creado.

Amazon Kendra tiene los siguientes campos de documento reservados o comunes que puede utilizar:

En el caso de campos personalizados, estos campos se crean mediante DocumentMetadataConfigurationUpdates con la API UpdateIndex, del mismo modo que cuando se crea un campo reservado o común. Debe establecer el tipo de datos adecuado para el campo personalizado. Si utiliza la consola, los campos se actualizan seleccionando el origen de datos, seleccionando la acción de edición y, a continuación, pasando a la sección de asignación de campos para configurar el origen de datos. Algunos orígenes de datos no admiten la adición de campos nuevos o campos personalizados. No puede cambiar el tipo de campo una vez que este se ha creado.

Los siguientes son los tipos que puede configurar para los campos personalizados:

Si ha añadido documentos al índice mediante la API BatchPutDocument, Attributes muestra los campos o atributos de los documentos y crea campos con el objeto DocumentAttribute.

En el caso de los documentos indexados a partir de un origen de datos de Amazon S3, los campos se crean mediante un archivo de metadatos JSON que incluye la información de los campos.

Si utiliza una base de datos compatible como origen de datos, puede configurar los campos mediante la opción de asignación de campos.