/ /

Update Documents

Docs Home

Librerías de clientes

Update Documents

Docs Home

Librerías de clientes

Update Documents

Actualizar arreglos en un documento

Overview

En esta guía, puedes aprender cómo actualizar elementos de un arreglo en uno o más documentos.

Para actualizar elementos en un arreglo, realiza las siguientes acciones:

Proporcionar un actualizar documento que especifica la actualización.
Especifique qué elementos de la matriz desea actualizar.
Realice la actualización utilizando una operación de actualización con estas especificaciones.

Datos de muestra

Los ejemplos en esta guía utilizan lo siguiente Drink Estructura como modelo para los documentos de la colección drinks:

type Drink struct {
	Description string
	Sizes       []int32 `bson:"sizes,truncate"`
	Styles      []string
}

La truncate etiqueta struct permite al controlador truncar tipos, como float64, a int32 al deserializar.

Para ejecutar los ejemplos en esta guía, carga los datos de muestra en la colección db.drinks con el siguiente fragmento:

coll := client.Database("db").Collection("drinks")
docsToInsert := []any{
	Drink{Description: "Matcha Latte", Sizes: []int32{12, 16, 20}, Styles: []string{"iced", "hot", "extra hot"}},
}
result, err := coll.InsertMany(context.TODO(), docsToInsert)

Cada documento contiene una descripción de una bebida que incluye la descripción de la bebida, los tamaños disponibles en onzas y los estilos de preparación disponibles, correspondientes a los campos description, sizes y styles en cada documento.

Tip

Bases de datos y colecciones inexistentes

Si la base de datos y la colección necesarias no existen cuando realizas una operación de guardar, el servidor las crea implícitamente.

Los siguientes ejemplos utilizan el método FindOneAndUpdate() para recuperar y actualizar un documento y para devolver el estado del documento después de que ocurra la actualización. Si deseas actualizar varios documentos con un campo de arreglo, utiliza el método UpdateMany().

Especificar los elementos del arreglo

Para especificar qué elementos del arreglo actualizar, utiliza un operador posicional. Los operadores posicionales pueden especificar el primer, varios, o todos los elementos de arreglo a actualizar.

Para especificar elementos de arreglo con un operador posicional, utiliza la notación de puntos. La notación de puntos es una sintaxis de acceso a propiedad para navegar por los elementos del arreglo y los campos de un documento incrustado.

Primer elemento del arreglo

Para actualizar el primer elemento del arreglo que coincida con tu filtro de query, utiliza el operador posicional $. El filtro de query debe ser para el campo arreglo.

Ejemplo

Este ejemplo realiza las siguientes acciones:

Coincide con los elementos del arreglo en sizes donde el valor es menor o igual a 16.
Decrementa el primer valor coincidente del arreglo en 2.

filter := bson.D{{"sizes", bson.D{{"$lte", 16}}}}
update := bson.D{{"$inc", bson.D{{"sizes.$", -2}}}}
opts := options.FindOneAndUpdate().
	SetReturnDocument(options.After)
// Updates the first document that matches the filter
var updatedDoc Drink
err := coll.FindOneAndUpdate(context.TODO(), filter, update, opts).
	Decode(&updatedDoc)
if err != nil {
	panic(err)
}
// Prints the updated document
res, _ := bson.MarshalExtJSON(updatedDoc, false, false)
fmt.Println(string(res))

{"description":"Matcha Latte","sizes":[10,16,20],"styles":["iced","hot","extra hot"]}

Nota

En el ejemplo anterior, el filtro de consulta coincide con los valores 12 16y. Dado que la operación coincide 12 primero con, este es el objetivo de la actualización. Para saber cómo actualizar ambos valores coincidentes, consulte Múltiples elementos de matriz.

Múltiples elementos de arreglo

Para actualizar varios elementos de un arreglo que coincidan con el filtro de query, utiliza el operador posicional filtrado $[<identifier>]. Debes incluir un filtro de arreglo en tu operación de actualización para especificar qué elementos de arreglo actualizar.

El <identifier> es el nombre que utilizas dentro de tu filtro de arreglo. Este valor debe comenzar con una letra minúscula y solo contener caracteres alfanuméricos.

Ejemplo

Este ejemplo realiza las siguientes acciones:

Crea un filtro de arreglos con un identificador llamado hotOptions para hacer coincidir elementos de arreglos que contengan la string "hot".
Aplica el filtro de arreglo utilizando el método SetArrayFilters() al crear una instancia de FindOneAndUpdateOptions.
Elimina los valores de estos elementos del arreglo utilizando el método FindOneAndUpdate().

identifier := []any{bson.D{{"hotOptions", bson.D{{"$regex", "hot"}}}}}
update := bson.D{{"$unset", bson.D{{"styles.$[hotOptions]", ""}}}}
opts := options.FindOneAndUpdate().
	SetArrayFilters(identifier).
	SetReturnDocument(options.After)
// Updates the first document that matches the filter
var updatedDoc Drink
err := coll.FindOneAndUpdate(context.TODO(), bson.D{}, update, opts).
	Decode(&updatedDoc)
if err != nil {
	panic(err)
}
// Prints the updated document
res, _ := bson.MarshalExtJSON(updatedDoc, false, false)
fmt.Println(string(res))

{"description":"Matcha Latte","sizes":[12,16,20],"styles":["iced","",""]}

Todos los elementos de la matriz

Para actualizar todos los elementos de la matriz, utilice el operador posicional $[].

Nota

Si se especifica un filtro de query para el campo de arreglo, el operador posicional $[] ignora el filtro de query y actualiza todos los elementos del arreglo.

Ejemplo

Este ejemplo multiplica cada elemento del arreglo en sizes por 29.57 para convertir de onzas a mililitros:

identifier := []any{bson.D{{"hotOptions", bson.D{{"$regex", "hot"}}}}}
update := bson.D{{"$unset", bson.D{{"styles.$[hotOptions]", ""}}}}
opts := options.FindOneAndUpdate().
	SetArrayFilters(identifier).
	SetReturnDocument(options.After)
// Updates the first document that matches the filter
var updatedDoc Drink
err := coll.FindOneAndUpdate(context.TODO(), bson.D{}, update, opts).
	Decode(&updatedDoc)
if err != nil {
	panic(err)
}
// Prints the updated document
res, _ := bson.MarshalExtJSON(updatedDoc, false, false)
fmt.Println(string(res))

{"description":"Matcha Latte","sizes":[354,473,591],"styles":["iced","hot","extra hot"]}

Información Adicional

Para obtener más información sobre las operaciones analizadas en esta guía, consulte las siguientes guías:

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:

Volver

Reemplazar Documentos

Inserción