Replicar dados do Autonomous AI Transaction Processing para o Oracle Object Storage

Este exemplo demonstra como replicar dados do Processamento de Transações do Autonomous AI para o Oracle Object Storage usando o OCI GoldenGate.

Esse início rápido também está disponível como um workshop do LiveLab. Veja o workshop

Antes de começar

Para concluir com sucesso essa inicialização rápida, você deve ter:

• Uma chave de API criada e baixada na página Detalhes do usuário da console do Oracle Cloud

• Uma instância do Autonomous AI Transaction Processing de origem

• O OCID do compartimento

Configuração do ambiente: Autonomous AI Transaction Processing

Se você ainda não tiver um banco de dados de origem configurado para replicação, poderá seguir estas etapas para carregar um esquema de amostra a ser usado para esse início rápido. Esse início rápido usa o Autonomous AI Transaction Processing para o banco de dados de origem.

Para configurar o Autonomous AI Transaction Processing de origem:

1. Faça download e descompacte o esquema de banco de dados de amostra.

2. Na console do Oracle Cloud, selecione sua instância do Autonomous AI Transaction Processing (ATP) na página Autonomous AI Databases para exibir seus detalhes e acessar as Database Actions.

3. Desbloqueie o usuário GGADMIN:

   1. Selecione Database actions e, em seguida, Database Users.

   2. Localize GGADMIN e, em seguida, selecione seu menu de reticências (três pontos) e selecione Editar.

   3. No painel Editar Usuário, informe a senha GGADMIN, confirme a senha e depois desmarque Conta Bloqueada.

   4. Selecione Aplicar Alterações.

4. Carregue o esquema e os dados de amostra de origem:

   1. No menu Ações do banco de dados, em Desenvolvimento, selecione SQL

   2. Copie e cole o script de OCIGGLL_OCIGGS_SETUP_USERS_ATP.sql na planilha de SQL.

   3. Selecione Executar Script. A guia Saída do Script exibe mensagens de confirmação.

   4. Limpe a planilha SQL e copie e cole o script SQL em OCIGGLL_OCIGGS_SRC_USER_SEED_DATA.sql.

      Dica: Talvez seja necessário executar cada instrução separadamente para que a ferramenta SQL execute os scripts com sucesso.

   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, em seguida, selecione tabelas nas respectivas listas dropdown.

5. Ative o registro em log complementar:

   1. Desmarque a Planilha SQL.

   2. Informe a seguinte instrução e selecione Executar Instrução:

      ALTER PLUGGABLE DATABASE ADD SUPPLEMENTAL LOG DATA;

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.

1. Crie uma implantação Oracle para a instância de processamento de transações de IA autônoma de origem.

2. Crie uma implantação de Big Data para o bucket do Oracle Object Storage de destino.

3. Crie uma conexão para a instância de Processamento de Transações do Autonomous AI de origem

4. Crie uma conexão para o Oracle Object Storage de destino.

5. Crie uma conexão com o GoldenGate e, em seguida, designe essa conexão à implantação do Oracle de origem.

6. Designe a conexão do Autonomous AI Transaction Processing à implantação do Oracle de origem.

7. Atribua a conexão do Oracle Object Storage à implantação do Big Data de destino.

Tarefa 2: Adicionar o processo de Extract

1. Na página Implantações, selecione a implantação de Processamento de Transação de IA Autônoma.

2. Na página de detalhes da implantação, selecione Iniciar Console.

3. Faça log-in com o nome de usuário e a senha do administrador da implantação de origem.

4. Adicione um processo de Extract.

Tarefa 3: Adicionar e executar o Caminho de Distribuição

1. Se estiver usando o armazenamento de credenciais do GoldenGate, crie um usuário para o Caminho de Distribuição na implantação do Big Data de destino; caso contrário, pule para a Etapa 3.

2. Na console de implantação do GoldenGate de origem, adicione uma Conexão de Caminho para o usuário criado na Etapa 1.

   1. Na console de implantação do GoldenGate de origem, selecione Conexões de Caminho na navegação esquerda.

   2. Selecione Adicionar Conexão de Caminho (ícone de mais) e conclua o seguinte:

      1. Para Alias da Credencial, informe GGSNetwork.

      2. Para o ID do Usuário, informe o nome do usuário criado na Etapa 1.

      3. Digite a senha do usuário duas vezes para verificação.

   3. Selecione Enviar.

      A conexão de caminho aparece na lista Conexões de Caminho.

3. No console de implantação de origem, adicione um Caminho de Distribuição com os seguintes valores:

   1. Na página Opções de Origem:

      • Para Extração de Origem, selecione a Extração criada na Tarefa 2.

      • Para Nome da Trilha, informe um Nome de dois caracteres, como E1

   2. Na página Opções de Destino:

      • Para Host do Destino, informe o domínio do host da implantação do destino.

      • Para o Número de Porta, informe 443.

      • Para Nome da Trilha, informe um Nome de dois caracteres, como E1

      • Para Alias, informe o Alias da Credencial criado na Etapa 2.

4. Na console de implantação do Big Data de destino, verifique o Caminho do Receptor criado como resultado do Caminho de Distribuição.

   1. Na console de implantação do Big Data de destino, selecione Receiver Service.

   2. Verifique os detalhes do caminho. Esse caminho foi criado como resultado do Caminho de Distribuição criado na etapa anterior.

Tarefa 4: Adicionar e executar o processo de Replicat

1. No menu de navegação da console de implantação do Big Data de destino, selecione Replicações.

2. Na página Replicats, selecione Adicionar Replicat (ícone de mais) e preencha o formulário da seguinte forma:

   1. Na página Informações do Replicat:

      1. Para Tipo de Replicat, selecione Replicat Clássico.

      2. Para Nome do Processo, informe um nome, como REP

   2. Na página Opções de Replicat:

      1. Para Nome da Trilha de Replicação, informe um nome de dois caracteres, como E1.

      2. Para Destino, selecione Oracle Object Storage

   3. Na página Arquivo de Parâmetros, substitua MAP *.*, TARGET *.*; por:

      MAP SRC_OCIGGLL.*, TARGET *.*;

   4. Na página Arquivo de Propriedades, configure propriedades do Handler de Eventos da OCI, conforme necessário.

      Propriedades obrigatórias:

      • gg.eventhandler.oci.compartmentID: O OCID do compartimento no qual reside o bucket do Oracle Object Storage.

      • gg.handler.oci.fileNameMappingTemplate: Gera nomes de arquivos dinamicamente usando Palavras-chave de Modelo.

      As propriedades que você pode considerar modificar incluem:

      • gg.handler.oci.format: Selecione como formatar a saída. json_row é a definição padrão. As opções disponíveis incluem:

        • texto delimitado

        • json

        • json_row

        • xml

        • avro_row_ocf

        • avro_op_ocf

          Dica: Para usar a propriedade de formatação do Oracle Object Storage, substitua name por oci. Por exemplo, gg.handler.name.format se torna gg.handler.oci.format.

      • gg.handler.oci.inactivityRollInterval: O GoldenGate cria um arquivo e o mantém aberto para gravação. Esta propriedade fecha o arquivo após o período designado de inatividade (sem transações recebidas) e, em seguida, o carrega no Oracle Object Storage. Por padrão, ele é definido como 5 segundos. Você pode especificar um tempo em milissegundos (ms), segundos (s), minutos (m) ou horas (h). Por exemplo, gg.handler.oci.inactivityRollInterval=10m.

      • gg.handler.oci.maxFileSize: O File Writer Handler abre o arquivo e o mantém aberto até ele atingir o tamanho máximo, supondo que não haja alterações de metadados. Por padrão, o tamanho máximo do arquivo é 1 GB, mas você pode alterá-lo usando essa propriedade. Quando o tamanho é atingido, o arquivo é fechado e um novo arquivo é gerado. Por exemplo, gg.handler.oci.maxFileSize=500m.

      • gg.handler.oci.rollOnShutdown: O valor padrão é verdadeiro. Quando definido como verdadeiro, o GoldenGate faz shutdown do arquivo aberto quando você interrompe o processo de Replicat. Por padrão, o File Writer Handler mantém o arquivo aberto mesmo que o processo de Replicat pare e continue a gravar no mesmo arquivo quando for reiniciado. Por exemplo, gg.handler.oci.rollOnShutdown=false

      • gg.handler.oci.fileRollInterval: Designa o tempo para manter o arquivo aberto antes de ser fechado e rola para um novo arquivo. Por padrão, é definido como 7 minutos. Você pode especificar um tempo em milissegundos (ms), segundos (s), minutos (m) ou horas (h). Por exemplo, gg.handler.oci.fileRollInterval=10m.

      • gg.eventhandler.oci.bucketMappingTemplate: Informe o nome da definição do Oracle Object Storage.

   5. Selecione Criar e Executar.

Tarefa 5: Verificar a replicação

Execute algumas atualizações para a instância do Autonomous AI Transaction Processing de origem para verificar a replicação no Oracle Object Storage.

1. Na console do Oracle Cloud, abra o menu de navegação, selecione Oracle AI Database e, em seguida, selecione Autonomous AI Transaction Processing.

2. Na lista de instâncias de Processamento de Transações do Autonomous AI, selecione sua instância de origem para exibir seus detalhes.

3. Na página de detalhes do banco de dados, selecione Database actions.

   Observação: Você deve estar conectado automaticamente. Caso contrário, faça log-in com as credenciais do banco de dados.

4. Na home page de ações do Banco de Dados, selecione SQL.

5. Informe o seguinte na planilha e selecione Executar Script.

   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);

6. Na console da implantação ATP de origem, selecione o nome da Extração e, em seguida, selecione Estatísticas. Verifique se SRC_OCIGGLL.SRC_CITY tem 10 inserções.

7. Na console de implantação do Big Data OCI GoldenGate de destino, selecione o nome do Replicat e, em seguida, Estatísticas. Verifique se SRC_OCIGGLL.SRC_CITY tem 10 inserções.

8. Na console do Oracle Cloud, navegue até o bucket do Oracle Object Storage e verifique seu conteúdo.

Tarefa 6: Monitorar e manter processos

1. Monitorar o processo de replicação.

2. Gerenciar arquivos de Trilha.

Saiba mais

Saiba mais sobre detalhes de configuração e formatos de arquivo suportados.