/ /

Configurar los ajustes

Docs Home

/ /

Configurar

Configurar los ajustes

Configurar los ajustes

Configura los ajustes mediante un archivo de configuración

Puedes especificar mongosh configuraciones en un archivo de configuración global. Al especificar la configuración en un archivo de configuración, se aplican al inicio. Después de crear un archivo de configuración, la configuración del archivo entra en vigor la próxima vez que inicies mongosh.

Formato de archivo de configuración

El archivo de configuración mongosh utiliza el formato YAML. Todas las opciones están bajo el espacio de nombres mongosh.

Archivo de configuración de ejemplo

El siguiente archivo de configuración establece:

displayBatchSize para 50
inspectDepth para 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 según el orden en que aparecen: `/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 revisan los directorios restantes en la lista y se ignoran los archivos de configuración en esos directorios.
Linux	`/etc/mongosh.conf`

Configuraciones configurables

Puedes especificar las siguientes configuraciones de mongosh en tu archivo de configuración:

Clave	Tipo	predeterminado	Descripción
`browser`	string 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. Establece `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`	Por defecto, MongoDB Shell muestra una muestra de tu esquema de base de datos para activar sugerencias de autocompletado. Si ajustas esta configuración a `true`, el MongoDB Shell no muestra una muestra de tu esquema de base de datos y la función de autocompletar 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 el envío de datos de seguimiento y diagnóstico anonimizados a MongoDB.
`editor`	string	`null`	Designa un editor para utilizar dentro del `mongosh` consola. Anula la variable de entorno `EDITOR` si está configurada.
`forceDisableTelemetry`	booleano	`false`	Solo disponible en el archivo de configuración global. Cuando esto es verdadero, los usuarios no pueden habilitar la telemetría manualmente.
`historyLength`	entero	1000	La cantidad de ítems a almacenar en el archivo de historial `mongosh` REPL.
`inspectCompact`	entero o booleano	3	El nivel de elementos internos que `mongosh` muestra en una sola línea. Los elementos de arreglos 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 a la que se imprimen los objetos. Al establecer `inspectDepth` en `Infinity` (el objeto de javascript), se imprimen todos los objetos anidados en su máxima profundidad.
`logCompressionEnabled`	booleano	false	Especifica si MongoDB Shell comprime los archivos de registro. Cuando este valor es `true`, MongoDB Shell utiliza gzip para comprimir los registros. Consulte Activar la compresión de registros.
`logLocation`	string	Depende de tu sistema operativo. Consulta Ver registros del shell.	Directorio donde MongoDB Shell guarda las entradas de registro. Especifica una ruta de archivo absoluta. Consultar Especificar entrada de registro.
`logMaxFileCount`	entero o Infinito	100	Número máximo de entradas de registro que retiene MongoDB Shell. Después de que el MongoDB Shell alcanza el número máximo de entradas de registro, comienza a borrar las entradas de registro más antiguas hasta que el número esté por debajo del umbral. Consulta Modificar el máximo de entrada de registro.
`logRetentionDays`	entero o Infinito	30	Número de días que se conservan las entradas de registro de MongoDB Shell. Si este valor se establece en `Infinity`, las entradas de registro no se borran según la antigüedad. Para evitar que el almacenamiento de registros crezca demasiado, siempre debes especificar al menos un criterio de retención de registros. Consulte Retención de registros.
`logRetentionGB`	float o infinito	Sin establecer	Cantidad máxima de espacio en gigabytes que se utiliza para los registros de MongoDB Shell. Si el tamaño combinado de los registros de MongoDB Shell supera este valor, las entradas de registro se borran comenzando por los registros 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`	Arreglo de cadenas	`[]` (arreglo vacío)	Especifica un arreglo de nombres de host de punto final confiables, incluidos posibles comodines, que no son Atlas ni `localhost`. Los tokens de acceso se envían a estos endpoints. Configura únicamente los endpoints en los que confíes.
`redactHistory`	string	`remove`	Controla la información registrada en el historial de comandos de `mongosh`. Puedes acceder al historial de comandos `mongosh` mediante las teclas arriba y abajo o Ctrl+R mientras estés dentro del shell. Debe ser uno de los siguientes valores: `keep`: Conservar todo el historial. `remove`: Remueve las líneas que contienen comandos sensibles del historial. Por ejemplo, `remove` remueve las llamadas a db.auth() o connect(). `remove-redact`: remover las líneas que contienen comandos sensibles y elimina 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 una traza de pila junto con los mensajes de error.
`snippetAutoload`	booleano	`true`	Si `true`, carga automáticamente los fragmentos instalados al inicio.
`snippetIndexSourceURLs`	string	Repositorio de MongoDB	Una lista de URLs separadas por punto y coma que enlazan con un registro de snippet.
`snippetRegistryURL`	string	npm Registry	El npm registro que utiliza el `mongosh` npm cliente que instala el snippet.

Comportamiento con la API de configuración

Configuraciones especificadas con la API de configuración:

Override los ajustes especificados 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 tu sesión de mongosh ejecutas el siguiente comando para establecer inspectDepth en 10:

config.set( "inspectDepth", 10 )

El valor de inspectDepth se convierte en 10, y permanecerá 10 incluso cuando mongosh se reinicie.

Volver

Usar la API

Personalice el prompt