Conectar a partir do shell do MongoDB

Nesta página

Pré-requisitos

Procedimento
Sintaxe de aggregation e sintaxe abreviada

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 Atlas SQL.

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 Atlas SQL oferece suporte a uma sintaxe aggregation 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 MongoDB Shell.

Sintaxe do Aggregation Pipeline Stage

Você pode usar fases do pipeline $sql de agregação para escrever queries no SQL do Atlas. Veja $sql para uma lista de propriedades que você deve fornecer para $sql.

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

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

Observação

O Atlas SQL utiliza o dialeto mongosql.

Sintaxe de formulário curto

Você pode usar uma sintaxe abreviada, db.sql, para fornecer uma declaração Atlas SQL 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