Agregar Mongoid a una aplicación existente

Modificar dependencias

Añade la gema mongoid al Gemfile ​​de tu aplicación:

gem 'mongoid'

Para utilizar Mongoid como el único adaptador de base de datos, elimine o comente cualquier biblioteca RDBMS enumerada en,Gemfile sqlite como pg o.

Luego, instale las dependencias ejecutando el siguiente comando:

bundle install

Configuración de Mongoid

Genere la configuración predeterminada de Mongoid ejecutando el siguiente comando:

bin/rails g mongoid:config

Este generador crea el archivo de configuración config/mongoid.yml que se utiliza para configurar la conexión a la implementación de MongoDB y el archivo inicializador config/initializers/mongoid.rb que puede utilizar para configurar otras opciones.

En el archivo config/mongoid.yml, especifique su cadena de conexión y otras opciones de conexión.

Modificar marcos

Abra el archivo config/application.rb y examine su contenido. Si el archivo usa la instrucción require "rails/all" para cargar todos los componentes de Rails, elimínela. Debe agregar una instrucción require independiente para cada componente de Rails, como se muestra en el siguiente archivo config/application.rb de ejemplo:

# Remove or comment out rails/all
#require "rails/all"
# Add the following instead of rails/all:
require "rails"
# Comment out unneeded frameworks
# require "active_record/railtie" rescue LoadError
# require "active_storage/engine" rescue LoadError
require "action_controller/railtie" rescue LoadError
require "action_view/railtie" rescue LoadError
require "action_mailer/railtie" rescue LoadError
require "active_job/railtie" rescue LoadError
require "action_cable/engine" rescue LoadError
# require "action_mailbox/engine" rescue LoadError
# require "action_text/engine" rescue LoadError
require "rails/test_unit/railtie" rescue LoadError

Deshabilitar adaptadores de registros activos

En config/application.rb y en otros archivos de configuración de su aplicación, elimine o comente cualquier referencia a config.active_record y config.active_storage.

Ajustar modelos

Para migrar de Active Record a Mongoid, debes ajustar los modelos existentes de tu aplicación.

Los modelos de registro activo se derivan de la clase ApplicationRecord y no tienen definiciones de columnas, mientras que los modelos Mongoid generalmente no tienen superclase pero deben incluir el atributo Mongoid::Document.

Al crear modelos Mongoid, puede definir campos de las siguientes maneras:

• Definir campos explícitamente

• Usa campos dinámicos

Por ejemplo, un modelo básico de registro activo Post podría parecerse al siguiente:

class Post < ApplicationRecord
  has_many :comments, dependent: :destroy
end

Un modelo Mongoid Post similar podría parecerse al siguiente:

class Post
  include Mongoid::Document
  field :title, type: String
  field :body, type: String
  has_many :comments, dependent: :destroy
end

En lugar de utilizar campos predefinidos, puede definir el modelo Post utilizando campos dinámicos, como se muestra en el siguiente código:

class Post
  include Mongoid::Document
  include Mongoid::Attributes::Dynamic
  has_many :comments, dependent: :destroy
end

Migración de datos

Si ya tiene datos en una base de datos relacional que desea migrar a MongoDB, debe realizar una migración de datos. No es necesario realizar una migración de esquema, ya que MongoDB no requiere un esquema predefinido para almacenar los datos.

Las herramientas de migración suelen ser específicas para los conjuntos de datos. Aunque Mongoid admite un superconjunto de asociaciones Active Record, las referencias de modelos se almacenan de forma diferente en las colecciones al utilizar Mongoid en comparación con Active Record.

Visite los siguientes recursos para obtener más información sobre cómo migrar de un RDBMS a MongoDB:

• Guía de migración de RDBMS a MongoDB en la documentación de AWS

• Modernice sus aplicaciones con MongoDB Atlas en el sitio web de MongoDB

API de Rails

El proceso para crear una aplicación de la API de Rails que use Mongoid es prácticamente el mismo que para crear una aplicación normal. La única diferencia es que debe agregar el indicador --api al ejecutar rails new para crear la aplicación. La migración de una aplicación de la API de Rails a Mongoid sigue el mismo proceso descrito en las secciones anteriores.