Escrever scripts

Caminhos de arquivo

O método load() aceita caminhos relativos e absolutos. Se o diretório atual de trabalho do MongoDB Shell for /data/db e connect-and-insert.js estiver no diretório /data/db/scripts, então as seguintes chamadas dentro do MongoDB Shell serão equivalentes:

load( "scripts/connect-and-insert.js" )
load( "/data/db/scripts/connect-and-insert.js" )

Exemplo

O exemplo seguinte cria e executa um script que:

• Conecta a uma instância local em execução na porta padrão.

• Conecta-se ao banco de dados myDatabase.

• Preenche a coleção movies com documentos de amostra.

1. Crie um arquivo denominado connect-and-insert.js com o seguinte conteúdo:

   db = connect( 'mongodb://localhost/myDatabase' );
   db.movies.insertMany( [
      {
         title: 'Titanic',
         year: 1997,
         genres: [ 'Drama', 'Romance' ]
      },
      {
         title: 'Spirited Away',
         year: 2001,
         genres: [ 'Animation', 'Adventure', 'Family' ]
      },
      {
         title: 'Casablanca',
         genres: [ 'Drama', 'Romance', 'War' ]
      }
   ] )

2. Para carregar e executar o arquivo connect-and-insert.js, utilize o mongosh para conectar à sua implantação e executar o seguinte comando:

   load( "connect-and-insert.js" )

3. Para confirmar que os documentos carregados corretamente, utilize a coleção myDatabase e faça query da coleção movies.

   use myDatabase
   db.movies.find()

Exemplo

O exemplo a seguir cria scripts e os executa a partir da linha de comando.

• loadMovies.js, utiliza o insertMany() para atualizar uma instância local do MongodDB.

• queryMovies.js utiliza db.collection.find() para verificar a atualização.

1. Copie este script e salve-o como loadMovies.js.

   db = connect( 'mongodb://localhost/films' );
   db.movies.insertMany( [
      {
         title: 'Titanic',
         year: 1997,
         genres: [ 'Drama', 'Romance' ]
      },
      {
         title: 'Spirited Away',
         year: 2001,
         genres: [ 'Animation', 'Adventure', 'Family' ]
      },
      {
         title: 'Casablanca',
         genres: [ 'Drama', 'Romance', 'War' ]
      }
   ] )

   Dica

   Verifique a connection string na linha realçada. Se sua instância do MongoDB não estiver sendo executada em localhost:27017, você deverá editar a connection string.

   Por exemplo, a seguinte connection string se conecta à porta localhost 27500:

   db = connect( 'mongodb://localhost:27500/films' );

2. Copie este script e salve-o como queryMovies.js.

   db = connect( 'mongodb://localhost/films' );
   printjson( db.movies.find( {} ) );

3. Execute os scripts a partir da linha de comando.

   mongosh --file loadMovies.js --file queryMovies.js

4. Verifique a saída.

   Loading file: loadMovies.js
   Loading file: queryMovies.js
   [
      {
         _id: ObjectId("616f1b8092dbee425b661117"),
         title: 'Titanic',
         year: 1997,
         genres: [ 'Drama', 'Romance' ]
      },
      {
         _id: ObjectId("616f1b8092dbee425b661118"),
         title: 'Spirited Away',
         year: 2001,
         genres: [ 'Animation', 'Adventure', 'Family' ]
      },
      {
         _id: ObjectId("616f1b8092dbee425b661119"),
         title: 'Casablanca',
         genres: [ 'Drama', 'Romance', 'War' ]
      }
   ]

   A saída do comando db.collection.find() mostra que a coleção movies foi atualizada.

   Dica

   Para tornar a saída visível, utilize printjson() para chamar db.collection.find().

   printjson( db.movies.find( {} ) ) ;

O script inclui detalhes da conexão

Se os detalhes da conexão forem incluídos no script:

• Você não precisa especificar informações de conexão na linha de comando.

• Você deve utilizar o parâmetro --nodb.

Considere uma instância do mongod executando no localhost:27500.

O script a seguir imprime o número de usuários. Copie o código e guarde-o como getUserCount.js.

db = connect( "localhost:27500/admin" );˘
printjson( db.system.users.countDocuments() );

Execute getUserCount.js:

mongosh --nodb --file getUserCount.js

• mongosh O padrão é a porta 27170.

• mongod está em execução na porta 27500.

• O parâmetro --nodb instrui mongosh a executar um roteiro sem primeiro se conectar a uma instância mongod.

A linha destacada está correta, mas getUserCount.js não será executado sem --nodb porque mongosh não pode se conectar à instância local. Com --nodb, o mongosh executa o getUserCount.js e utiliza as informações destacadas para conectar.

O script não inclui detalhes da conexão

É conveniente especificar as informações de conexão em seu script, mas isso também as torna menos portáteis. O script getUserCount.js teria que ser atualizado para ser executado em uma instância remota ou em uma instância executada em uma porta diferente.

Para aumentar a portabilidade, utilize db.getSiblingDB() e especifique as informações de conexão na linha de comando.

O script a seguir é mais portátil do que getUserCount.js porque não tem detalhes de conexão específicos. Copie o código e guarde-o como portableGetUserCount.js.

db = db.getSiblingDB( "admin" );
printjson( db.system.users.countDocuments() );

Para executar o portableGetUserCount.js, especifique o host e a porta na linha de comando:

mongosh --host 172.17.0.3 --port 27500 --file portableGetUserCount.js

Para executar o portableGetUserCount.js em um host ou porta diferente, altere os detalhes da conexão na linha de comando. Ao contrário de getUserCount.js, você não precisa editar o script para executar portableGetUserCount.js.