Modificar resultados de la consulta

Datos de muestra

Los ejemplos de esta guía utilizan el Band Modelo, que representa una banda o grupo musical. La definición del modelo Band puede variar en cada sección para mostrar distintas funcionalidades de consulta. Algunas secciones también utilizan el modelo Manager, que representa a la persona que representa a una banda, o el modelo Tour, que representa las presentaciones en vivo de una banda.

Incluir campos

El método only recupera solo los campos especificados de la base de datos.

El siguiente código devuelve solo el campo name de los documentos en los que el valor del campo members es 4:

Band.where(members: 4).only(:name)

Si intenta hacer referencia a atributos que no se han cargado, Mongoid genera un error Mongoid::Errors::AttributeNotLoaded.

También puede utilizar el método only para incluir campos de documentos incrustados.

Tenga en cuenta que el modelo Band incorpora varios objetos Tour. Puede proyectar campos del modelo Tour, como year, como se muestra en el siguiente código:

bands = Band.only(:name, 'tours.year')

Después, puedes acceder a los campos incrustados de los documentos devueltos:

# Returns the first Tour object from
# the first Band in the results
bands.first.tours.first

Se pueden pasar campos de asociaciones referenciadas al método only, pero la proyección se ignora al cargar los objetos incrustados. Mongoid carga todos los campos de las asociaciones referenciadas. Por ejemplo, al acceder al objeto incrustado Tour, como se muestra en el código anterior, Mongoid devuelve el objeto completo, no solo el campo year.

Si un documento contiene asociaciones has_one o has_and_belongs_to_many y desea que Mongoid cargue esas asociaciones cuando llame al método only, debe incluir los campos con claves externas en la lista de atributos.

En el siguiente ejemplo, los modelos Band y Manager tienen una asociación has_and_belongs_to_many:

class Band
  include Mongoid::Document
  field :name, type: String
  has_and_belongs_to_many :managers
end
class Manager
  include Mongoid::Document
  has_and_belongs_to_many :bands
end

El siguiente código demuestra cómo Mongoid puede cargar los objetos Manager asociados si incluye el campo manager_ids:

# Returns null
Band.where(name: 'Astral Projection').only(:name).first.managers
# Returns the first Manager object
Band.where(name: 'Astral Projection').only(:name, :manager_ids).first.managers

Excluir campos

Puede excluir campos explícitamente de los resultados utilizando el método without.

El siguiente código excluye el campo year de los objetos Band devueltos:

Band.where(members: 4).without(:year)

Limitar el número de resultados

Puede utilizar el método limit para limitar la cantidad de resultados que devuelve Mongoid.

El siguiente código recupera un máximo de 5 documentos:

Band.limit(5)

Band.take(5)

Saltar resultados

Puede omitir una cantidad específica de resultados utilizando el método skip o su alias offset.

Si encadena una llamada limit a skip, el límite se aplica después de omitir los documentos, como se muestra en el siguiente ejemplo:

Band.skip(2).limit(5)
# Skips the first two results and returns
# the following five results

El siguiente código omite los primeros 3 documentos al devolver resultados:

Band.skip(3)
# Equivalent
Band.offset(3)

Generar lotes de resultados

Al ejecutar consultas grandes e iterar sobre los resultados de la consulta mediante un método enumerador Criteria#each como, Mongoid usa automáticamente el comando getMore de MongoDB para cargar los resultados en lotes. El tamaño predeterminado del lote 1000 es, pero se puede establecer un valor diferente con el batch_size método.

El siguiente código establece el tamaño del lote en 500:

Band.batch_size(500)