/ /

Ajustes de archivos de configuración

MongoDB Compass Readonly Edition quedará obsoleto en una próxima versión. Para replicar el comportamiento de solo lectura en una edición estándar de Compass, asigna a los usuarios read acceso al nivel de base de datos y activar el Opción readOnly en Compass.

Puedes usar un archivo de configuración para personalizar los ajustes de MongoDB Compass al iniciar. No puedes modificar ningún ajuste establecido con un archivo de configuración en la interfaz de Compass.

Ubicación del archivo de configuración

Para macOS y Linux, el archivo de configuración está ubicado en /etc/mongodb-compass.conf.

Para Windows, el archivo de configuración se encuentra en la carpeta principal de tu ejecutable Compass. Considere los siguientes ejemplos según el instalador que haya usado:

Si instaló Compass como un archivo .exe y su instalación de Compass se encuentra en C:\Users\Administrator\AppData\Local\MongoDBCompass\app-1.47.1\MongoDBCompass, el archivo de configuración se encuentra en C:\Users\Administrator\AppData\Local\MongoDBCompass\app-1.47.1\mongodb-compass.cfg.
Nota
Para las instalaciones que utilizan el instalador .exe, las rutas ejecutables y de archivos de configuración de MongoDB Compass incluyen el número de versión.
Si instalaste Compass como un archivo .msi y tu instalación de Compass está ubicada en C:\Program Files\MongoDB Compass, el archivo de configuración estaría ubicado en C:\Program Files\mongodb-compass.cfg.
Si has instalado Compass como un archivo .zip, el archivo de configuración está ubicado en la carpeta principal donde descomprimiste Compass.

Sintaxis

Puedes configurar los ajustes del archivo de configuración de Compass en formato EJSON o YAML.

EJSON

{
  "setting": value,
  "setting": value,
  ...
}

YAML

setting option: value
setting option: value
...

Configuraciones

Configuración

Definición

autoUpdates

Permitir que Compass verifique periódicamente si hay nuevas actualizaciones.

enableGenAIFeatures

Permitir que Compass use IA generativa para consultas de lenguaje natural.

enableGenAISampleDocumentPassing

Permite que MongoDB Compass envíe valores de campo de muestra con solicitudes de generación de consultas y agregaciones. Estos valores pueden mejorar los resultados de la IA.

Si true, esta configuración establece implícitamente la configuración enableGenAIFeatures en true.

enableDevTools

Habilitar Chrome DevTools en Compass.

Para obtener más información, consulta Activar herramientas de desarrollo de Chrome.

enableMaps

Permitir que Compass haga solicitudes a servicios de mapeo de terceros.

habilitarShell

Activa o desactiva la Shell de MongoDB integrada en Compass.

Para obtener más información, consulta Desactivar la Embedded MongoDB Shell.

forceConnectionOptions

Asigne valores de opción de conexión para cuando se conecte a su implementación de MongoDB a través de Compass. Estas opciones de conexión no pueden ser anuladas por conexiones desde la interfaz de Compass o por una cadena de conexión en la línea de comandos.

ignoreAdditionalCommandLineFlags

Permitir o no permitir banderas de opciones adicionales de línea de comandos.

installURLHandlers

Registre Compass como gestor de URLs mongodb:// y mongodb+srv://.

Si Install Compass as URL Protocol Handler está habilitada, puedes abrir Compass navegando a una URL de mongodb:// o mongodb+srv:// en tu navegador de internet.

Disponible en macOS y Windows.

maxTimeMS

Especifica un límite de tiempo superior para todas las operaciones de la base de datos de Compass.

Tráfico de red

Evita que MongoDB Compass realice operaciones de red salientes que no sean las que se dirigen a la base de datos.

protectConnectionStrings

Establece todas las cadenas de conexión como de solo lectura. Las contraseñas en las cadenas de conexión se muestran como *****.

Si protectConnectionStrings está habilitado, Compass desactiva la opción Edit connection string y oculta el botón Edit connection string.

protectConnectionStringsForNewConnections

Configura las cadenas de conexión para nuevas conexiones como de solo lectura de forma predeterminada. Las contraseñas en nuevas cadenas de conexión se muestran como *****.

Si se activa protectConnctionStringsForNewConnections, Compass desactiva la opción Edit connection string, pero no impide que los usuarios activen manualmente la opción con el interruptor Edit connection string.

proxy

Permite especificar o aplicar el uso de un proxy para conectarse a su implementación. Para obtener más información sobre cómo conectarse a su implementación con un proxy, consulte la pestaña Conexión de Proxy/Túnel SSH.

Debes pasar una URL o el siguiente formato:

{
  "proxy": "string",
  "noProxyHosts": "string"
}

Si establece proxy en una string vacía, Compass no utiliza un proxy.

Solo lectura

Evita que los usuarios realicen operaciones de guardar en tu implementación de MongoDB a través de Compass.

Para obtener más información, consulta Restringir las operaciones de escritura a MongoDB.

showKerberosPasswordField

Mostrar u ocultar el campo de contraseña de Kerberos en el formulario de conexión de Compass.

Para obtener más información, consulta Mostrar el campo de contraseña de Kerberos.

tema

Especifica el tema de la interfaz de usuario de MongoDB Compass. Los temas soportados son DARK, LIGHT y OS_THEME.

trackUsageStatistics

Permitir que Compass envíe estadísticas de uso anónimas.

Para obtener más información, consulte Configurar opciones de telemetría.

Nota

Para ver todas las opciones de configuración de Compass disponibles, ejecuta el siguiente comando en la carpeta que contiene el archivo ejecutable de MongoDB Compass:

<path-to-Compass-executable> --help

Ejemplo

Para ver un archivo de configuración de Compass de muestra, ejecuta el siguiente comando:

<path-to-Compass-executable> --show-example-config

Si no tienes ya un archivo de configuración, ejecuta el siguiente comando para crear un archivo de configuración que utilice la configuración de muestra:

<path-to-Compass-executable> --show-example-config > /etc/mongodb-compass.conf

Obtén más información

Volver

Opciones de línea de comandos

Bloquear las conexiones salientes