/ /

Administración

Docs Home

Desarrollo

Comandos de base de datos

Administración

Docs Home

Desarrollo

Comandos de base de datos

Administración

getParameter (comando de base de datos)

Definición

getParameter: getParameter es un comando administrativo para recuperar los valores de los parámetros. Utilice el db.adminCommand( { command } ) Método para ejecutar el comando en getParameter la admin base de datos.

Compatibilidad

Este comando está disponible en implementaciones alojadas en los siguientes entornos:

MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Importante

Este comando tiene soporte limitado en los clústeres Flex y M0. Para obtener más información, consulta Comandos no compatibles.

MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Sintaxis

El comando tiene la siguiente sintaxis:

db.adminCommand(
   {
     getParameter: <value>,
     <parameter> : <value>,
     comment: <any>
   }
)

Campos de comandos

El comando toma los siguientes campos:

Campo	Tipo	Descripción
`getParameter`	int, cadena, documento	Especifique un valor de: `1` (o cualquier valor entero) para devolver el valor del `<parameter>` especificado. `''` para devolver valores para todos los parámetros disponibles para, ignorando `getParameter` el `<parameter>` campo. `{ showDetails: true }` para devolver un documento que contiene: `value`, el valor que se establece en `<parameter>` `settableAtRuntime`, tanto si `<parameter>` puede o no establecerse en tiempo de ejecución `settableAtStartup`, si se puede configurar o no `<parameter>` al inicio `{ showDetails: true, allParameters: true }` para devolver un documento que contenga campos showDetails para todos los* parámetros. `{ allParameters: true }` para devolver un documento que contenga todos los parámetros. `{ allParameters: true, setAt: "startup" }` para devolver un documento que contenga todos los parámetros que puede configurar al inicio. Nuevo en la versión 8.0. `{ allParameters: true, setAt: "runtime" }` para devolver un documento que contenga todos los parámetros que puede configurar en tiempo de ejecución. Nuevo en la versión 8.0.
`<parameter>`	string	Nombre de cadena del parámetro a recuperar. El valor de `<value>` no afecta la salida.
`comment`	any	Opcional. Un comentario proporcionado por el usuario para adjuntar a este comando. Una vez configurado, este comentario aparece junto a los registros de este comando en las siguientes ubicaciones: Mensajes de registro de mongod, en el campo `attr.command.cursor.comment`. Salida del perfilador de base de datos, en el campo `command.comment`. `currentOp` de salida, en el campo `command.comment`. Un comentario puede ser de cualquier tipo BSON válido (string, objeto, arreglo, etc.).

Comportamiento

getParameter se ejecuta solo en la admin base de datos y devuelve un error si se ejecuta en cualquier otra base de datos.

El valor posible de <parameter> puede variar según la versión y el motor de almacenamiento utilizados.Consulte "Recuperar todos los parámetros" para ver un ejemplo de la lista de parámetros disponibles.

Ejemplos

Retrieve Single Parameter

La siguiente operación ejecuta en getParameter la admin base de datos utilizando un valor de saslHostName para recuperar el valor de ese parámetro:

db.adminCommand( { getParameter : 1, "saslHostName" : 1 } )

El comando devuelve la siguiente salida:

Nota

La salida puede variar según la versión y la configuración específica de su instancia de MongoDB.

{ "saslHostName" : "www.example.net:27018", "ok" : 1 }

Retrieve All Parameters

La siguiente operación ejecuta con un valor getParameter de '*' para recuperar todos los parámetros:

db.adminCommand( { getParameter : '*' } )

Nota

La salida puede variar según la versión de MongoDB y la configuración específica de la instancia de MongoDB en ejecución.

Tip

setParameter para obtener más información sobre estos parámetros.

Detalles del informe sobre un único parámetro

El siguiente ejemplo ejecuta getParameter con {showDetails: true} para informar detalles saslHostNamesobre.

db.adminCommand( { getParameter : { showDetails: true }, "saslHostName" : 1 } )

Ejemplo de salida:

{
  saslHostName: {
    value: '<hostname>',
    settableAtRuntime: false,
    settableAtStartup: true
  },
  ok: 1
}

Nota

La salida puede variar según la versión y la configuración específica de su instancia de MongoDB.

Detalles del informe para todos los parámetros

El siguiente ejemplo ejecuta getParameter con {showDetails: true, allParameters: true} para informar detalles sobre todos los parámetros.

db.adminCommand( { getParameter : { showDetails: true, allParameters: true } } )

Retrieve All Startup Parameters

Nuevo en la versión 8.0.

El siguiente ejemplo ejecuta el comando para recuperar todos los parámetros de getParameter inicio:

db.adminCommand( {
   getParameters: {
      allParameters: true,
      setAt: "startup"
   }
} )

Retrieve All Runtime Parameters

Nuevo en la versión 8.0.

El siguiente ejemplo ejecuta el comando getParameter para recuperar todos los parámetros de ejecución:

db.adminCommand( {
   getParameters: {
      allParameters: true,
      setAt: "runtime"
   }
} )

Volver

getDefaultRWConcern

killCursors