Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Índices para la optimización de query

En esta guía, aprenderá a utilizar la extensión de MongoDB para Hibernate ORM para declarar índices de campo único, compuestos y únicos en una entidad. La extensión Hibernate ORM traduce los índices y las restricciones únicas que declara en sus entidades en operaciones de índice de MongoDB cuando habilita la generación de esquemas.

Para crear los índices y las restricciones únicas declaradas en sus entidades, habilite la generación de esquemas en la configuración de su aplicación. Puede habilitar la generación de esquemas con la acción create o create-drop:

  • create: Crea los objetos de esquema sin eliminarlos cuando se cierra el SessionFactory.

  • create-drop: Crea los objetos de esquema cuando se abre el SessionFactory y los descarta cuando se cierra.

Advertencia

La acción create-drop está destinada al desarrollo y las pruebas. No lo utilice cuando necesite conservar datos de producción.

Si utiliza Spring Boot, añada la siguiente propiedad a su archivo application.properties:

spring.jpa.properties.jakarta.persistence.schema-generation.database.action=create-drop

Si configura Jakarta Persistence directamente, añada la siguiente propiedad a su archivo persistence.xml:

<property name="jakarta.persistence.schema-generation.database.action" value="create-drop"/>

Alternativamente, puede establecer la propiedad en su archivo hibernate.properties:

jakarta.persistence.schema-generation.database.action=create-drop

Cuando se ejecuta la generación de esquemas, la extensión Hibernate ORM crea la colección y emite comandos MongoDB createIndexes para los índices y las restricciones únicas que declaran sus entidades.

Los ejemplos de esta guía declaran índices y restricciones únicas añadiendo las anotaciones @Index y @UniqueConstraint a la anotación @Table de la siguiente entidad Movie:

@Entity@Table(name = "movies")public class Movie { @Id @ObjectIdGenerator private ObjectId id; private String title; private String plot; private int year; private List<String> cast; private List<String> directors; public Movie(String title, String plot, int year, List<String> cast, List<String> directors) { this.title = title; this.plot = plot; this.year = year; this.cast = cast; this.directors = directors; } public Movie() { } // Getter and setter methods}

Los índices de campo único son índices con una referencia a un solo campo dentro de los documentos de una colección. Mejoran el rendimiento de query y ordenación para un solo campo.

El siguiente ejemplo crea un índice de campo único en orden descendente en el campo year:

@Table( name = "movies", indexes = { @Index(name = "idx_year", columnList = "year desc") })

Establezca el columnList en el nombre del campo y añada asc o desc para especificar la dirección. Si omite la dirección, MongoDB crea un índice ascendente. El elemento name especifica el nombre del índice de MongoDB.

Para obtener más información, consulta Índices de un solo campo en el manual de MongoDB Server.

Índices compuestos contienen referencias a múltiples campos dentro de los documentos de una colección, mejorando el rendimiento de las consultas y la clasificación.

El siguiente ejemplo crea un índice compuesto en los campos title y year en orden descendente:

@Table( name = "movies", indexes = { @Index(name = "idx_title_year", columnList = "title desc,year desc") })

El orden de los campos en el columnList determina el orden en que MongoDB clasifica las claves del índice, lo que afecta a los prefijos de query que el índice puede admitir. Por ejemplo, un índice en title seguido de year puede admitir query que coincidan solo con title, mientras que un índice en year no ayuda a una query que coincida solo con title.

Para obtener más información, se puede consultar Índices compuestos en el manual de MongoDB Server.

Los índices únicos garantizan que los campos indexados no almacenen valores duplicados.

Puede crear un índice único con la anotación @Index o @UniqueConstraint:

  • Utilice @Index(unique = true) cuando necesite especificar opciones de índice como la dirección del campo.

  • Utilice @UniqueConstraint cuando desee utilizar el modelo de restricciones a nivel de tabla. Los campos en columnNames definen el orden de las claves, y @UniqueConstraint no especifica las direcciones de los campos, por lo que el índice único resultante es ascendente.

El siguiente ejemplo crea un índice único en el campo title:

@Table( name = "movies", indexes = { @Index(name = "idx_title", columnList = "title", unique = true) })

El siguiente ejemplo crea una restricción única en los campos title y plot:

@Table( name = "movies", uniqueConstraints = { @UniqueConstraint(name = "uk_title_plot", columnNames = {"title", "plot"}) })

MongoDB trata un valor null o ausente para un campo indexado como un valor indexado. Debido a la restricción de unicidad, un índice único de un solo campo solo puede contener un documento que tenga un valor null en la entrada de índice.

Importante

La creación de índice único puede fallar

MongoDB no puede crear un índice único en el campo o campos especificados si la colección ya contiene documentos con valores duplicados para esos campos. Realice una revisión de sus datos existentes en busca de valores duplicados antes de crear un índice único.

Para obtener más información, consulte índice único en el manual de MongoDB Server.

Para obtener más información sobre la creación de entidades y la asignación de datos incrustados, consulte la guía Crear entidades para representar colección.

Para aprender a usar sus entidades para ejecutar operaciones de base de datos, consulte las guías Realizar operaciones CRUD y Especificar una query.

Para ver una lista de los tipos de índice que admite la extensión Hibernate ORM, consulte la página compatibilidad de funcionalidades.

Para obtener más información sobre las anotaciones de persistencia de Jakarta utilizadas en esta guía, consulte la documentación de la API de persistencia de Jakarta.

Documentación