PouchDB - Replicação

Um dos recursos mais importantes do PouchDB é a replicação, ou seja, você pode fazer uma cópia de um banco de dados. Você pode replicar uma instância do PouchDB armazenada localmente ou uma instância do CouchDB armazenada remotamente.

Sintaxe

A seguir está a sintaxe de replicação de um banco de dados no PouchDB. Aqui, uma cópia dosource databaseé o alvo. Para este método, você pode passar diretamente a localização dos bancos de dados de origem e destino no formato String ou pode passar objetos que os representam.

PouchDB.replicate(source, target, [options])

Tanto a origem quanto os destinos podem ser instâncias do PouchDB ou instâncias do CouchDB.

Replicando LocalDB para CouchDB

Suponha que haja um banco de dados com o nome sample_database no PouchDB, e contém 3 documentos doc1, doc2 e doc3, tendo o conteúdo mostrado abaixo.

doc1 = {_id: '001', name: 'Ram', age: 23, Designation: 'Programmer'} 
doc2 = {_id: '002', name: 'Robert', age: 24, Designation: 'Programmer'} 
doc3 = {_id: '003', name: 'Rahim', age: 25, Designation: 'Programmer'}

A seguir está um exemplo que faz uma cópia do banco de dados chamado sample_database que é armazenado localmente no CouchDB.

//Requiring the package 
var PouchDB = require('PouchDB');

var localdb = 'sample_database';

//Creating remote database object 
var remotedb = 'http://localhost:5984/sample_database';

//Replicating a local database to Remote 
PouchDB.replicate(localDB, remoteDB); 
console.log ("Database replicated successfully");

Salve o código acima em um arquivo com o nome Replication_example.js. Abra o prompt de comando e execute o arquivo JavaScript usandonode como mostrado abaixo.

C:\PouchDB_Examples >node Replication_example.js

Isso faz uma cópia do banco de dados denominado sample_database na instância do CouchDB e exibe uma mensagem no console conforme mostrado abaixo.

Database replicated successfully

Você pode verificar se o banco de dados é replicado em sua instância do CouchDB clicando no seguinte link http://127.0.0.1:5984/_utils/index.html.

Ao clicar, você pode ver a lista de bancos de dados em seu CouchDB. Você também pode observar que uma cópia do banco de dadossample_database é criado aqui.

Se você selecionar o banco de dados replicado, poderá visualizar seu conteúdo conforme mostrado abaixo.

Replicando CouchDB para PouchDB

Suponha que haja um banco de dados com o nome Remote_Database no CouchDB e contém 3 documentos, doc1, doc2 e doc3, tendo o conteúdo mostrado abaixo.

doc1 = {_id: '001', name: 'Geeta', age: 25, Designation: 'Programmer'}
doc2 = {_id: '002', name: 'Zara Ali', age: 24, Designation: 'Manager'}
doc3 = {_id: '003', name: 'Mary', age: 23, Designation: 'Admin'}

A seguir está um exemplo que faz uma cópia do banco de dados chamado Remote_Database que é armazenado em CouchDB no armazenamento local.

//Requiring the package
var PouchDB = require('PouchDB');

var localdb = 'sample_database';

var remotedb = 'http://localhost:5984/sample_database1';

//Replicating a local database to Remote
PouchDB.replicate(remotedb, localdb);
console.log("Database replicated successfully");

Salve o código acima em um arquivo com o nome Replication_example2.js. Abra o prompt de comando e execute o arquivo JavaScript usandonode como mostrado abaixo.

C:\PouchDB_Examples >node Replication_example2.js

Isso faz uma cópia do banco de dados chamado remote_database na instância PouchDB e exibe uma mensagem no console conforme mostrado abaixo.

Database replicated successfully

Você pode verificar se o banco de dados é replicado em sua instância do Pouch executando o código a seguir.

//Requiring the package
var PouchDB = require('PouchDB');

//Creating the database object
var db = new PouchDB('remote_database');

//Retrieving all the documents in PouchDB
db.allDocs({include_docs: true, attachments: true}, function(err, docs) {
   if (err) {
      return console.log(err);
   } else {
      console.log(docs.rows);
   }
});

Se o banco de dados for replicado ao executar o código acima, você obterá o conteúdo do banco de dados replicado conforme mostrado abaixo.

[ 
   { 
      id: '001', 
      key: '001', 
      value: { rev: '1-23cf3767e32a682c247053b16caecedb' }, 
      doc: { 
         name: 'Geeta', 
         age: 25, 
         Designation: 'Programmer', 
         _id: '001',
         _rev: '1-23cf3767e32a682c247053b16caecedb' 
      } 
   }, 
   { 
      id: '002', 
      key: '002', 
      value: { rev: '1-d5bcfafbd4d4fae92fd7fc4fdcaa3a79' }, 
      doc: { 
         name: 'Zara Ali', 
         age: 24, 
         Designation: 'Manager', 
         _id: '002',
         _rev: '1-d5bcfafbd4d4fae92fd7fc4fdcaa3a79' 
      } 
   }, 
   { 
      id: '003', 
      key: '003', 
      value: { rev: '1-c4cce025dbd30d21e40882d41842d5a4' }, 
      doc: { 
         name: 'Mary', 
         age: 23, 
         Designation: 'Admin', 
         _id: '003', 
         _rev: '1-c4cce025dbd30d21e40882d41842d5a4' 
      } 
   } 
]