Configurar Extract para o Oracle Autonomous AI Database

Estas são as etapas para configurar um Extract para capturar de um Autonomous AI Database:

Instale o Oracle GoldenGate para sua instância do Autonomous AI Database.
Criar uma implantação para o ambiente do Oracle GoldenGate. Esta é a implantação em que o Extract que captura dados da instância do Autonomous AI Database será criado. Consulte Adicionar uma Implantação.
Obtenha Credenciais do Autonomous AI Database Client.

Para estabelecer conexão com sua instância do Autonomous AI Database, faça download do arquivo de credenciais do cliente. Para fazer download das credenciais do cliente, você pode usar o Oracle Cloud Infrastructure Console ou o Database Actions Launchpad. Consulte Fazendo Download das Credenciais do Cliente (Wallets).

Observação: Se você não tiver acesso de administrador ao Autonomous AI Database, peça ao administrador do serviço para fazer download e fornecer os arquivos de credenciais a você.

As etapas a seguir usam o Inicializador do Database Actions para fazer download das credenciais do cliente.

Faça log-in na sua conta do Autonomous AI Database.

a. Na página Instância do Banco de Dados, clique em Database Actions. Isso inicia o Database Actions Launchpad. O Launchpad tenta fazer log-in no banco de dados como ADMIN. Se isso não for bem-sucedido, você será solicitado a informar seu nome de usuário e senha ADMIN do banco de dados.

b. No Launchpad do Database Actions, em Administration, clique em Download Client Credentials (Wallets).

c. Informe uma senha para proteger seu arquivo zip de Credenciais do Cliente e clique em Fazer Download.

Observação: A senha fornecida quando você faz download da wallet protege a wallet de Credenciais do Cliente baixada.

d. Salve o arquivo de credenciais zip no sistema local.
```
The credentials `zip` file contains the following files:

- `cwallet.sso`

- `ewallet.p12`

- `keystore.jks`

- `ojdbc.properties`

- `sqlnet.ora`

- `tnsnames.ora`

- `truststore.jks`

- `ewallet.pem`

- `README.txt`
```
Consulte e atualize (se necessário) os arquivos sqlnet.ora e tnsnames.ora ao configurar o Oracle GoldenGate para trabalhar com a instância do Autonomous AI Database.

Configure o servidor no qual o Oracle GoldenGate está em execução para estabelecer conexão com a instância do Autonomous AI Database.

a. Faça log-in no servidor no qual o Oracle GoldenGate foi instalado.

b. Transfira o arquivo zip de credenciais submetido a download da instância do Autonomous AI Database para o servidor Oracle GoldenGate.

c. No servidor do Oracle GoldenGate, descompacte o arquivo de credenciais em um novo diretório, por exemplo: /u02/data/adwc_credentials. Este é o seu diretório-chave.

d. Para configurar os detalhes da conexão, abra o arquivo tnsnames.ora no local do cliente Oracle na instância do Oracle GoldenGate.

e. Use a string de conexão com o grupo de consumidores LOW dbname_low, por exemplo, graphdb1_low, e mova-a para seu arquivo tnsnames.ora local.

 The connections for the default `ggadmin` user happens only with `low`, although `high` is used in the connection string, for example `graphdb1_high`.

 See *Local Naming Parameters in the tnsnames.ora File* chapter in the *Oracle AI Database Net Services Reference* guide.

Observação:

O arquivo fornecido com o arquivo de credenciais contém três nomes de serviço de banco de dados identificáveis como:

*ADWC_Database_Name*_low

*ADWC_Database_Name*_medium

*ADWC_Database_Name*_high

A Oracle recomenda que você use ADWC_Database_Name_low com o Oracle GoldenGate. Consulte Nomes de Serviço de Banco de Dados Predefinidos para Autonomous AI Database no guia Usando o Oracle Autonomous AI Database Serverless ou Serviços de Banco de Dados Predefinidos na documentação do Autonomous AI Database on Dedicated Exadata Infrastructure.

f. Edite o arquivo tnsnames.ora na instância do Oracle GoldenGate para incluir os detalhes da conexão disponíveis no arquivo tnsnames.ora no diretório de chaves (o diretório no qual você descompactou o arquivo zip de credenciais submetido a download do Autonomous AI Database).

<div class="infoboxnote" markdown="1">

**Note:**
Allows connections on ports 1521 and 1522. However, the Oracle GoldenGate connection only works with the port 1522. This is mandatory. If you use 1521, you get the following error:

   <pre class="copy"><code>Login failed. OCI Error ORA (status = 24459-ORA-24459: OCISessionGet() timed out waiting for pool to create new connections\n)&quot;, &quot;code&quot;: &quot;OGG-08110&quot;</code></pre>

</div>

 <pre class="copy"><code> Sample Connection String   adw1_low. = (description=                  (retry_count=20)(retry_delay=3)                  (address=(protocol=tcps)(port=1522)(host=adb-preprod.us-phoenix-1.oraclecloud.com))                  (connect_data=(service_name=okd2ybgcz4mjx94_graphdb1_low.adb.oraclecloud.com))                  (security=(ssl_server_cert_dn=&quot;CN=adwc-preprod.uscom-east-1.oraclecloud.com,OU=Oracle BMCS US,O=Oracle Corporation,L=Redwood City,ST=California,C=US&quot;))                )</code></pre>

 If the database is within a firewall protected environment, you might not have direct access to the database. With an existing HTTP Proxy, you can pass the firewall with the following modifications to the `sqlnet.ora` and `tnsnames.ora`:

 - `sqlnet parameters`

 - `address modification of tns_alias`

 If Extract becomes unresponsive due to a network timeout or connection loss, then you can add the following into the connection profile in the `tnsnames.ora` file:

(DESCRIPTION) = (RECV_TIMEOUT=30) (ADDRESS_LIST =

      (LOAD_BALANCE=off)(FAILOVER=on)(CONNECT_TIMEOUT=3)(RETRY_COUNT=3) (ADDRESS = (PROTOCOL = TCP)(HOST = adb-preprod.us-phoenix-1.oraclecloud.com)(PORT = 1522))

g. Para configurar a wallet, crie um arquivo sqlnet.ora no local do cliente Oracle na instância do Oracle GoldenGate.

cd /u02/data/oci/network/admin
ls
sqlnet.ora tnsnames.ora

 See [Autonomous AI Database Client Credentials](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=OGGMP-GUID-565DF23A-2E9D-4B57-B181-DC1165B31C97) in *Using Oracle GoldenGate on Oracle Cloud Marketplace*.

h. Edite este arquivo sqlnet.ora para incluir seu diretório de chaves.

 <pre class="copy"><code>WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=&quot;/u02/data/adwc_credentials&quot;))) SSL_SERVER_DN_MATCH=yes</code></pre>

Use o Admin Client para fazer log-in na implantação do Oracle GoldenGate, dependendo de você estar usando Microsserviços.
Crie uma credencial para armazenar o usuário e a senha GGADMIN. Esse usuário será usado para estabelecer conexão com o Autonomous AI Database na linha de comando, para executar comandos que exijam uma conexão de banco de dados. Ele também será usado no parâmetro USERIDALIAS para a conexão do banco de dados Extract.
```
 ALTER CREDENTIALSTORE ADD USER
 ggadmin@dbgraph1_low PASSWORD complex_password alias adb_alias
```
Você também pode usar o seguinte comando com high na string de conexão, mas ele ainda se conectará com low:
```
 ALTER CREDENTIALSTORE ADD USER
 ggadmin@dbgraph1_high PASSWORD complex_password alias adb_alias
```
Estabeleça conexão com o banco de dados usando DBLOGIN. O usuário DBLOGIN deve ser o usuário da conta adb_alias.
```
 DBLOGIN USERIDALIAS adb_alias
```
Configure o log complementar nas tabelas, que você deseja capturar usando ADD TRANDATA ou ADD SCHEMATRANDATA. Lembre-se de que você está conectado diretamente à instância do banco de dados, portanto, não há necessidade de incluir o nome do banco de dados nesses comandos. Aqui está um exmale:
```
 ADD TRANDATA HR.EMP
```
ou
```
 ADD SCHEMATRANDATA HR
```

Consulte Ativar Log Complementar Mínimo no Oracle Autonomous AI Database para o Oracle GoldenGate Extract.

Adicionar tabela de pulsação.
```
 ADD HEARTBEATTABLE
```
Adicione e configure um Extract para capturar da instância do Autonomous AI Database. Consulte Adicionar um Extract para ver as etapas para criar um Extract.

O Oracle GoldenGate Extract foi projetado para trabalhar com a instância do Autonomous AI Database para garantir que ele só seja capturado de uma instância de banco de dados específica. Isso significa que o nome da instância do banco de dados não é necessário para nenhuma instrução TABLE ou MAP.

O exemplo a seguir cria um Extract (obrigatório para captura de um Autonomous AI Database) chamado exte e o instrui a começar agora.

<pre class="copy"><code>ADD EXTRACT exte, INTEGRATED TRANLOG, BEGIN NOW</code></pre>

Para capturar tabelas específicas, use os nomes de objeto de duas partes. Por exemplo, para capturar da tabela HR.EMP, na sua instância do Autonomous AI Database, use essa entrada no arquivo de parâmetros do Extract.

<pre class="copy"><code> TABLE HR.EMP;</code></pre>

Se você quiser replicar HR.EMP em COUNTRY.EMPLOYEE, sua instrução de mapa terá a seguinte aparência:

<pre class="copy"><code> MAP HR.EMP, TARGET COUNTRY.EMPLOYEE;</code></pre>

Registre o Extract na instância do Autonomous AI Database. Por exemplo, para registrar um Extract chamado exte, use o seguinte comando:
```
 REGISTER EXTRACT exte DATABASE
```
Agora você pode iniciar o Extract e executar a replicação de dados para a instância do Autonomous AI Database. Veja um exemplo:
```
 START EXTRACT exte
```
Isso conclui o processo de configuração de um Extract para o Autonomous AI Database e você pode usá-lo como qualquer outro processo Extract.