Oracle Autonomous AI Database에 대한 추출 구성

다음은 자율운영 AI 데이터베이스에서 수집하도록 추출을 구성하는 단계입니다.

자율운영 AI 데이터베이스 인스턴스용 Oracle GoldenGate를 설치합니다.
Oracle GoldenGate 환경에 대한 배치를 생성합니다. 자율운영 AI 데이터베이스 인스턴스에서 데이터를 캡처하는 Extract가 생성될 배치입니다. 배포 추가를 참조하십시오.
자율운영 AI 데이터베이스 클라이언트 인증서를 가져옵니다.

자율운영 AI 데이터베이스 인스턴스에 대한 접속을 설정하려면 클라이언트 인증서 파일을 다운로드합니다. 클라이언트 인증서를 다운로드하려면 Oracle Cloud Infrastructure Console 또는 Database Actions Launchpad를 사용할 수 있습니다. 클라이언트 자격 증명 다운로드(전자 지갑)를 참조하십시오.

참고: 자율운영 AI 데이터베이스에 대한 관리자 액세스 권한이 없는 경우 서비스 관리자에게 인증서 파일을 다운로드하고 제공하도록 요청해야 합니다.

다음 단계에서는 Database Actions Launchpad를 사용하여 클라이언트 인증서를 다운로드합니다.

자율운영 AI 데이터베이스 계정에 로그인합니다.

a. 데이터베이스 인스턴스 페이지에서 데이터베이스 작업을 누릅니다. 그러면 Database Actions Launchpad가 실행됩니다. Launchpad가 ADMIN으로 데이터베이스에 로그인하려고 시도합니다. 그렇지 않으면 데이터베이스 ADMIN 사용자 이름과 비밀번호를 입력하라는 메시지가 표시됩니다.

b. 데이터베이스 작업 실행판의 관리에서 클라이언트 인증서 다운로드(전자 지갑)를 누릅니다.

c. 클라이언트 인증서 zip 파일의 보안을 유지하기 위한 비밀번호를 입력하고 다운로드를 누릅니다.

주: 전자 지갑을 다운로드할 때 제공한 비밀번호는 다운로드된 클라이언트 인증서 전자 지갑을 보호합니다.

d. 자격 증명 zip 파일을 로컬 시스템에 저장합니다.
```
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`
```
자율운영 AI 데이터베이스 인스턴스와 함께 작동하도록 Oracle GoldenGate를 구성하는 동안 sqlnet.ora 및 tnsnames.ora 파일을 참조하고 업데이트합니다(필요한 경우).

자율운영 AI 데이터베이스 인스턴스에 접속하기 위해 Oracle GoldenGate가 실행 중인 서버를 구성합니다.

a. Oracle GoldenGate가 설치된 서버에 로그인합니다.

b. 자율운영 AI 데이터베이스 인스턴스에서 다운로드한 인증서 zip 파일을 Oracle GoldenGate 서버로 전송합니다.

c. Oracle GoldenGate 서버에서 인증서 파일의 압축을 새 디렉토리(예: /u02/data/adwc_credentials)로 풉니다. 키 디렉토리입니다.

d. 접속 세부정보를 구성하려면 Oracle GoldenGate 인스턴스의 Oracle 클라이언트 위치에서 tnsnames.ora 파일을 엽니다.

e. 연결 문자열을 LOW 소비자 그룹 dbname_low(예: graphdb1_low)과 함께 사용하여 로컬 tnsnames.ora 파일로 이동합니다.

 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.

참고:

인증서 파일과 함께 제공된 파일에는 다음과 같이 식별 가능한 세 개의 데이터베이스 서비스 이름이 포함되어 있습니다.

*ADWC_Database_Name*_low

*ADWC_Database_Name*_medium

*ADWC_Database_Name*_high

Oracle은 Oracle GoldenGate와 함께 ADWC_Database_Name_low를 사용할 것을 권장합니다. Using Oracle Autonomous AI Database Serverless 가이드의 Predefined Database Service Names for Autonomous AI Database 또는 전용 Exadata Infrastructure의 자율운영 AI 데이터베이스에서 Predefined Database Services를 참조하십시오.

f. Oracle GoldenGate 인스턴스에서 tnsnames.ora 파일을 편집하여 키 디렉토리(자율운영 AI 데이터베이스에서 다운로드한 인증서 zip 파일의 압축을 해제한 디렉토리)의 tnsnames.ora 파일에서 사용 가능한 접속 세부정보를 포함시킵니다.

<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. 전자 지갑을 구성하려면 Oracle GoldenGate 인스턴스의 Oracle 클라이언트 위치에 sqlnet.ora 파일을 생성합니다.

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

시. 키 디렉토리를 포함하도록 이 sqlnet.ora 파일을 편집합니다.

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

마이크로서비스 사용 여부에 따라 관리 클라이언트를 사용하여 Oracle GoldenGate 배치에 로그인합니다.
GGADMIN 사용자 및 비밀번호를 저장할 인증서를 생성합니다. 이 사용자는 명령행에서 자율운영 AI 데이터베이스에 접속하여 데이터베이스 접속이 필요한 명령을 수행하는 데 사용됩니다. 또한 Extract 데이터베이스 접속에 대한 USERIDALIAS 매개변수에 사용됩니다.
```
 ALTER CREDENTIALSTORE ADD USER
 ggadmin@dbgraph1_low PASSWORD complex_password alias adb_alias
```
연결 문자열에서 다음 명령을 high와 함께 사용할 수도 있지만 여전히 low와 연결됩니다.
```
 ALTER CREDENTIALSTORE ADD USER
 ggadmin@dbgraph1_high PASSWORD complex_password alias adb_alias
```
DBLOGIN를 사용하여 데이터베이스에 연결합니다. DBLOGIN 사용자는 adb_alias 계정 사용자여야 합니다.
```
 DBLOGIN USERIDALIAS adb_alias
```
ADD TRANDATA 또는 ADD SCHEMATRANDATA를 사용하여 캡처할 테이블에 대한 보완 로깅을 구성합니다. 데이터베이스 Instance에 직접 연결되어 있으므로 이러한 명령에 데이터베이스 이름을 포함할 필요가 없습니다. 다음은 exmaple입니다.
```
 ADD TRANDATA HR.EMP
```
또는
```
 ADD SCHEMATRANDATA HR
```

Oracle GoldenGate Extract용 Oracle Autonomous AI Database에서 최소 보완 로깅 사용을 참조하십시오.

하트비트 테이블을 추가합니다.
```
 ADD HEARTBEATTABLE
```
자율운영 AI 데이터베이스 인스턴스에서 캡처할 Extract를 추가하고 구성합니다. 추출 생성 단계는 추출 추가를 참조하십시오.

Oracle GoldenGate Extract는 자율운영 AI 데이터베이스 인스턴스와 함께 작동하여 특정 데이터베이스 인스턴스에서만 캡처되도록 설계되었습니다. 즉, TABLE 또는 MAP 문에는 데이터베이스 인스턴스 이름이 필요하지 않습니다.

다음 예에서는 exte이라는 추출(자율운영 AI 데이터베이스에서 캡처하는 데 필요)을 생성하고 지금 시작하도록 지시합니다.

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

특정 테이블을 캡처하려면 두 개의 부품 객체 이름을 사용합니다. 예를 들어, 자율운영 AI 데이터베이스 인스턴스의 HR.EMP 테이블에서 캡처하려면 추출 매개변수 파일에서 이 항목을 사용합니다.

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

HR.EMP를 COUNTRY.EMPLOYEE에 복제하려는 경우 맵 문은 다음과 같이 표시됩니다.

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

자율운영 AI 데이터베이스 인스턴스에 Extract를 등록합니다. 예를 들어, 이름이 exte인 Extract를 등록하려면 다음 명령을 사용합니다.
```
 REGISTER EXTRACT exte DATABASE
```
이제 Extract를 시작하고 자율운영 AI 데이터베이스 인스턴스에 대한 데이터 복제를 수행할 수 있습니다. 예제는 다음과 같습니다.
```
 START EXTRACT exte
```
이렇게 해서 자율운영 AI 데이터베이스에 대한 추출 구성 프로세스가 완료되었으며 다른 추출 프로세스처럼 사용할 수 있습니다.