/ /

Configuración del archivo de configuración

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 se encuentra 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 instaló Compass como un archivo .msi y su 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

Puede 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 es 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.

habilitar mapas

Permitir que Compass realice solicitudes a servicios de mapas 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

Asignar Valores de las opcionesde conexión para la conexión a su implementación de MongoDB mediante Compass. Estas opciones de conexión no pueden ser anuladas por conexiones desde la interfaz de Compass ni por una cadena de conexión de línea de comandos.

ignoreAdditionalCommandLineFlags

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

installURLHandlers

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

Si Install Compass as URL Protocol Handler está habilitado, puede abrir Compass navegando a una URL mongodb:// o mongodb+srv:// en su 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 forzar 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, consulte Restringir operaciones de escritura en MongoDB.

showKerberosPasswordField

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

Para obtener más información, consulte 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, ejecute 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 conexiones salientes