/ /

Configurar los ajustes

Docs Home

/ /

Configurar

Configurar los ajustes

Configurar los ajustes

Configurar ajustes mediante un archivo de configuración

Puedes especificar mongosh Configuración en un archivo de configuración global. Al especificar la configuración en un archivo de configuración, esta se aplica al inicio. Tras crear un archivo de configuración, la configuración del archivo se aplicará la próxima vez que inicie mongosh.

Formato del archivo de configuración

El archivo de configuración mongosh utiliza el formato YAML. Todas las opciones se encuentran en el espacio de nombres mongosh.

Archivo de configuración de ejemplo

Los siguientes conjuntos de archivos de configuración:

displayBatchSize a 50
inspectDepth a 20
redactHistory to remove-redact

mongosh:
  displayBatchSize: 50
  inspectDepth: 20
  redactHistory: "remove-redact"

Ubicación del archivo de configuración

La ubicación del archivo donde mongosh busca el archivo de configuración depende de su sistema operativo:

Sistema operativo	Ubicación del archivo
Windows	`mongosh.cfg`, en el mismo directorio que el binario `mongosh.exe`.
macOS	`mongosh` busca un archivo de configuración en los siguientes directorios en el orden en que aparecen enumerados: `/usr/local/etc/mongosh.conf` `/opt/homebrew/etc/mongosh.conf` `/etc/mongosh.conf` Una vez que `mongosh` lee un archivo de configuración en uno de estos directorios, no se verifican los directorios restantes en la lista y se ignoran los archivos de configuración en esos directorios.
Linux	`/etc/mongosh.conf`

Ajustes configurables

Puede especificar las siguientes configuraciones mongosh en su archivo de configuración:

Clave	Tipo	predeterminado	Descripción
`browser`	cadena o booleano	Navegador del sistema por defecto	Especifica el navegador al que `mongosh` redirige cuando `MONGODB-OIDC` está activado. Esta opción se ejecuta con el shell del sistema. Establezca `browser` en `false` para deshabilitar la apertura de navegadores por completo.
`disableLogging`	booleano	`false`	Especifica si MongoDB Shell escribe entradas de registro.
`disableSchemaSampling`	booleano	`false`	De forma predeterminada, MongoDB Shell toma muestras del esquema de su base de datos para habilitar sugerencias de autocompletar. Si establece esta configuración en `true`, MongoDB Shell no muestrea el esquema de su base de datos y el autocompletado se comporta como si la colección estuviera vacía.
`displayBatchSize`	entero	20	El número de elementos mostrados por cada iteración de cursor.
`enableTelemetry`	booleano	`true`	Permite enviar datos de seguimiento y diagnóstico anónimos a MongoDB.
`editor`	string	`null`	Designa un editor para utilizar dentro del `mongosh` consola. Anula la `EDITOR` variable de entorno si está configurada.
`forceDisableTelemetry`	booleano	`false`	Solo disponible en el archivo de configuración global. Si es verdadero, los usuarios no pueden habilitar la telemetría manualmente.
`historyLength`	entero	1000	La cantidad de elementos que se almacenarán en el archivo de historial de `mongosh` REPL.
`inspectCompact`	entero o booleano	3	El nivel de elementos internos que `mongosh` genera en una sola línea. Los elementos de matriz cortos también se agrupan en una sola línea. Si se establece en `false`, `mongosh` imprime cada campo en su propia línea.
`inspectDepth`	entero o infinito	6	La profundidad con la que se imprimen los objetos. Al establecer `inspectDepth` en `Infinity` (el objeto JavaScript), se imprimen todos los objetos anidados con toda su profundidad.
`logCompressionEnabled`	booleano	false	Especifica si MongoDB Shell comprime los archivos de registro. Cuando este valor `true` es, MongoDB Shell usa gzip para comprimir los registros. Consulte Habilitar la compresión de registros.
`logLocation`	string	Depende de tu sistema operativo.Consulta "Ver registros del shell".	Directorio donde MongoDB Shell escribe los archivos de registro. Especifique una ruta de archivo absoluta. Consulte "Especificar la ubicación del archivo de registro".
`logMaxFileCount`	entero o infinito	100	Número máximo de archivos de registro que MongoDB Shell conserva. Una vez que MongoDB Shell alcanza el número máximo de archivos de registro, comienza a eliminar los más antiguos hasta que el número sea inferior al umbral.Consulte Modificar el número máximo de archivos de registro.
`logRetentionDays`	entero o infinito	30	Número de días que se conservan los archivos de registro de MongoDB Shell. Si este valor se establece `Infinity` en, los archivos de registro no se eliminan según su antigüedad. Para evitar que el almacenamiento de registros aumente demasiado, especifique siempre al menos un criterio de retención de registros. Consulte Retención de registros.
`logRetentionGB`	flotador o infinito	Sin establecer	Espacio máximo en gigabytes utilizado para los registros de MongoDB Shell. Si el tamaño combinado de los registros de MongoDB Shell supera este valor, los archivos de registro se eliminan comenzando por los más antiguos. Si este valor se define como `Infinity`, las entradas de registro no se eliminan en función del tamaño de almacenamiento. Para evitar que el almacenamiento de registros crezca demasiado, especifica siempre al menos un criterio de retención de registros. Consulta Retención de registros.
`oidcRedirectUri`	string	`http://localhost:27097/redirect`	Especifica una URI donde el proveedor de identidad redirige después de la autenticación. La URI debe coincidir con la configuración del proveedor de identidad. El valor es por defecto `http://localhost:27097/redirect`.
`oidcTrustedEndpoints`	matriz de cadenas	`[]` (matriz vacía)	Especifica una matriz de nombres de host de endpoints de confianza, incluyendo posibles comodines, que no sean Atlas ni `localhost`. Los tokens de acceso se envían a estos endpoints. Configure únicamente endpoints de confianza.
`redactHistory`	string	`remove`	Controla la información que se registra en el historial de comandos `mongosh`. Puedes acceder al historial de comandos `mongosh` con las teclas arriba y abajo o con Ctrl+R desde el shell. Debe ser uno de los siguientes valores: `keep`:Conservar todo el historial. `remove`: Eliminar del historial las líneas que contienen comandos confidenciales. Por ejemplo, `remove` elimina las llamadas a db.auth() o connect(). `remove-redact`:Elimine líneas que contengan comandos confidenciales y redacte cadenas específicas en otras líneas del historial, como rutas de archivos, direcciones de correo electrónico y URL.
`showStackTraces`	booleano	`false`	Controla la visualización de un seguimiento de la pila junto con mensajes de error.
`snippetAutoload`	booleano	`true`	Si `true` es, carga automáticamente los fragmentos instalados al inicio.
`snippetIndexSourceURLs`	string	Repositorio de MongoDB	Una lista separada por punto y coma de direcciones URL que enlazan a un registro de fragmentos.
`snippetRegistryURL`	string	npm Registry	El registro npm utilizado por el `mongosh` cliente npm que instala el fragmento.

Comportamiento con la API de configuración

Configuraciones especificadas con la API de configuración:

Anular las configuraciones especificadas en el archivo de configuración.
Persistente después de reinicios.

Ejemplo

Considera el siguiente archivo de configuración que establece el parámetro inspectDepth en 20:

mongosh:
  inspectDepth: 20

Durante su sesión mongosh, ejecute el siguiente comando para establecer inspectDepth en 10:

config.set( "inspectDepth", 10 )

El valor de inspectDepth se convierte en 10 y seguirá siendo 10 incluso cuando se reinicie mongosh.

Volver

Usar la API

Personalice el prompt