Configurar las operaciones CRUD

Overview

En esta guía, puede aprender a utilizar el controlador Node.js para configurar operaciones de lectura y escritura.

Configuración de lectura y escritura

Puede controlar cómo el controlador enruta las operaciones de lectura configurando una preferencia de lectura. También puede controlar cómo gestiona la consistencia y durabilidad de los datos configurando una preocupación de lectura o de escritura. Las preocupaciones de lectura especifican el nivel de durabilidad requerido para los datos al realizar operaciones de lectura, y las preocupaciones de escritura especifican cómo espera el controlador la confirmación de las operaciones de escritura en un conjunto de réplicas.

Puede establecer opciones de preocupación de escritura, preocupación de lectura y preferencia de lectura en los siguientes niveles:

• Cliente, que establece el valor predeterminado para todas las ejecuciones de operaciones a menos que se anule

• Transacción

• Database

• Colección

La lista anterior también indica el orden de prioridad creciente de la configuración de las opciones. Por ejemplo, si se establece un nivel de lectura para una transacción, este anulará el nivel de lectura establecido para el cliente.

Esta sección muestra cómo configurar los ajustes de lectura y escritura en cada nivel.

const clientOptions = {
  readPreference: ReadPreference.SECONDARY,
  readConcern: { level: "local" },
  writeConcern: { w: 2 },
};
const client = new MongoClient("mongodb://localhost:27017", clientOptions);

const uri = "mongodb://localhost:27017/?readPreference=secondary&readConcernLevel=local&w=2";
const clientWithUri = new MongoClient(uri);

const transactionOptions = {
  readPreference: ReadPreference.PRIMARY,
  readConcern: { level: "majority" },
  writeConcern: { w: 1 },
};
const session = client.startSession();
session.startTransaction(transactionOptions);

const dbOptions = {
  readPreference: ReadPreference.PRIMARY_PREFERRED,
  readConcern: { level: "available" },
  writeConcern: { w: "majority" },
};
const db = client.db("test_database", dbOptions);

const collOptions = {
  readPreference: ReadPreference.SECONDARY_PREFERRED,
  readConcern: { level: "available" },
  writeConcern: { w: 0 },
};
const collection = db.collection("test_collection", collOptions);

Conjuntos de etiquetas

En MongoDB Server, puede aplicar etiquetas clave-valor a los miembros del conjunto de réplicas según el criterio que elija. Después, puede usar esas etiquetas para seleccionar uno o más miembros para una operación de lectura.

De forma predeterminada, el controlador de Node.js ignora las etiquetas al elegir un miembro para leer. Para indicarle que prefiera ciertas etiquetas, páselas como parámetro al constructor de la clase de preferencia de lectura.

Este ejemplo de código establece la opción readPreference en un conjunto de etiquetas que le indica a test_database que prefiera las lecturas de los miembros del conjunto de réplicas secundarias en el siguiente orden:

1. Miembros del centro de datos de Nueva York ({ dc: 'ny' })

2. Miembros del centro de datos de San Francisco ({ dc: 'sf' })

3. Cualquier miembro secundario ({})

const taggedReadPreference = new ReadPreference(
  ReadPreference.SECONDARY,
  [
    { dc: "ny" },
    { dc: "sf" },
    {}
  ]
);
const dbWithTags = client.db(
  "test_database",
  { readPreference: taggedReadPreference }
);

Umbral local

Si varios miembros del conjunto de réplicas coinciden con la preferencia de lectura y los conjuntos de etiquetas que especifique, el controlador Node.js lee desde los miembros del conjunto de réplicas más cercanos, elegidos de acuerdo con su tiempo de ping.

De forma predeterminada, el controlador utiliza solo los miembros cuyos tiempos de ping están a menos de 15 milisegundos del miembro más cercano para las consultas. Para distribuir las lecturas entre los miembros con latencias más altas, pase la opción localThresholdMS al constructor MongoClient().

El siguiente ejemplo especifica un umbral local de 35 milisegundos:

const clientWithLocalThreshold = new MongoClient("mongodb://localhost:27017", {
  replicaSet: "repl0",
  readPreference: ReadPreference.SECONDARY_PREFERRED,
  localThresholdMS: 35
});

En el ejemplo anterior, el controlador Node.js distribuye lecturas entre los miembros coincidentes dentro de 35 milisegundos del tiempo de ping del miembro más cercano.

Intercalación

Puede especificar una intercalación para modificar el comportamiento de las operaciones de lectura y escritura. Una intercalación es un conjunto de reglas específicas del lenguaje para la comparación de cadenas, como el uso de mayúsculas y minúsculas y los acentos.

MongoDB ordena cadenas utilizando intercalación binaria de forma predeterminada. Esta intercalación por defecto utiliza los valores de caracteres estándar ASCII para comparar y ordenar cadenas. Los lenguajes y las localizaciones tienen convenciones específicas de ordenación de caracteres que difieren del estándar ASCII, y se puede optar por aplicar un conjunto diferente de reglas de intercalación a una operación.

Puede especificar una intercalación en los siguientes niveles:

• Colección: Establece la intercalación predeterminada para las operaciones en la colección. No se puede definir una intercalación para una colección existente.

• Índice: establece la intercalación para las operaciones que utilizan el índice.

• Operación: establece la intercalación de la operación y anula cualquier intercalación heredada.

collation: {
  locale: <string>,
  caseLevel: <bool>,
  caseFirst: <string>,
  strength: <int>,
  numericOrdering: <bool>,
  alternate: <string>,
  maxVariable: <string>,
  backwards: <bool>
}

const db = client.db("db")
db.createCollection("names", {
  collation: { locale: "fr_CA" },
});

const coll = db.collection("names");
coll.createIndex(
  { "last_name" : 1 },
  { "collation" : { "locale" : "en_US" } });

{ "_id" : 1, "first_name" : "Hans", "last_name" : "Muller" }
{ "_id" : 2, "first_name" : "Gunter", "last_name" : "Braun" }
{ "_id" : 3, "first_name" : "Günter", "last_name" : "Krause" }
{ "_id" : 4, "first_name" : "Jürgen", "last_name" : "Weber" }

coll.findOneAndUpdate(
  { first_name: { $lt: "Gunter" } },
  { $set: { verified: true } },
  { collation: { locale: "de@collation=phonebook" } },
);

{ lastErrorObject: { updatedExisting: true, n: 1 },
  value: { _id: 3, first_name: 'Günter', last_name: 'Krause' },
  ok: 1 }

Documentación de la API

Para aprender más sobre cualquiera de los métodos o tipos analizados en esta guía, consulta la siguiente documentación de API:

• MongoClient

• Db

• Colección

• MongoClientOptions

• Opciones de sesión del cliente

• Opciones de transacción

• Opciones de base de datos

• Opciones de colección

• intercalación