Replicar dados do YugabyteDB para o Autonomous AI Transaction Processing

Antes de começar

Para concluir com êxito este início rápido, certifique-se de que:

Uma instalação do YugabyteDB para servir como o banco de dados de origem
Uma instância do Autonomous AI Transaction Processing para servir como banco de dados de destino.
YugabyteDB Preparado para o Oracle GoldenGate

Configurar o YugabyteDB

Para configurar sua instância do YugabyteDB:

Se estiver usando o Oracle Cloud Compute para hospedar o YugabyteDB, abra a porta 5433:

sudo firewall-cmd --permanent --add-port=5432/tcp
sudo firewall-cmd --reload 
sudo firewall-cmd --list-all

Abra a porta 5433 na lista de segurança da sua VCN.
Estabeleça Conexão com YugabyteDB.
Desativar os dados de amostra.

Execute os comandos a seguir para configurar o usuário. Certifique-se de substituir o placeholder <password> por uma senha real.

create user ggadmin with password '<password>'; 
alter user ggadmin with SUPERUSER; 
GRANT ALL PRIVILEGES ON DATABASE ociggll TO ggadmin;

Configuração do ambiente: Autonomous AI Transaction Processing (ATP)

Faça download e descompacte o esquema de banco de dados de amostra.
Desbloqueie o usuário GGADMIN.
1. Na console do Oracle Cloud, selecione sua instância do ATP na Página do Autonomous AI Database para exibir seus detalhes e acessar o Database Actions.
2. Clique em Database Actions e, em seguida, clique em Database Users.
3. Localize GGADMIN e, em seguida, clique no menu reticências (três pontos) e selecione Editar.
4. No painel Editar Usuário, informe a senha GGADMIN, confirme a senha e, em seguida, desmarque Conta Bloqueada.
5. Clique em Aplicar Alterações.
Carregue o esquema e os dados de amostra de destino.
1. No menu Database Actions, selecione SQL.
2. Copie e cole o script de OCIGGLL_OCIGGS_SETUP_USERS_ADW.sql na planilha de SQL.
3. Clique emExecutar Script. A guia Saída do Script exibe mensagens de confirmação.
4. Limpe a planilha SQL e copie e cole o SQL no OCIGGLL_OCIGGS_SRC_MIRROR_USER_SEED_DATA.sql.
5. Para verificar se as tabelas foram criadas com sucesso, feche a janela SQL e reabra-a novamente. Na guia Navegador, procure o esquema SRC_OCIGGLL e selecione tabelas de suas respectivas listas drop-down.

Tarefa 1: Criar os recursos do OCI GoldenGate

Este exemplo de início rápido exige implantações e conexões para a origem e o destino.

Crie uma implantação para o banco de dados PostgreSQL de origem.
Crie uma implantação para a instância de destino do Autonomous AI Transaction Processing.
Crie uma conexão com o banco de dados PostgreSQL de origem.
1. Para Tipo, certifique-se de selecionar YugabyteDB.
2. Para Nome do banco de dados, informe o nome do YugabyteDB.
3. Para Host, informe o IP público da instância do serviço Compute na qual o YugabyteDB é executado.
4. Em Porta, informe 5433.
5. Em Username, digite ggadmin.
6. Em Senha, informe uma senha.
7. Para Protocolo de Segurança, selecione Simples.
Crie uma conexão para a instância de destino do Autonomous AI Transaction Processing.
Crie uma conexão com o GoldenGate e, em seguida, designe essa conexão à implantação do PostgreSQL de origem.
Designe a conexão de Origem à implantação do PostgreSQL de Origem.
Designe a conexão de destino à implantação Oracle de destino.

Tarefa 2: Ativar log complementar

Para ativar o registro em log complementar:

Inicie a console de implantação do PostgreSQL GoldenGate do:
1. Na página Implantações, selecione a implantação do PostgreSQL para ver os detalhes.
2. Na página Detalhes da implantação do PostgreSQL, clique em Iniciar console.
3. Na página de sign-in da console de implantação, informe as credenciais administrativas do GoldenGate fornecidas anteriormente quando você criou a implantação.
  
  Observação:
  O acesso será obrigatório se o IAM não tiver sido selecionado como o armazenamento de credenciais ao criar uma implantação.
No GoldenGate 26ai, clique em Conexões de BD na navegação à esquerda, em seguida, no banco de dados YugabyteDB de origem e, em seguida, em Trandata.
Na página TRANDATA, ao lado de Informações de TRANDATA, clique em Adicionar TRANDATA (ícone de mais).
No painel Trandata, para Nome do Esquema, digite src_ociggll.* e clique em Enviar.

Observação:
Use o campo de pesquisa para procurar src_ociggll e verificar se as tabelas foram adicionadas.

Tarefa 3: Criar as Extrações

Adicione o Change Data Capture Extract:
1. Na navegação esquerda, clique em Extrações,
2. Na página Extrações, clique em Adicionar Extração (ícone de mais) e preencha os campos da seguinte forma:
  - Na página Informações da Extração:
    1. Para o tipo Extrair, selecione Alterar Extrair Captura de Dados.
    2. Para Nome do Processo, informe um nome para a Extração, como ECDC.
    3. Clique em Próximo.
  - Na página Opções de Extração:
    1. Para credenciais de Origem, selecione Oracle GoldenGate na lista drop-down Domínio
    2. Selecione o banco de dados PostgreSQL de origem na lista drop-down Alias.
    3. Para Extrair Nome da Trilha, informe um nome de trilha de dois caracteres, como C1.
    4. Clique em Próximo.
  - Na página Parâmetros da Extração, substitua MAP *.*, TARGET *.*; pelo seguinte:
```
TABLE SRC_OCIGGLL.*;
```
3. Clique emCriar e Executar.
Adicione a Extração de Carga Inicial:
1. Na página Extrações, clique em Adicionar Extração e preencha o formulário Adicionar Extração da seguinte forma:
  - Na página Informações de Extração:
    1. Para o tipo Extrair, selecione Extrair Carga Inicial .
    2. Para Nome do Processo, informe um nome, como EIL.
    3. Clique em Próximo.
  - Na página Opções de Extração:
    1. Para credenciais de Origem, selecione Oracle GoldenGate na lista drop-down Domínio.
    2. Selecione YugabyteDB no menu suspenso Alias.
    3. Para Extrair Nome da Trilha, informe um nome de trilha de dois caracteres, como I1.
    4. Clique em Próximo.
  - Na página Parâmetros de Extração, substitua o conteúdo da área de texto pelo seguinte:
```
EXTRACT EIL
USERIDALIAS YugabyteDB_Compute, DOMAIN OracleGoldenGate
EXTFILE I1, PURGE
TABLE src_ociggll.*;
```
    Observação:
    Certifique-se de remover o parâmetro SOURCEDB na frente do USERIDALIAS antes de seguir em frente.
2. Clique emCriar e Executar.

Você retorna à página Extrações, na qual é possível observar o início da Extração.

Tarefa 4: crie o Distribution Path para Initial Load Extract

Na página Implantações, selecione a implantação do Oracle de destino.
Na página de detalhes da implantação, clique em Iniciar Console e, em seguida, faça log-in como o usuário administrador.
Se estiver usando o armazenamento de credenciais do IAM, continue na etapa Criar um Distribution Path. Se estiver usando o armazenamento de credenciais do GoldenGate, crie um usuário com o qual o GoldenGate de origem use para estabelecer conexão com o GoldenGate de destino.
1. No menu de navegação, clique em Administração de Usuários.
2. Clique no ícone Adicionar Novo Usuário (mais), preencha os campos da seguinte forma e clique em Submeter:
  - Para Username, informe ggsnet.
  - Para Atribuição, selecione Operador.
  - Digite a senha duas vezes para verificação.
No console de implantação do PostgreSQL de origem, crie uma Conexão de Caminho para o usuário criado na etapa anterior.
1. No menu de navegação, clique em Conexões de Caminho.
2. Clique no ícone Adicionar Conexão de Caminho (mais), preencha os campos da seguinte forma e clique em Submeter:
  - Para o Alias de Credencial, digite dpuser.
  - Para ID do Usuário, digite ggsnet
  - Para Senha, digite a mesma senha usada na etapa anterior.
Crie uma Distribution Path.
1. Na barra de menus do serviço, clique em Distribution Service e, em seguida, clique em Adicionar Distribution Path (ícone de mais).
2. Preencha o formulário Adicionar Caminho da seguinte forma:
  - Na página Informações do Caminho:
    1. Para Nome do Caminho, informe um nome para este caminho.
    2. Clique em Próximo.
  - Na página Opções de Origem:
    1. Para Origem Extract, deixe em branco.
    2. Para Nome da Trilha, informe o nome de trilha Initial Load Extract (I1).
    3. Clique em Próximo.
  - Na página Opções de Destino:
    1. Para Protocolo de Destino, selecione wss.
    2. Para Host do Destino, informe o URL de implantação do destino, sem o https:// ou qualquer barra à esquerda.
    3. Para o Número de Porta, informe 443.
    4. Para Nome da Trilha, informe I1.
    5. Para Método de Autenticação de Destino, selecione OAuth.
      
      Observação:
      Selecione Alias do ID do Usuário se o GoldenGate tiver sido selecionado como o armazenamento de credenciais ao criar uma implantação. Caso contrário, selecione OAuth.
    6. Para Domínio, informe o nome do domínio criado na etapa anterior.
    7. Para Alias, informe o alias criado na etapa anterior (dpuser).
    8. Clique em Próximo.
3. Clique emCriar e Executar.
Você retorna à página Distribution Service, na qual pode verificar o caminho criado.
Na console de implantação da Oracle de destino, verifique o caminho do Receptor criado como resultado do caminho de Distribuição:
1. Clique no Receiver Service.
2. Revise os detalhes de Distribution Path.

Tarefa 5: Adicionar um Replicat para Initial Load

Na implantação do Oracle de destino, adicione uma tabela Checkpoint.
1. No menu de navegação, clique em Conexões de BD
2. Selecione a instância de destino do Autonomous AI Database e, em seguida, Checkpoints.
3. Na página Checkpoints, clique em Adicionar Checkpoint (ícone de mais).
4. No painel Checkpoint, para Tabela de Esquema, digite SRCMIRROR_OCIGGLL.CHECKTABLE.
5. Clique em Enviar.
Adicione o Replicat.
1. No menu de navegação, clique em Replicats.
2. Na página Replicats, clique em Adicionar Replicat (ícone de mais) e preencha os campos Adicionar Replicat da seguinte forma:
  - Na página Informações de Replicat:
    1. Para o tipo Replicat, selecione Nonintegrated Replicat.
    2. Para Nome do Processo, informe um nome, como RIL.
    3. Clique em Próximo
  - Na página Opções do Replicat:
    1. Para Replicat Nome da Trilha, informe o nome da Trilha da Tarefa 2 (I1).
    2. Para Credenciais de Destino, selecione o Domínio e o Alias para a conexão do Autonomous AI Database.
    3. Para Tabela de Checkpoint, selecione a tabela de Checkpoint que você criou na Etapa 1.
    4. Clique em Próximo.
  - Na página Arquivo de Parâmetros, substitua MAP *.*, TARGET *.*; pelo seguinte:
```
MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;
```
3. Clique emCriar e Executar.
  Você retorna à página Replicats, na qual pode verificar os detalhes do Replicat.
Selecione a Replicat (RIL) e exiba seus Detalhes.
Clique emEstatísticas e verifique o número de Inserções. Atualize a página.
- Se o número de Inserções não for alterado, todos os registros do Initial Load serão carregados e você poderá interromper o Replicat (RIL)
- Se o número de Inserções persistir a aumentar, continue atualizando a página até os registros Initial Load serem carregados antes da continuação.
Verifique a Initial Load.
1. Na console do Oracle Cloud, na página de detalhes do Autonomous AI Database, clique em Database actions e em SQL.
2. Na ferramenta SQL, informe cada uma das seguintes instruções na planilha e clique em Executar Instrução:
```
SELECT * FROM SRCMIRROR_OCIGGLL.SRC_CITY;
SELECT * FROM SRCMIRROR_OCIGGLL.SRC_CUSTOMER;
```
A saída deve retornar os dados que foram carregados nas tabelas de banco de dados de destino como resultado do Initial Load.

Tarefa 6: Criar uma Distribution Path para a Change Data Capture Extract

No console da implantação do PostgreSQL de origem, clique em Distribution Service.
Clique em Adicionar Distribution Path.
Preencha o formulário Adicionar Caminho da seguinte forma:
1. Na página Informações do Caminho:
  1. Para Nome do Caminho, informe um nome.
  2. Clique em Próximo.
2. Na página Opções de Origem:
  1. Para Origem Extract, selecione a Change Data Capture Extract (ECDC).
  2. Para Nome da Trilha, selecione o arquivo da trilha Change Data Capture (C1).
  3. Clique em Próximo.
3. Na página Opções de Destino:
  1. Para Destino, selecione wss.
  2. Para Host de Destino, informe o URL da console de implantação de destino (você pode encontrar isso na página de detalhes da implantação, sem https:// ou qualquer barra à direita.
  3. Para o Número de Porta, informe 443.
  4. Para Nome da Trilha, informe C1.
  5. Para Método de Autenticação de Destino, selecione OAuth.
    
    Observação:
    Selecione Alias do ID do Usuário se o GoldenGate tiver sido selecionado como o armazenamento de credenciais ao criar uma implantação. Caso contrário, selecione OAuth.
  6. Em Domínio, digite o nome do domínio.
  7. Para Alias, informe o alias.
4. Clique em Criar Caminho e Executar.
Na console da implantação da Oracle de destino, clique em Serviço do Receptor e verifique o caminho do Receptor criado.

Tarefa 7: Adicionar uma Replicat para Change Data Capture

Na console de implantação do Oracle de destino, adicione uma Replicat.
1. No menu de navegação Serviço de Administração, clique em Replicats.
2. Na página Replicats, clique em Adicionar Replicat (ícone de mais) e preencha o formulário Adicionar Replicat da seguinte forma:
  - Na página Informações do Replicat:
    1. Para o tipo Replicat, selecione Nonintegrated Replicat.
    2. Para Nome do Processo, informe um nome, como RCDC.
    3. Clique em Próximo.
  - Na página Opções do Replicat:
    1. Para Replicat Nome da Trilha, informe o nome da Trilha da Tarefa 3 (C1).
    2. Para Credenciais de Destino, selecione o Domínio e o Alias para a conexão do Autonomous AI Database.
    3. Para Tabela de Checkpoint, selecione a tabela de Checkpoint.
  - Na página Parâmetros Replicat, substitua MAP *.*, TARGET *.*; pelo seguinte mapeamento:
```
MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;
```
3. Clique em Criar. Não execute o Replicat.
Na página Replicats, selecione o Replicat para Initial Load (RIL) e exiba seus Detalhes.
Clique emEstatísticas e verifique o número de Inserções. Atualize a página.
- Se o número de Inserções não for alterado, todos os registros do Initial Load serão carregados e você poderá interromper o Replicat (RIL)
- Se o número de Inserções persistir a aumentar, continue atualizando a página até os registros Initial Load serem carregados antes da continuação.
Observação:
Se você não vir nenhuma Inserção, clique em Serviço de Métricas de Desempenho, selecione a Extração e, em seguida, clique em Estatísticas do Banco de Dados.
Retorne à página Replicats e inicie a Replicat para Change Data Capture (RCDC).
Após iniciar o Replicat para Change Data Capture, revise seus Detalhes e Estatísticas para exibir o número de Inserções.

Verifique a replicação:

Execute o seguinte script para executar inserções no banco de dados PostgreSQL:

Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1000,'Houston',20,743113);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1001,'Dallas',20,822416);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1002,'San Francisco',21,157574);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1003,'Los Angeles',21,743878);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1004,'San Diego',21,840689);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1005,'Chicago',23,616472);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1006,'Memphis',23,580075);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1007,'New York City',22,124434);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1008,'Boston',22,275581);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1009,'Washington D.C.',22,688002);

No console de implantação do PostgreSQL de origem, selecione o Change Data Capture Extract (ECDC) e clique em Estatísticas. Verifique se src_ociggll.src_city tem 10 inserções.

Observação:
Se o Extract não capturou inserções, reinicie o ECDC Extract.
Na console de implantação Oracle de destino, selecione o nome Replicat (RCDC), exiba seus Detalhes e, em seguida, verifique Estatísticas. Verifique se SRCMIRROR_OCIGGLL.SRC_CITY tem 10 inserções.