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.

Crear, Ver, Actualizar y Borrar documentos

Se puede utilizar la Interfaz de Usuario de Atlas para gestionar documentos dentro de las colecciones. Los documentos son registros individuales en una colección de MongoDB y constituyen la unidad básica de datos en MongoDB.

Visualizar documentos y colecciones en la Interfaz de Usuario de Atlas puede proporcionar una visión general de alto nivel del esquema de una base de datos. Se puede utilizar la Interfaz de Usuario de Atlas para asegurar que se están siguiendo los conceptos fundamentales de modelado de datos de MongoDB, como el uso de documentos incrustados y arreglos.

Para insertar, editar o borrar documentos, se debe haber recibido acceso a través de uno de los siguientes roles:

Para añadir uno o más documentos a una colección a través de la Interfaz de Usuario de Atlas, se pueden especificar los documentos a insertar desde cero o se puede clonar un documento existente y modificar sus campos y valores según sea necesario.

Para insertar documentos en la colección, se debe utilizar uno de los siguientes métodos en Atlas:

  • Moda de sintaxis de shell: guardar o pegar documentos en la sintaxis de shell de MongoDB, que permite nombres de campo sin comillas y constructores de tipo como ObjectId() y ISODate(). Utilizar esta moda para insertar varios documentos a la vez como un arreglo.

  • Editor campo por campo: Seleccione valores y tipos de campo individuales para cada documento insertado. Solo se puede insertar un documento a la vez usando este método.

  • moda JSON: Guardar o pegar documentos en formato JSON extendido, que requiere nombres de campo entre comillas y representa BSON types como contenedores como {"$oid": "..."}. Utilizar esta moda para insertar varios documentos a la vez como un arreglo.

1
  1. Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

  3. En la barra lateral, haz clic en Clusters en la sección Database.

La página de clústeres se muestra.

2
  1. Si aún no aparece, se debe seleccionar la organización que contiene el proyecto en el menú Organizations de la barra de navegación.

  2. Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.

  3. En la barra lateral, haz clic en Data Explorer en la sección Database.

    El Data Explorer se muestra.

IMPORTANTE: También puede hacer clic en el nombre de un grupo para abrir la barra Cluster lateral y luego hacer clic Data Explorer en debajo del Shortcuts encabezado.

3

En el menú desplegable, haga clic en Insert Document.

Alternativamente, puedes hacer clic derecho en la barra de la consulta o en el espacio en blanco circundante y seleccionar Insert document... del menú desplegable.

4

En el modal Insert Document, haga clic en el ícono para usar la moda Shell Syntax para insertar documentos en su colección.

Shell Syntax Moda es la vista por defecto.

5

En la sintaxis de shell de MongoDB, escriba o pegue el documento o los documentos que desea insertar en la colección. Para insertar varios documentos, introduzca un arreglo de documentos separados por comas.

Ejemplo

El siguiente ejemplo inserta un único documento en la colección. Los nombres de campo no están entre comillas, y los valores _id, copies y lastCheckedOut utilizan los constructores de tipo ObjectId(), NumberInt() y ISODate() en lugar de los contenedores de tipo JSON extendido:

{ _id: ObjectId('507f1f77bcf86cd799439011'), title: 'The Odyssey', author: 'Homer', copies: NumberInt('10'), lastCheckedOut: ISODate('2025-03-14T09:30:00Z')}

Nota

Si no especifica un valor _id en su documento, Atlas genera automáticamente un ObjectId para el campo _id.

6

Puede insertar nuevos documentos clonando el esquema y los valores de un documento existente en una colección.

Para clonar un documento, pase el cursor sobre el documento deseado y haga clic en el botón Clone.

Cuando se hace clic en el botón Clone, Atlas abre el cuadro de diálogo de inserción de documentos con el mismo esquema y valores que el documento clonado. Se puede editar cualquiera de estos campos y valores antes de insertar el nuevo documento.

Para ver y gestionar documentos, puede utilizar una de las siguientes vistas en la pestaña Documents:

  • Vista de lista: La vista de documento por defecto. Atlas muestra documentos en una lista. En esta vista, se pueden expandir objetos incrustados y arreglos.

  • Vista JSON: Atlas muestra los documentos como objetos JSON con el formato adecuado. Atlas utiliza JSON extendido para mostrar los tipos de datos de cada campo.

  • Vista de tabla: Atlas muestra los documentos como filas de una tabla, con los campos de los documentos mostrados en las columnas de la tabla. Con esta vista, se puede ver qué documentos contienen valores de campo específicos.

Para expandir los objetos incrustados y los elementos del arreglo, pasar el ratón sobre el documento y hacer clic en la flecha en la esquina superior izquierda.

Para copiar un documento al portapapeles, pasa el cursor sobre el documento y haz clic en el ícono copiar Copy:

La interfaz de usuario de Atlas limita el tamaño total en bytes de los documentos que se muestran por página. Como resultado, puede que se vea un número variable de documentos por página, especialmente si los documentos varían significativamente en tamaño.

Cuando se edita un documento en vista de lista o tabla, Atlas realiza una operación findOneAndUpdate y actualiza solo los campos que se han cambiado.

Cuando se edita un documento en la vista JSON, Atlas realiza una operación de findOneAndReplace y reemplaza el documento.

Para modificar un documento, pasar el cursor sobre el documento y hacer clic en el ícono de lápiz:

Después de hacer clic en el ícono del lápiz, el documento entra en modo de edición. Ahora se pueden realizar cambios en los campos, valores o tipos de datos de los valores.

Para borrar el campo de un documento, hacer clic en el ícono a la izquierda del campo:

Una vez seleccionado, el campo se marca para su eliminación y aparece resaltado en rojo. Atlas solicita confirmación de que se desea actualizar el documento removiendo el campo.

Para añadir un nuevo campo en el documento después de un campo existente, se debe pasar el cursor sobre el número de fila en el cuadro de diálogo y hacer clic en el signo más. El número de fila no forma parte del documento sino del cuadro de diálogo.

También puede añadir un nuevo campo al final del documento pulsando la tecla de pestaña cuando el cursor de texto esté en el valor del último campo del documento.

Para modificar documentos, haga clic en los nombres de campo o valores existentes y realice los cambios. En este ejemplo, el borough se cambió de Manhattan a Queens. Los campos modificados aparecen resaltados en amarillo:

Cuando se edita un documento en vista de lista o tabla, Atlas realiza una operación findOneAndUpdate y actualiza solo los campos que se han cambiado.

Si Atlas detecta que se han cambiado campos que se modificaron fuera de Atlas, lo notifica, evitando que se sobrescriban accidentalmente los cambios realizados fuera de Atlas. Se puede optar por proceder y reemplazar el documento haciendo clic en Replace, o cancelar los cambios.

Cuando se termine de editar el documento, hacer clic en el botón Update para confirmar los cambios hechos.

Para revertir los cambios en un documento, colocar el cursor sobre el campo editado y hacer clic en el revert icon que aparece a la izquierda del número de línea del campo.

Revertir el documento en la vista de lista

Se puede utilizar el flujo de trabajo de las operaciones de actualización masiva para actualizar varios documentos en Atlas. Para obtener más detalles, se puede consultar Modificar múltiples documentos.

Para borrar un documento de una colección a través de la Interfaz de Usuario de Atlas:

Para borrar un documento, se debe pasar el cursor sobre el documento y hacer clic en el ícono .

Después de hacer clic en el botón de borrar, el documento se marca para su borrado. Atlas solicita confirmación de que se desea remover el documento.

Una vez que se confirme, Atlas borrará el documento de la colección.