Conectar desde la MongoDB Shell

Esta página describe cómo conectarse a una instancia federada de base de datos mediante el MongoDB Shell (mongosh).

Requisitos previos

Una instancia federada de base de datos que está mapeada a uno o más almacenes de datos.
Nota
Si algunos o todos tus datos provienen de un clúster Atlas, debes utilizar MongoDB versión 5.0 o superior para ese clúster para aprovechar MongoSQL.

Procedimiento

En Atlas, ve a tu instancia federada de base de datos para tu proyecto.

Si aún no se muestra, selecciona la organización que contiene tu proyecto de la Organizations menú en la barra de navegación.
Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Data Federation en la sección Services.

Se muestra la página Data Federation.

Haz clic en Connect para abrir el modal de conexión de instancia federada de base de datos.

Seleccione Shell.

Instala el MongoDB Shell si no lo has hecho aún.

Si no tienes el MongoDB Shell instalado:

Selecciona I do not have the MongoDB Shell installed dentro del modal de conexión.
Selecciona tu sistema operativo desde el menú desplegable modal.
Siga las instrucciones de instalación para su sistema operativo proporcionadas en la ventana modal.
(Opcional) Confirme que su instalación de mongosh fue exitosa.
Para comprobar que la instalación fue exitosa, en la terminal, ejecuta:
```
mongosh --version
```
Si la instalación fue exitosa, mongosh muestra una versión.

Si ya tienes instalado el MongoDB Shell:

Selecciona I have the MongoDB Shell installed dentro del modal de conexión.
Selecciona mongosh en el menú desplegable modal.
Nota
MongoDB Shell, o mongosh, es independiente de las versiones mongo en el menú desplegable modal.
Si quieres asegurarte de que tienes mongosh instalado, ejecuta en tu terminal:
```
mongosh --version
```
Si mongosh está instalado, muestra una versión.

Selecciona tu método de autenticación.

Tu método de autenticación depende de cómo esté configurado el acceso a tu base de datos. Para obtener más información sobre el acceso a la base de datos, consulta Configurar usuarios de base de datos.

Puedes elegir:

Password (SCRAM), o
X.509.

Atlas Data Federation proporciona una cadena de conexión para tu método de autenticación.

Copia y ejecuta tu cadena de conexión.

Si seleccionó el método de autenticación Password (SCRAM), se le pedirá una contraseña para el usuario que se conecta.

(Opcional) Confirma la conexión a tu instancia federada de base de datos.

Para confirmar que se conectó a su instancia de base de datos federada, con mongosh, ejecute:

show dbs

Si te conectaste correctamente a tu instancia de base de datos federada que está asignada a un almacén de datos, mongosh muestra los nombres de tus bases de datos virtuales.

Sintaxis de agregación y sintaxis de forma corta

MongoSQL admite una sintaxis de etapas del pipeline de agregación y una sintaxis abreviada para construir consultas SQL. Puedes utilizar cualquiera de estas sintaxis para escribir queries en la MongoDB Shell.

Sintaxis de etapas del pipeline de agregación

Puedes utilizar las $sql etapas del pipeline de agregación para redactar consultas MongoSQL. Consulta $sql para obtener una lista de propiedades que debes proporcionar a $sql.

El siguiente ejemplo utiliza la sintaxis $sql para ejecutar la instrucción MongoSQL select * from Users limit 2:

db.aggregate( [ {
    $sql: {
       statement: "SELECT *
                   FROM users
                   LIMIT 2",
       format: "jdbc",
       dialect: "mongosql"
   }
} ] )

Nota

MongoSQL utiliza el dialecto mongosql.

Sintaxis corta

Puedes utilizar una sintaxis de formulario corto, db.sql, para proporcionar una instrucción MongoSQL directamente.

Importante

La sintaxis de forma breve no es estable y puede cambiar en el futuro.

db.sql(`
  SELECT *
  FROM users
  LIMIT 2
`);

Volver

Nodo privado

Registro de cambios