Conectar a partir do shell do MongoDB

Esta página descreve como se conectar a uma instância do banco de dados federado por meio do MongoDB Shell (mongosh).

Pré-requisitos

Uma instância do banco de dados federado que é mapeada para um ou mais armazenamentos de dados.
Observação
Se alguns ou todos os seus dados vierem de um Atlas cluster, você deverá usar o MongoDB versão 5.0 ou superior para que esse cluster aproveite o MongoSQL.

Procedimento

No Atlas, acesse sua instância de banco de dados federado para seu projeto.

Se ainda não estiver exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.
Na barra lateral, clique em Data Federation sob o título Services.

A página Data Federation é exibida.

Clique em Connect para abrir o modal de conexão da instância do banco de dados federado.

Selecione Shell.

Instale o MongoDB Shell, caso ainda não tenha feito isso.

Se você não tiver o MongoDB Shell instalado:

Selecione I do not have the MongoDB Shell installed dentro do modal de conexão.
Selecione seu sistema operacional no menu suspenso do modal.
Siga as instruções de instalação do seu sistema operacional fornecidas no modal.
(Opcional) Confirme que sua instalação do mongosh foi bem-sucedida.
Para verificar se a instalação foi bem-sucedida, execute em seu terminal:
```
mongosh --version
```
Se a instalação tiver sido bem-sucedida, o mongosh exibirá uma versão.

Se você já tem o MongoDB Shell instalado:

Selecione I have the MongoDB Shell installed dentro do modal de conexão.
Selecione mongosh no menu suspenso do modal.
Observação
O MongoDB Shell, ou mongosh, é separado das versões mongo no menu suspenso modal.
Se deseja confirmar que tem o mongosh instalado, no seu terminal, execute:
```
mongosh --version
```
Se o mongosh estiver instalado, será exibida a versão.

Selecione seu método de autenticação.

Seu método de autenticação depende de como seu acesso ao banco de dados está configurado. Para saber mais sobre o acesso ao banco de dados, consulte Configurar usuários do banco de dados.

Você pode escolher:

Password (SCRAM), ou
X.509.

O Atlas Data Federation fornece uma cadeia de conexão para o método de autenticação.

Copie e execute a cadeia de conexão.

Se você selecionou o método de autenticação Password (SCRAM), será solicitada uma senha para o usuário que está se conectando.

(Opcional) Confirme a conexão com sua instância do banco de dados federado.

Para confirmar que você está conectado à sua instância do banco de dados federado, utilizando o mongosh, execute:

show dbs

Se você se conectou com êxito à instância do banco de dados federado mapeada para um armazenamento de dados, o mongosh exibirá os nomes dos bancos de dados virtuais.

Sintaxe de aggregation e sintaxe abreviada

O MongoSQL oferece suporte a uma sintaxe agregação pipeline stages e a uma sintaxe de formato curto para a construção de queries SQL. Você pode usar qualquer um desses sintaxes para escrever queries no shell do MongoDB .

Sintaxe do Aggregation Pipeline Stage

Você pode usar o pipeline de agregação $sql para escrever queries MongoSQL. Consulte $sql para uma lista de propriedades que você deve fornecer ao $sql.

O seguinte exemplo utiliza a sintaxe $sql para executar a declaração MongoSQL select * from Users limit 2:

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

Observação

O MongoSQL utiliza o dialeto mongosql.

Sintaxe de formulário curto

Você pode usar uma sintaxe abreviada, db.sql, para fornecer uma declaração MongoSQL diretamente.

Importante

A sintaxe de forma curta não é estável e pode mudar no futuro.

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

Voltar

Conecte

Driver do JDBC