Cómo usar la API a granel Elasticsearch
Este breve artículo ilustrará el uso de API a granel para llevar a cabo múltiples operaciones de CRUD en una sola solicitud de API.
ELASTSEARCHE API API BASICS
Podemos usar la API a granel enviando una solicitud de publicación HTTP al punto final de la API de Bulk. La solicitud debe contener la operación realizada en la llamada API, como crear o eliminar un índice.
Considere la siguiente solicitud.
Get /Test-Index
Publicar _bulk
"índice": "_index": "test-index-1", "_id": 1
"Field1": "Value1"
"Update": "_id": 1, "_index": "test-index-1"
"Doc": "Field2": "Value2"
"Eliminar": "_index": "test-index-1", "_id": 1
La solicitud de ejemplo anterior realiza tres acciones consecutivas a la vez. Crea un índice y agrega un documento.
A continuación, actualizamos el registro y lo eliminamos.
Debería ver la salida similar a la que se muestra a continuación:
Explicación
Como se mencionó, la API a granel le permite ejecutar múltiples acciones como índice, crear, actualizar y eliminar en una sola consulta.
Cada acción se especifica en el cuerpo de solicitud utilizando el formato JSON delimitado de Newline.
Las operaciones de índice y creación requieren que especifique la fuente. La acción del índice agrega o realiza un reemplazo en el índice como se especifica. Es bueno tener en cuenta que la operación de índice fallará si ya existe un documento con un índice similar.
Una operación de actualización, por otro lado, requiere un documento parcial especificado.
Comprender el cuerpo de solicitud
La API a granel acepta las operaciones para ejecutar en el cuerpo. Las entradas en el cuerpo están en forma de formato delimitado.
Cada entrada en una nueva línea incluye la acción y los datos relacionados para la operación de destino.
Desglose las operaciones que puede especificar en el cuerpo de solicitud y los parámetros aceptados:
Crear
La operación de creación indexará un documento especificado si el documento no existe. Los parámetros esenciales para la operación de creación incluyen:
_índice - Establece el nombre del índice o alias de índice en el que ejecutar la operación de índice. Este parámetro no es opcional si no tiene el parámetro de destino establecido en la ruta de solicitud.
_identificación - La identificación del documento para indexar. Si no tiene valor especificado, ElasticSearch generará la identificación del documento automáticamente.
Actualizar
La operación de actualización llevará a cabo una actualización de documento parcial. Los parámetros de conocimiento para la operación de actualización incluyen:
_índice - Especifica el nombre de las áreas de índice o índice para llevar a cabo la operación de actualización.
_identificación - ID de documento, generado automáticamente si no se especifica.
Doc - Establece el nombre del documento parcial para indexar.
Índice
La operación del índice indexa un documento especificado. Si existe el documento especificado, la operación de índice reemplazará el documento e incrementará su versión. Los parámetros esenciales para esta operación incluyen:
_índice - Establece el nombre del índice o alias de índice para indexar en.
_identificación - ID del documento.
Borrar
La operación de eliminación elimina un documento del índice. Debe saber los parámetros para esta operación incluyen:
_índice - Establece el nombre o alias del índice.
_identificación - La identificación del documento para eliminar del índice.
NOTA: Es bueno prestar atención a la respuesta de la API a granel para determinar información como operaciones fallidas y exitosas.
Conclusión
La API a granel en ElasticSearch puede ser un ahorro de tiempo tanto en la cantidad de solicitudes como en el rendimiento de la indexación. Esta guía proporciona los conceptos básicos de cómo trabajar con la API para realizar múltiples operaciones.
Para obtener más información sobre la API a granel, consulte la documentación.