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, seleccione la organización que contiene su proyecto en 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.

Instale MongoDB Shell si aún no lo ha hecho.

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 el 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.
Seleccione mongosh del 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 está conectado a su instancia de base de datos federada, utilizando 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 abreviada

MongoSQL admite una sintaxis de etapa de canalización de agregación y una sintaxis abreviada para construir consultas SQL. Puede usar cualquiera de estas sintaxis para escribir consultas en MongoDB Shell.

Sintaxis de la etapa de canalización 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

Puede utilizar una sintaxis abreviada, db.sql, para proporcionar una declaració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