Exibir código-fonte para Configurar IBReplicator

== '''Configurando o Replicator''' ==

Primeiramente temos que abrir o Replication Manager:

[[Arquivo:ConfigRepli01.png|frame|center]]

Logo, após devemos ir ao Menu:

File > New Configuration

Assim poderemos configurar nossas regras de replicação.  

[[Arquivo:ConfigRepli02.png|frame|center]]

A seguinte tela será aberta:

[[Arquivo:ConfigRepli03.png|frame|center]]

'''Server Type:''' Servidor do Banco de dados que será utilizado, em nosso exemplo estou utilizando FireBird classic 2.1.4.

'''Server Name:''' Será colocado o IP onde estará hospedado o Bando de dados com as regras de replicação que iremos criar.

'''Protocol:''' Tipo do Protocolo utilizado.

'''DataBase File:''' Deverá conter o caminho e o nome do banco de dados que será criado pelo replicador com as regras de replicação. 

'''User Name:''' Usuário do banco de dados.

'''Password:''' Senha do banco de dados.

'''Coment:''' Identificação do banco de dados contendo as regras da replicação.

Após o preenchimento dos dados é só clicar em '''“CREATE”'''

== '''Registrando Banco de dados no Replicador''' ==

O próximo passo é registrar os bancos de dados Origem e Destino no replicador, para que depois possamos configurar as regras de 
replicação, as imagens abaixo nos mostram os processos:

[[Arquivo:ConfigRepli04.png|frame|center]]

Clicar no botão Add DataBase e selecionar o banco de dados a ser utilizado.

[[Arquivo:ConfigRepli05.png|frame|center]]

Após o termino do registro do banco de origem iremos fazer o mesmo procedimento para o banco de destino, que ficará dessa maneira:

[[Arquivo:ConfigRepli06.png|frame|center]]

== '''Criando Usuário para o Replicador nos bancos de dados de Origem e Destino''' ==

Para a replicação funcionar corretamente é necessário criar um usuário diferente do SYSDBA, para realizar esse processo iremos utilizar a IDE IbExpert.

Com os dois bancos já registrado no IbExpert, basta apenas seguir os passos abaixo:

[[Arquivo:ConfigRepli07.png|frame|center]]

Clicar no Menu Tools > User Manager 

[[Arquivo:ConfigRepli08.png|frame|center]]

Após isso clicar no botão ADD, a tela New User será aberta onde será informado os dados do usuário a ser criado. (A senha deve ser a 
mesma do banco de dados instalado no micro).

Com o novo usuário criado agora devemos dar permissão a todos os objetos do banco de dados. Menu Tools > Grant Manager

[[Arquivo:ConfigRepli09.png|frame|center]]

[[Arquivo:ConfigRepli10.png|frame|center]]

Com o usuário REPLICACAO selecionado, basta apenas clicar no botão '''“Grant All to All”'''. 

Feito esse procedimento para o banco de origem, o mesmo deve ser realizado para o banco de destino. Após o término basta clicar no 
botão fechar:

[[Arquivo:ConfigRepli11.png|frame|center]]

== '''Configurando a Replicação''' ==

Com a tela inicial do replicador aberta, agora teremos que criar os schemas para poder atribuir regras de replicação, basta apenas 
clicar no ícone '''“New schema”''', conforme mostra a imagem abaixo:

[[Arquivo:ConfigRepli12.png|frame|center]]

Ao clicar no ícone New schema, a tela de Schema settings será aberta, nela iremos selecionar o Banco de Origem, o usuário que criamos 
nos bancos de dados e a senha do banco, após isso clicar em '''“Test connection”''', em caso de Ok, iremos para a aba Settings:

[[Arquivo:ConfigRepli13.png|frame|center]]

Na aba settings, iremos definir um nome para o Schema, e depois vamos clicar em ok.

[[Arquivo:ConfigRepli14.png|frame|center]]

Feito isso para o banco de origem vaos agora, realizar o procedimento para o banco de destino, basta clicar em Target database e 
preencher as telas como as duas próximas imagens podem nos mostrar:

[[Arquivo:ConfigRepli15.png|frame|center]]

Nesse caso só será necessário informar o banco de destino, usuário e senha do banco, após isso clicar em ok. 

[[Arquivo:ConfigRepli16.png|frame|center]]

Após todo o processo devemos ter o seguinte ambiente configurado:

[[Arquivo:ConfigRepli17.png|frame|center]]

== '''Configurando Tabelas e Campos a serem Replicados''' ==

Devemos ir ao banco de destino, logo após clicar em '''Replicated tables and Procedures''', e clicar no ícone Replicated tables, onde 
iremos configurar as tabelas que irão ser replicadas. 

[[Arquivo:ConfigRepli18.png|frame|center]]

Lembre-se que em caso de replicação de tabelas que possuem Foreign Keys, as tabelas dependentes devem ser replicadas primeiramente, abaixo segue um pequeno diagrama da estrutura de nosso banco de testes:

[[Arquivo:ConfigRepli19.png|frame|center]]

Após ter clicado em Replicated tables, será exibida uma tela para que você defina qual as tabelas e suas respectivas ordens de 
recebimento do banco de origem.

[[Arquivo:ConfigRepli20.png|frame|center]]

Na coluna '''“Target objects”''' basta dar um duplo click na tabela que a mesma será adicionada na coluna '''“Source objects and 
mappings”''' como mostrado na imagem abaixo, realizar o mesmo processo para tabela cidade:

[[Arquivo:ConfigRepli21.png|frame|center]]

Após isso teremos o seguinte ambiente:

[[Arquivo:ConfigRepli22.png|frame|center]]

O próximo passo é definir as chaves primárias e colunas das tabelas e os campos a serem replicados, o procedimento é semelhante ao de 
adicionar os campos que realizamos logo a cima:

[[Arquivo:ConfigRepli23.png|frame|center]]

Imagem nos mostra a primary key da tabela UF sendo adicionada no schema.

[[Arquivo:ConfigRepli24.png|frame|center]]

Imagem nos mostra o campo UFNOME da tabela UF sendo adicionada no schema.

Após o término teremos o seguinte ambiente para a tabela UF:

[[Arquivo:ConfigRepli25.png|frame|center]]

Agora basta repetir o processo para a tabela Cidade:

[[Arquivo:ConfigRepli26.png|frame|center]]

E por fim devemos criar os objetos (são triggers internas de controle que serão criados no banco de origem para o funcionamento da 
replicação), basta selecionar as tabelas e clicar no botão '''“create system objects for the mapping”'''

[[Arquivo:ConfigRepli27.png|frame|center]]

Depois disso poderemos visualizar as triggers de controle no banco de origem:

[[Arquivo:ConfigRepli28.png|frame|center]]

Próximo passo é definir nosso schema com default para isso basta seguir os passos da imagem abaixo:

[[Arquivo:ConfigRepli29.png|frame|center]]

Pronto !!! todas as regras de replicação estão criadas !!!

Agora devemos abrir o '''“Replication Server”'''

[[Arquivo:ConfigRepli30.png|frame|center]]

Vale lembrar que o serviço do replicador deve estar iniciado, caso não esteja inicie o mesmo e reinicie o computador.

[[Arquivo:ConfigRepli31.png|frame|center]]

Tela '''Replication Server'''

[[Arquivo:ConfigRepli32.png|frame|center]]

Basta clicar na seta azul conforme a imagem abaixo os mostra, para dar inicio ao processo de forma manual da replicação:

[[Arquivo:ConfigRepli33.png|frame|center]]

Obs: Nesse exemplo apenas os novos registros inseridos no banco de origem serão replicados, caso você opte por deixar as tabelas 
idênticas a seguinte opção de sincronizar deve ser executada:

[[Arquivo:ConfigRepli34.png|frame|center]]

Assim as tabelas no banco de destino deve receber todos os dados do banco de origem. 

 '''“ATENÇÃO”'''
 MUITO CUIDADO COM ESSA OPÇÃO, NO NOSSO EXEMPLO A TABELA POSSUI POUCOS DADOS, EM CASO DE GRANDES TABELAS É RECOMENDADO QUE NÃO EXISTA 
 USUÁRIOS CONECTADOS NO BANCO DE DADOS.

Banco antes da replicação:

[[Arquivo:ConfigRepli35.png|frame|center]]

Banco depois da replicação:

[[Arquivo:ConfigRepli36.png|frame|center]]

== '''Agendando o serviço de Replicação para execução Automática''' ==

É muito útil deixar o serviço rodando de forma automática, assim os dados serão migrados em tempo real.

Para isso é só seguir os passos abaixo:

[[Arquivo:ConfigRepli37.png|frame|center]]

OBS: O '''“Replication Managager”''' e '''“Replication Server”''' não precisam ficar abertos para execução das regras quando agendado de forma automática.



== '''Sql da Estrutura do Banco de Dados''' ==

 /* CRIACAO TABELA UF */
 CREATE TABLE UF (UFCODIGO  CHAR(2) NOT NULL,
                  UFNOME    VARCHAR(15) NOT NULL
                 );

 /* CRIACAO PK */
 ALTER TABLE UF ADD CONSTRAINT XPKUF PRIMARY KEY (UFCODIGO);
 
 /* CRIACAO TABELA CIDADE */
 CREATE TABLE CIDADE (CIDCODIGO       INTEGER NOT NULL,
                      CIDNOME         VARCHAR(60) NOT NULL,
                      CIDUF           CHAR(2)
                     );

 /* CRIACAO PK */
 ALTER TABLE CIDADE ADD CONSTRAINT XPKCIDADE PRIMARY KEY (CIDCODIGO);

 /* CRIACAO  FK */
 ALTER TABLE CIDADE ADD CONSTRAINT UF_CIDADE FOREIGN KEY (CIDUF) REFERENCES UF (UFCODIGO);
 COMMIT;

 /* INSERT DAS TABELAS CIDADES E UF */
 INSERT INTO UF (UFCODIGO, UFNOME) VALUES ('SP', 'SÃO PAULO');
 INSERT INTO UF (UFCODIGO, UFNOME) VALUES ('RJ', 'RIO DE JANEIRO');
 COMMIT;

 INSERT INTO CIDADE (CIDCODIGO, CIDNOME, CIDUF) VALUES (1, 'ARAÇATUBA', 'SP');
 INSERT INTO CIDADE (CIDCODIGO, CIDNOME, CIDUF) VALUES (2, 'BIRIGUI', 'SP');
 INSERT INTO CIDADE (CIDCODIGO, CIDNOME, CIDUF) VALUES (3, 'DUQUE DE CAIXAS', 'RJ');
 COMMIT;