Conectar-se a um cluster usando ferramentas de linha de comando
Nesta página
O Atlas fornece instruções para conectar-se a Atlas cluster usando ferramentas de linha de comando selecionadas do MongoDB na aba Command Line Tools.
Para instâncias sem servidor, utilize o MongoDB Tools versão 100.10.0 ou posterior. Para saber mais, consulte Versão mínima das ferramentas do MongoDB para instâncias sem servidor.
Observação
As seções Acesso Necessário na documentação do MongoDB Database Tools fazem referência a roles e privilégios do MongoDB que correspondem a roles, privilégios e ações de privilégio do Atlas.
Acesse a aba Command Line Tools
Para acessar a aba Atlas Command Line Tools:
No Atlas, váGo para a Clusters página do seu projeto.
Se ainda não tiver sido 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 o projeto desejado no menu Projects na barra de navegação.
Se ainda não estiver exibido, clique em Clusters na barra lateral.
A página Clusters é exibida.
Conectar com mongorestore
Observação
Como o Atlas não oferece um role individual de restore, privilégio ou ação de privilégio, você deve ter o role de Atlas admin para usar o mongorestore.
A seção Binary Import and Export Tools da aba Command Line Tools exibe um modelo copiável com as opções mínimas exigidas para conectar o mongorestore ao seu cluster do Atlas. Para obter instruções sobre como encontrar a aba Command Line Tools, consulte Acessar a Aba Command Line Tools.
O modelo inclui valores de espaço reservado para determinadas opções. Você deve substituir estes placeholders pelos valores apropriados para seu Atlas cluster:
<PASSWORD>- substitua isso pela senha do usuário especificada em--username. O modelo inclui um usuário do banco de dados para o projeto como--username. Se quiser se autenticar como um usuário diferente, substitua o valor de--usernamee especifique a senha desse usuário em--password.Se sua senha contiver caracteres especiais, coloque-a entre aspas duplas ou simples. Por exemplo, se sua senha for
@bc123, você deverá colocá-la entre aspas, como"@bc123".
Inclua quaisquer outras opções de linha de comando mongorestore conforme necessário antes de copiar e colar o comando no terminal do sistema e executar o comando completo. Consulte mongorestore para obter a documentação completa sobre as opções de linha de comando disponíveis e como usá-las.
Observação
Conectar a um Atlas cluster a partir do Microsoft Windows
Para usuários no Windows, especifique mongorestore.exe
Talvez seja preciso fornecer o caminho completo do arquivo para o mongorestore.exe.
Conectar com mongodump
A seção Binary Import and Export da aba Command Line Tools exibe um modelo copiável com as opções mínimas exigidas para conectar o mongodump ao seu cluster do Atlas. Para obter instruções sobre como encontrar a aba Command Line Tools, consulte Acessar a Aba Command Line Tools.
O modelo inclui valores de espaço reservado para determinadas opções. Você deve substituir estes placeholders pelos valores apropriados para seu Atlas cluster:
<PASSWORD>- substitua isso pela senha do usuário especificada em--username. O modelo inclui um usuário do banco de dados para o projeto como--username. Se quiser se autenticar como um usuário diferente, substitua o valor de--usernamee especifique a senha desse usuário em--password.Se sua senha contiver caracteres especiais, coloque-a entre aspas duplas ou simples. Por exemplo, se sua senha for
@bc123, você deverá colocá-la entre aspas, como"@bc123".<DATABASE>- substitua isso pelo nome do banco de dados do qual você deseja exportar dados
Inclua quaisquer outras opções de linha de comando mongodump conforme necessário antes de copiar e colar o comando no terminal do sistema e executar o comando completo. Consulte mongodump para obter a documentação completa sobre as opções de linha de comando disponíveis e como usá-las.
Observação
Conectar a um Atlas cluster a partir do Microsoft Windows
Para usuários no Windows, especifique mongodump.exe
Talvez seja preciso fornecer o caminho completo do arquivo para o mongodump.exe.
Conectar com mongoimport
A seção Data Import and Export Tools da aba Command Line Tools exibe um modelo copiável com as opções mínimas exigidas para conectar o mongoimport ao seu cluster do Atlas. Para obter instruções sobre como encontrar a aba Command Line Tools, consulte Acessar a Aba Command Line Tools.
O modelo inclui valores de espaço reservado para determinadas opções. Você deve substituir estes placeholders pelos valores apropriados para seu Atlas cluster:
<PASSWORD>- substitua isso pela senha do usuário especificada em--username. O modelo inclui um usuário do banco de dados para o projeto como--username. Se quiser se autenticar como um usuário diferente, substitua o valor de--usernamee especifique a senha desse usuário em--password.Se sua senha contiver caracteres especiais, coloque-a entre aspas duplas ou simples. Por exemplo, se sua senha for
@bc123, você deverá colocá-la entre aspas, como"@bc123".<DATABASE>- o nome do banco de dados para o qual você deseja importar os dados.<COLLECTION>- o nome da collection para a qual você deseja importar os dados.<FILETYPE>- o tipo de arquivo da fonte de dados da qual você está importando dados. Consulte --type para obter mais informações.<FILENAME>- o nome da fonte de dados da qual você está importando dados. Consulte - -file para obter mais informações.
Inclua quaisquer outras opções de linha de comando mongoimport conforme necessário antes de copiar e colar o comando no terminal do sistema e executar o comando completo. Consulte mongoimport para obter a documentação completa sobre as opções de linha de comando disponíveis e como usá-las.
Observação
Conectar a um Atlas cluster a partir do Microsoft Windows
Para usuários no Windows, especifique mongoimport.exe
Talvez seja preciso fornecer o caminho completo do arquivo para o mongoimport.exe.
Conectar com mongoexport
A seção Data Import and Export Tools da aba Command Line Tools exibe um modelo copiável com as opções mínimas exigidas para conectar o mongoexport ao seu cluster do Atlas. Para obter instruções sobre como encontrar a aba Command Line Tools, consulte Acessar a Aba Command Line Tools.
O modelo inclui valores de espaço reservado para determinadas opções. Você deve substituir estes placeholders pelos valores apropriados para seu Atlas cluster:
<PASSWORD>- substitua isso pela senha do usuário especificada em--username. O modelo inclui um usuário do banco de dados para o projeto como--username. Se quiser se autenticar como um usuário diferente, substitua o valor de--usernamee especifique a senha desse usuário em--password.Se sua senha contiver caracteres especiais, coloque-a entre aspas duplas ou simples. Por exemplo, se sua senha for
@bc123, você deverá colocá-la entre aspas, como"@bc123".<DATABASE>- o nome do banco de dados do qual você deseja exportar os dados.<COLLECTION>- o nome da collection da qual você deseja exportar os dados.<FILETYPE>- o tipo de arquivo da fonte de dados para a qual você está exportando os dados. Consulte --type para obter mais informações.<FILENAME>- o nome da fonte de dados para a qual você está exportando os dados. Consulte --file para obter mais informações.
Inclua quaisquer outras opções de linha de comando mongoexport conforme necessário antes de copiar e colar o comando no terminal do sistema e executar o comando completo. Consulte mongoexport para obter a documentação completa sobre as opções de linha de comando disponíveis e como usá-las.
Observação
Conectar a um Atlas cluster a partir do Microsoft Windows
Para usuários no Windows, especifique mongoexport.exe
Talvez seja preciso fornecer o caminho completo do arquivo para o mongoexport.exe.
Conectar com mongostat
A seção Set Up Diagnostics da aba Command Line Tools exibe um modelo copiável com as opções mínimas exigidas para conectar o mongostat ao seu cluster do Atlas. Para obter instruções sobre como encontrar a aba Command Line Tools, consulte Acessar a Aba Command Line Tools.
O modelo inclui valores de espaço reservado para determinadas opções. Você deve substituir estes placeholders pelos valores apropriados para seu Atlas cluster:
<PASSWORD>- substitua isso pela senha do usuário especificada em--username. O modelo inclui um usuário do banco de dados para o projeto como--username. Se quiser se autenticar como um usuário diferente, substitua o valor de--usernamee especifique a senha desse usuário em--password.Se sua senha contiver caracteres especiais, coloque-a entre aspas duplas ou simples. Por exemplo, se sua senha for
@bc123, você deverá colocá-la entre aspas, como"@bc123".
Inclua quaisquer outras opções de linha de comando mongostat conforme necessário antes de copiar e colar o comando no terminal do sistema e executar o comando completo. Consulte mongostat para obter a documentação completa sobre as opções de linha de comando disponíveis e como usá-las.
Observação
Conectar a um Atlas cluster a partir do Microsoft Windows
Para usuários no Windows, especifique mongostat.exe
Talvez seja preciso fornecer o caminho completo do arquivo para o mongostat.exe.
Conectar com mongotop
A seção Set Up Diagnostics da aba Command Line Tools exibe um modelo copiável com as opções mínimas exigidas para conectar o mongotop ao seu cluster do Atlas. Para obter instruções sobre como encontrar a aba Command Line Tools, consulte Acessar a Aba Command Line Tools.
O modelo inclui valores de espaço reservado para determinadas opções. Você deve substituir estes placeholders pelos valores apropriados para seu Atlas cluster:
<PASSWORD>- substitua isso pela senha do usuário especificada em--username. O modelo inclui um usuário do banco de dados para o projeto como--username. Se quiser se autenticar como um usuário diferente, substitua o valor de--usernamee especifique a senha desse usuário em--password.Se sua senha contiver caracteres especiais, coloque-a entre aspas duplas ou simples. Por exemplo, se sua senha for
@bc123, você deverá colocá-la entre aspas, como"@bc123".
Inclua quaisquer outras opções de linha de comando mongotop conforme necessário antes de copiar e colar o comando no terminal do sistema e executar o comando completo. Consulte mongotop para obter a documentação completa sobre as opções de linha de comando disponíveis e como usá-las.
Observação
Conectar a um Atlas cluster a partir do Microsoft Windows
Para usuários no Windows, especifique mongotop.exe
Talvez seja preciso fornecer o caminho completo do arquivo para o mongotop.exe.
Solução de problemas
Se você estiver enfrentando problemas para se conectar ao seu cluster, consulte Solucionar problemas de conexão.