Replicar Dados do Autonomous AI Transaction Processing para o Azure Synapse Analytics

Esse início rápido demonstra como configurar uma replicação de dados do Autonomous AI Transaction Processing para o Azure Synapse Analytics usando o OCI GoldenGate.

Antes de começar

Para concluir este início rápido com sucesso, você deve ter o seguinte:

Espaço de Trabalho do Azure Synapse Analytics
Contêiner de Armazenamento do Azure associado ao Espaço de Trabalho do Azure Synapse Analytics
Credencial com Escopo do Banco de Dados do Azure Synapse Analytics para conceder permissões ao pool SQL para acessar a Conta de Armazenamento
Existência da tabela de destino: As tabelas de destino devem existir no banco de dados Synapse antes da replicação. Como o GoldenGate usa a Instrução SQL de Mesclagem, a tabela de destino deve ser uma tabela distribuída por hash.
Conexão de Armazenamento do OCI GoldenGate Azure Data Lake designada à implantação. Se ele não existir, crie uma conexão de Armazenamento do Data Lake do Azure e designe à implantação.

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:

Faça download e descompacte o esquema de banco de dados de amostra.
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.
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.
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.
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;
```

Configuração do ambiente: Azure Synapse Analytics

Abra o Azure Synapse Analytics Workspace.
Selecione Novo e, em seguida, Script SQL.
Conecte-se ao pool de sql e selecione o banco de dados.
Informe o seguinte comando para criar uma Criptografia de Chave Mestra:
```
CREATE MASTER KEY ENCRYPTION BY PASSWORD='<password>';
```
Use o seguinte comando para criar a Credencial com Escopo do Banco de Dados:

Certifique-se de substituir os placeholders <storage-account-name> e <storage-account-access-key> por seus valores reais.
```
CREATE DATABASE SCOPED CREDENTIAL <credential name>
WITH
IDENTITY='<storage-account-name>',
SECRET='<storage-account-access-key>';
```

Execute o script create table:

CREATE TABLE [dbo].[SRC_CUSTOMER] (
   CUSTID         NUMERIC(10) NOTNULL,
   DEAR           NUMERIC(1),
   LAST_NAME      VARCHAR(50),
   FIRST_NAME     VARCHAR(50),
   ADDRESS        VARCHAR(100),
   CITY_ID        NUMERIC(10),
   PHONE          VARCHAR(50),
   AGE            NUMERIC(3),
   SALES_PERS_ID  NUMERIC(10),
   constraint PK_SRC_CUSTOMER primarykeyNONCLUSTERED (CUSTID) NOT ENFORCED
)
WITH(DISTRIBUTION=HASH ([CUSTID]), HEAP ) GO

Verifique se a tabela dbo.SRC_Customer foi criada.

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 Oracle para a instância de processamento de transações de IA autônoma de origem.
Crie uma implantação do Big Data para o Azure Synapse Analytics de destino.
Crie uma conexão com o Autonomous AI Transaction Processing de origem.
Crie uma conexão doAzure Synapse Analytics.
Crie uma conexão de Armazenamento do Azure Data Lake.
Designe a conexão do Autonomous AI Transaction Processing à implantação do Oracle de origem.
Designe a conexão do Azure Synapse Analytics à implantação de Big Data de destino.

Tarefa 2: Adicionar o processo de Extract

Na página Implantações, selecione a implantação de Processamento de Transação de IA Autônoma.
Na página de detalhes da implantação, selecione Iniciar Console.
Faça log-in com o nome de usuário e a senha do administrador da implantação de origem.
Adicione um processo de Extract.

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

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.
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.
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.
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

Na console de implantação do Big Data de destino, selecione Replicatos e, em seguida, selecione Adicionar Replicat (ícone de mais).
Adicionar uma Replicação com os seguintes valores:
1. Na página Informações do Replicat, em Tipo de Replicat, selecione Replicat Clássico, informe um Nome do Processo e selecione Próximo.
2. Na página Opções de Replicação:
  - Para Nome, informe o nome da Trilho da Tarefa 2.
  - Para Domínio, selecione um domínio.
  - Para Alias, selecione a conexão do Azure Synapse Analytics criada na Tarefa 1.
  - Para Tabela de Checkpoints, selecione a tabela de checkpoints que você criou para a implantação do destino.
3. Na página Parâmetros de Replicat, substitua MAP *.*, TARGET *.*; por:
```
MAP SRC_OCIGGLL.SRC_CUSTOMER, TARGET dbo.SRC_CUSTOMER;
```
4. Na página Propriedades do Replicat, configure as propriedades do Azure Synapse Analytics:
  
  Observação: Edite as propriedades marcadas como TODO.
  - gg.eventhandler.abs.bucketMappingTemplate é o Contêiner de Armazenamento do Azure associado ao Espaço de Trabalho do Azure Synapse Analytics
  - gg.eventhandler.synapse.credential é o nome da credencial usada para autenticar o Contêiner de Armazenamento do Azure associado ao Espaço de Trabalho do Azure Synapse Analytics
Selecione Criar e Executar.

Você retornará à página Visão Geral, na qual poderá revisar os detalhes do processo de Replicat.

Tarefa 5: Verificar a replicação

Execute algumas atualizações na instância de origem do Autonomous AI Transaction Processing para verificar a replicação no Armazenamento do Data Lake do Azure.

Na console do Oracle Cloud, abra o menu de navegação, selecione Oracle AI Database e, em seguida, selecione Autonomous AI Transaction Processing.
Na lista de instâncias de Processamento de Transações do Autonomous AI, selecione sua instância de origem para exibir seus detalhes.
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.
Na home page do Database Actions, selecione SQL.
Informe o seguinte na planilha e selecione Executar Script.

Na console de implantação do GoldenGate OCI GoldenGate de origem, selecione o nome da Extração e, em seguida, selecione Estatísticas. Verifique se SRC_OCIGGLL.SRC_CUSTOMER tem 7 inserções.

Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1001,0,'Brendt','Paul','10 Jasper Blvd.',107,'(212) 555 2146',19,10);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1002,0,'McCarthy','Robin','27 Pasadena Drive',11,'(214) 555 3075',29,11);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1003,0,'Travis','Peter','7835 Hartford Drive',12,'(510) 555 4448',34,12);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1004,0,'Larson','Joe','87 Carmel Blvd.',13,'(213) 555 5095',45,13);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1005,0,'Goldschmidt','Tony','91 Torre drive',14,'(619) 555 6529',55,20);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1006,0,'Baker','William','2890 Grant Avenue',15,'(312) 555 7040',64,21);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1007,0,'Swenson','Jack','64 Imagination Drive',19,'(202) 555 8125',74,22)

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_CUSTOMER tem 7 inserções.
No console do Azure, navegue até o Console do espaço de trabalho do Azure Synapse Analytics. Execute Select * em dbo.SRC_CUSTOMER e verifique se o SRC_OCIGGLL.SRC_CUSTOMER tem 7 inserções.