/ /

Conectarse desde MongoDB Shell

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

Requisitos previos

Una instancia de base de datos federada que está asignada a uno o más almacenes de datos.
Nota
Si algunos o todos sus datos provienen de un clúster Atlas, debe usar la versión 5.0 o superior de MongoDB para que ese clúster aproveche MongoSQL.

Procedimiento

En Atlas, vaya a la instancia de base de datos federada para su 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 Federación de datos.

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

Seleccione Shell.

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

Si no tiene instalado MongoDB Shell:

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

Si ya tienes instalado MongoDB Shell:

Seleccione 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 desea asegurarse de tener mongosh instalado, en su terminal ejecute:
```
mongosh --version
```
Si mongosh está instalado, se muestra una versión.

Seleccione su método de autenticación.

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

Puedes elegir:

Password (SCRAM), o
X.509.

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

Copie y ejecute su cadena de conexión.

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

(Opcional) Confirme la conexión a su instancia de base de datos federada.

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

Puede usar la etapa $sql de canalización de agregación para escribir consultas MongoSQL. Consulte $sql para obtener una lista de las propiedades que debe proporcionar $sql a.

El siguiente ejemplo utiliza la sintaxis $sql para ejecutar la declaració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

Conectar

Controlador JDBC