Phenquestions
En este tutorial rápido, veremos Elasticsearch, específicamente cómo crear índices en el motor de Elasticsearch. Aunque no necesita ningún conocimiento completo sobre la pila de ELK para seguir este tutorial, tener un conocimiento básico de los siguientes temas puede resultar ventajoso:
- Usando la terminal, específicamente, cURL
- Conocimientos básicos de API y JSON
- Realización de una solicitud HTTP
NOTA: Este tutorial también asume que tiene Elasticsearch instalado y ejecutándose en su sistema.
¿Qué son los índices de Elasticsearch??
Sin simplificar o complicar demasiado las cosas, un índice de Elasticsearch es una colección de documentos JSON relacionados.
Como se mencionó en una publicación anterior, los índices de Elasticsearch son objetos JSON, considerados la unidad base de almacenamiento en Elasticsearch. Estos documentos JSON relacionados se almacenan en una sola unidad que forma un índice. Piense en los documentos de Elasticsearch como tablas en una base de datos relacional.
Relacionemos un índice Elasticsearch como una base de datos en el mundo SQL.
- MySQL => Bases de datos => Tablas => Columnas / Filas
- Elasticsearch => Índices => Tipos => Documentos JSON con propiedades
Cómo crear un índice de Elasticsearch
Elasticsearch utiliza una API REST potente e intuitiva para exponer sus servicios. Esta funcionalidad le permite utilizar solicitudes HTTP para realizar operaciones en el clúster de Elasticsearch. Por lo tanto, usaremos la API de creación de índices para crear un nuevo índice.
Para esta guía, usaremos cURL para enviar las solicitudes y preservar la integridad y usabilidad para todos los usuarios. Sin embargo, si encuentra errores con cURL, considere usar Kibana Console.
La sintaxis para crear un nuevo índice en el clúster de Elasticsearch es:
PONER /Para crear un índice, todo lo que tiene que hacer es pasar el nombre del índice sin otros parámetros, lo que crea un índice usando la configuración predeterminada.
También puede especificar varias características del índice, como en el cuerpo del índice:
- La configuración del índice
- Alias de índice
- Asignaciones para campos de índice
El nombre del índice es un parámetro obligatorio; de lo contrario, obtendrá un error para el URIL (/)
curl -X PUT "localhost: 9200""error": "Método HTTP incorrecto para uri [/] y método [PUT], permitido: [DELETE, HEAD, GET]", "status": 405
Para crear un nuevo índice con el nombre single_index, pasamos la solicitud:
PUT / single_indexPara cURL, use el comando:
curl -X PUT "localhost: 9200 / single_index?bonito"Este comando debería dar como resultado HTTP Status 200 OK y un mensaje con reconocido: verdadero como:
"Reconocido": verdadero,
"shards_acknowledged": verdadero,
"index": "single_index"
La solicitud anterior crea un índice single_index con la configuración predeterminada, ya que no especificamos ninguna configuración.
Reglas de nomenclatura de índices
Al crear nombres para índices de Elasticsearch, debe cumplir con los siguientes estándares de nomenclatura:
- El nombre del índice debe estar solo en minúsculas.
- Los nombres de índice no pueden comenzar con un guión (-), un guión bajo (_) o un signo de suma (+)
- Los nombres no pueden ser . o…
- Los nombres de índice no pueden incluir caracteres especiales como: \, /, *, ?, ", <, >, |, "(carácter de espacio), ,, #
- La longitud de los nombres de índice debe ser inferior a 255 bytes. Los caracteres de varios bytes contarán en la longitud total del nombre del índice. Por ejemplo, si un solo carácter tiene 8 bytes de longitud, la longitud total restante del nombre es 255 - 8
- En la última versión de Elasticsearch, los nombres que comienzan con un . están reservados para índices ocultos e índices internos utilizados por los complementos de Elasticsearch.
Cómo crear un cuerpo de índice
Al usar la solicitud PUT para crear un índice, puede pasar varios argumentos que definen la configuración del índice que desea crear. Los valores que puede especificar en el cuerpo incluyen:
- Alias: Especifica nombres de alias para el índice que desea crear; este parámetro es opcional.
- Ajustes: Esto define las opciones de configuración para el índice que desea crear. Si no especifica ningún parámetro, el índice se crea con las configuraciones predeterminadas.
- Asignaciones: Esto define la asignación de campos en el índice. Las especificaciones que puede incluir en las asignaciones incluyen:
- El nombre del campo
- El tipo de datos
- El parámetro de mapeo
Para ver un ejemplo de creación de un índice con configuraciones de cuerpo, considere la solicitud a continuación:
PUT / single_index_with_body"ajustes":
"número_de_partidos": 2,
"número_de_replicas": 2
,
"Asignaciones":
"propiedades":
"campo1": "tipo": "objeto"
Para una solicitud equivalente a cURL:
curl -XPUT "http: // localhost: 9200 / single_index_with_body" -H 'Content-Type: application / json' -d '"settings": "number_of_shards": 2, "number_of_replicas": 2, "mappings" : "propiedades": "campo1": "tipo": "objeto" 'La solicitud anterior crea un nuevo índice con el nombre single_index_with_body con 2 números de fragmentos y 2 réplicas. También crea un mapeo con un campo de nombre field1 y escribe como un objeto JSON.
Una vez que envíe la solicitud, recibirá una respuesta con el estado de la solicitud como:
"Reconocido": verdadero,
"shards_acknowledged": verdadero,
"index": "single_index_with_body"
"Reconocido" muestra si el índice se creó correctamente en el clúster, mientras que "shards_acknowledged" muestra si la cantidad requerida de copias de fragmentos se inició para cada fragmento en el índice especificado antes de que expire.
Cómo ver el índice Elasticsearch
Para ver la información sobre el índice que creó, use una solicitud similar a la de crear un índice, pero use el método HTTP en lugar de PUT como:
GET / single_index_with_bodyPara curl,
curl -XGET "http: // localhost: 9200 / single_index_with_body"Este comando le dará información detallada sobre el índice solicitado como:
"single_index_with_body":
"alias": ,
"asignaciones":
"propiedades":
"campo1":
"tipo": "objeto"
,
"ajustes" :
"índice":
"enrutamiento":
"asignación":
"incluir":
"_tier_preference": "data_content"
,
"número_de_partidos": "2",
"nombre_proporcionado": "índice_único_con_cuerpo",
"creation_date": "1611045687208",
"number_of_replicas": "2",
"uuid": "3TRkO7xmQcSUOOGtb6pXVA",
"versión" :
"creado": "7100299"
Conclusión
Esta guía analiza cómo trabajar con Elasticsearch para crear índices API para crear nuevos índices. También discutimos cómo crear nombres adecuados para los índices y los ajustes de configuración.
Al usar esta guía, ahora puede crear y ver índices usando la API de Elasticsearch.
