추출 추가

Extract 추가를 위한 필요 조건 및 고려 사항에 대해 알아봅니다.

Extract를 추가하기 전에 다음 설정이 구성되었는지 확인합니다.

이제 배포에 대한 Extract를 추가할 준비가 되었습니다.

이전 추출 추적 파일이 있는 경우 추출을 생성하기 위한 고려 사항

정보 추출 화면

마이크로서비스 홈 페이지에 로그인한 후 생성 열에서 + 기호를 눌러 추출 추가 마법사를 엽니다.

추출 정보 화면에서 추출 유형을 선택합니다. 데이터베이스 플랫폼에 따라 사용 가능한 추출 유형은 통합 추출, 데이터 캡처 변경 추출 및 초기 로드 추출일 수 있습니다.

Oracle AI Database에 대해 다운스트림 추출을 설정해야 하는 경우 다운스트림 추출 토글 스위치를 사용으로 설정합니다.

생성할 추출 유형을 선택하고 다음을 지정합니다.

다음을 누릅니다.

추출 등록 화면 - PostgreSQL 및 Yugabyte 데이터베이스

주: Oracle용 Oracle GoldenGate Extract, 서로 다른 PostgreSQL flavor 및 Yugabyte Database를 등록해야 합니다. 그러나 Extract를 등록하는 구성 옵션은 Extract를 추가하는 동안 다른 화면에 표시됩니다.

주: PGOUTPUT 플러그인 유형에 대한 지침 및 제한 사항도 참조하십시오.

추출 등록 화면에서 다음 옵션을 구성하고 등록을 누릅니다.

추출 등록에 성공한 후 다음을 누릅니다.

Extract가 성공적으로 등록되었음을 알리는 메시지가 표시됩니다.

다음을 누릅니다.

관리 클라이언트에서 PostgreSQL 및 Yugabyte 데이터베이스에 대한 Extract 등록

Extract for PostgreSQL는 데이터베이스에 등록되어야 하며 예약된 복제 슬롯이 부여되어야 합니다. 복제 슬롯은 데이터베이스 구성 설정 max_replication_slots을 통해 할당되며 Database Configuration에 설명된 대로 구성할 수 있습니다.

다음 지침에 따라 Extract를 등록하십시오. 추출을 생성하기 전에 추출 등록을 수행해야 합니다. 자세한 내용은 Oracle GoldenGate에 대한 명령행 인터페이스 참조의 REGISTER EXTRACT를 참조하십시오.

  1. 배치에 접속한 다음 소스 데이터베이스의 인증서 별칭에 접속합니다.

    CONNECT http*s*://*remotehost*:*srvmgrport* DEPLOYMENT

          *deployment_name* AS *deployment_user* PASSWORD *deployment_password*
    OGG (https://*remotehost*:*16000**postgresql_source*)> DBLOGIN USERIDALIAS *alias*

  2. Extract에 대한 복제 슬롯을 내부적으로 만드는 Extract를 등록합니다. 추출 이름은 영숫자 8자를 초과할 수 없습니다.

    REGISTER EXTRACT *extname*

    Extract를 pgoutput 플러그인에 명시적으로 등록하려면 pgoutput 플러그인 유형을 지정해야 합니다.

    REGISTER EXTRACT *extname* PGPLUGINTYPE pgoutput;

Oracle GoldenGate MA 웹 인터페이스에서 Extract를 등록할 수도 있습니다. 추출 추가를 참조하십시오.

PGOUTPUT 플러그인 유형에 대한 지침 및 제한 사항

PGOUTPUT 플러그인 유형을 구성할 때의 지침

PostgreSQL에 대한 플러그인 유형을 설정할 때 다음 지침을 따릅니다.

제한 사항

PostgreSQL에 대한 플러그인 유형을 선택하는 동안 다음 제한 사항이 적용됩니다.

추출 옵션 화면

주: 이 화면에서는 Extract for Oracle AI Database를 등록하는 옵션을 제공합니다. PostgreSQL에 대한 추출을 추가하는 경우 추출 등록이 추출 등록 화면에서 완료됩니다.

추출 옵션 화면에서 다음 설정을 구성합니다.

관리 클라이언트에서 Oracle에 대한 추출 등록

다음 지침에 따라 Extract를 등록하십시오. 추출을 생성하기 전에 추출 등록을 수행해야 합니다.

DBLOGIN 명령을 사용하여 데이터베이스와 연결되어 있는지 확인합니다.

자세한 내용은 Oracle GoldenGate에 대한 명령행 인터페이스 참조의 [REGISTER EXTRACT](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GCLIR-GUID-5E42DB9E-EFDF-40C0-89D7-88413496B8A3)를 참조하십시오.

  1. 관리 클라이언트를 사용하여 배치에 접속한 다음 소스 데이터베이스의 인증서 별칭에 접속합니다.

    OGG> CONNECT https://*remotehost*:*srvmgrport* DEPLOYMENT *deployment_name* AS *deployment_user* PASSWORD *deployment_password*

    CONNECT 명령을 실행할 때 다음 예와 같이 명령 프롬프트가 "not connected"에서 "https://servername:port deployment_name"로 변경됩니다.

    OGG (https://*pdbeast.vcn.oracle.com*:*16000**depl_east*)>

  2. DBLOGIN 명령을 사용하여 데이터베이스에 연결합니다.

    OGG (https://*remotehost*:*port**oracle_source*)> DBLOGIN USERIDALIAS *alias*

  3. Extract 등록 추출 이름은 영숫자 8자를 초과할 수 없습니다.

    OGG (https://*remotehost*:*port**oracle_source*)> REGISTER EXTRACT *extname* DATABASE

Oracle GoldenGate MA 웹 인터페이스에서 추출을 생성하는 동안 백그라운드에서 추출을 등록할 수도 있습니다. 자세한 내용은 추출 추가를 참조하십시오.

다운스트림 캡처 화면

Oracle의 경우에만 적합합니다.

정보 추출 화면에서 다운스트림 캡처를 선택한 경우 다운스트림 캡처 옵션 화면이 표시됩니다. 이 화면을 사용하여 다운스트림 Extract에 대한 다운스트림 마이닝 데이터베이스 접속을 구성합니다.

주: ADG를 사용한 다운스트림 캡처는 PDB별 추출을 지원하지 않습니다.

다음을 누릅니다.

Managed Options 화면

관리되는 옵션 화면에서 추출 프로세스에 대한 자동 시작 및 자동 재시작 옵션을 구성합니다. 다음 표에서는 다음 옵션을 제공합니다.

다음 표에서는 다음 옵션을 제공합니다.

옵션 설명
프로파일 이름

autostart 및 autorestart 프로파일의 이름을 제공합니다. 기본 또는 사용자 정의 옵션을 선택할 수 있습니다.

이미 프로파일을 만든 경우 해당 프로파일도 선택할 수 있습니다. 사용자정의 옵션을 선택하는 경우 이 섹션 자체에서 새 프로파일을 설정할 수 있습니다.
배치 건전성에 중요

(Oracle만 해당) 프로파일이 배치 건전성에 중요한 경우 이 옵션을 사용으로 설정합니다.

참고:

이 옵션은 Extract 또는 Replicat를 생성할 때만 나타나며 [프로파일] 페이지에서 관리되는 프로세스를 설정할 때는 나타나지 않습니다.

자동 시작 프로세스에 대해 자동 시작을 사용으로 설정합니다.
시작 지연 프로세스를 시작하기 전 대기 시간(초)입니다
자동 재시작 프로세스가 종료될 경우 프로세스를 재시작하는 방법을 구성합니다.
최대 재시도 프로세스를 시작할 최대 재시도 횟수를 지정합니다.
재시도 지연 프로세스를 시작하려는 중 지연 시간
재시도 창 프로세스 시작을 시도하는 기간 간격입니다.
실패 시에만 재시작 true인 경우, 실패 시점에만 태스크가 재시작됩니다.
재시도가 소진된 후 태스크 사용 안함 true인 경우 프로세스를 다시 시작하려는 모든 시도가 모두 완료된 후 작업이 사용 안함으로 설정됩니다.

다음을 누릅니다.

추출 매개변수 파일 화면

매개변수 파일 화면에서 텍스트 영역의 매개변수 파일을 편집하여 캡처하려는 테이블 세부정보를 나열할 수 있습니다. 다음은 샘플 Extract 매개변수 파일입니다.

EXTRACT exte
USERIDALIAS ggeast DOMAIN OracleGoldenGate
EXTTRAIL east/ea
DDL INCLUDE MAPPED
TABLE hr.*;

추출을 생성 및 시작하려면 생성 및 실행을 누릅니다. 생성을 선택하면 추출이 생성되지만 추출 옵션을 사용하여 추출을 시작해야 합니다.

관리 서비스 홈 페이지 또는 생성된 모든 추출이 나열된 추출 페이지로 돌아갑니다.

추출할 매개변수 파일 생성

다음 지침에 따라 Extract에 대한 매개변수 파일을 생성하십시오.

  1. (MySQL만 해당) Windows 서버 및 원격 호스트에 있는 Linux 서버(23.10.x보다 작은 OGG 버전의 경우)에서 MySQL용 Oracle GoldenGate를 실행하는 경우 데이터베이스 서버는 해당 시간대가 동일한지 확인하고, 동일하지 않은 경우 Extract 내에서 SETENV(TZ) 매개변수를 사용하여 데이터베이스 서버의 시간대로 설정합니다.

    TZ 형식 및 자세한 내용은 매개변수 및 함수 참조 설명서의 SETENV 매개변수를 참조하십시오.

    다음 링크를 참조하십시오.

    https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/tzset?view=msvc-170#remarks

    https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html

  2. 소스 시스템에서 다음 명령을 실행합니다.

    EDIT PARAMS extract_name

    설명:

    extract_name는 ADD EXTRACT 명령으로 생성한 Extract의 이름 또는 그룹을 생성할 때 대체 위치를 정의한 경우 매개변수 파일의 정규화된 이름입니다.

  3. 다음 표에 나오는 순서대로 파라미터를 입력하고 각 파라미터 문에 대해 새 행을 시작합니다. 일부 매개변수는 특정 구성에만 적용됩니다.

    매개변수 설명
    EXTRACT group
    • group은 ADD EXTRACT 명령으로 만든 Extract 그룹의 이름입니다.
    		Extract를 체크포인트가 있는 온라인 프로세스로 구성합니다.
    [, USERIDALIAS alias options ] 데이터베이스 인증서를 지정하려면 [USERIDALIAS](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GWURF-GUID-530D7773-B66D-4499-A509-EF5BB9CE9B05)를 참조하십시오.
    ENCRYPTTRAIL algorithm 이 항목 다음에 지정된 모든 추적을 암호화합니다.
    SOURCECATALOG Oracle 다중 테넌트 컨테이너 데이터베이스 또는 SEQUENCE 문에서 기본 컨테이너를 지정합니다. 두 부분으로 구성된 이름(schema.object)을 사용할 수 있습니다. 여기서 세 부분으로 구성된 이름은 해당 데이터베이스에 필요합니다. 이 매개변수의 여러 인스턴스를 사용하여 TABLE 또는 SEQUENCE 매개변수의 서로 다른 세트에 대해 서로 다른 기본 컨테이너 또는 카탈로그를 지정할 수 있습니다.
    TABLE [container. \| catalog.]owner.object \| schema.object \| library/file \| library/file(member);

    객체의 전체 이름 또는 여러 객체에 대한 전체 와일드카드 지정을 지정합니다. 데이터베이스가 Oracle 다중 테넌트 컨테이너 데이터베이스인 경우 SOURCECATALOG를 사용하지 않는 한 객체 이름에 컨테이너 또는 카탈로그 이름이 포함되어야 합니다.

    • schema은 스키마 이름 또는 와일드 카드 문자 집합 스키마입니다.

    • object은 테이블 이름 또는 와일드카드 테이블 세트입니다.

    • library는 IBM i 라이브러리 이름 또는 와일드카드 라이브러리 세트입니다.

    • file는 IBM i 물리적 파일 이름 또는 와일드카드 문자 세트의 물리적 파일입니다.

    • member는 IBM i 물리적 파일 멤버 이름 또는 와일드카드 멤버 이름 세트입니다. IBM i 고유 이름 형식(선택적 멤버가 포함된 라이브러리/파일)을 사용할 때 유효한 와일드카드는 하나 이상의 유효한 문자가 포함된 이름이고 뒤에 별표(*) 또는 이름과 일치하는 *ALL가 옵니다.

    참고:

    멤버 이름은 선택 사항이며, 멤버 이름을 객체 이름의 일부로 추적에 기록해야 하는 경우 제공해야 합니다. 멤버 이름이 없으면 물리적 파일의 모든 멤버가 트레일의 단일 객체로 암시적으로 병합됩니다.

    매개변수 파일에 객체 이름을 지정하려면 Oracle GoldenGate 입력에서 객체 이름 지정 지침을 참조하십시오.

    SCHEMAEXCLUDE

    TABLEEXCLUDE

    EXCLUDEWILDCARDOBJECTSONLY

    		 연관된 TABLE 문의 와일드카드 사양에서 특정 객체를 제외하기 위해 서로 함께 사용할 수 있는 매개변수입니다.

  4. Oracle GoldenGate 매개변수에 나열된 적합한 선택적 Extract 매개변수를 입력합니다.

  5. 매개변수 파일을 저장한 후 닫습니다.

다음 샘플 Extract 매개변수 파일은 Extract에 대한 다양한 구성 매개변수 및 옵션을 설명합니다.

ADD EXTRACT *extract_name*
{, datasource}
{, BEGIN start_point} | {position_point}
[, PARAMS pathname]
[, REPORT pathname]
[, DESC 'description']

추출에 대한 추가 매개변수 옵션

Extract 구성에 필요한 추가 매개변수에 대해 알아봅니다.

Extract는 마이닝 데이터베이스의 데이터베이스 로그마이닝 서버를 사용하여 소스 데이터베이스의 리두 스트림을 마이닝합니다. Extract 매개변수 파일의 INTEGRATEDPARAMS 옵션과 함께 TRANLOGOPTIONS 매개변수를 사용하여 로그마이닝 서버와 관련된 매개변수를 설정할 수 있습니다.

주: 이러한 매개변수에 대한 자세한 정보 및 사용 지침은 Oracle AI Database PL/SQL Packages and Types Reference의 "DBMS_CAPTURE_ADM" 절을 참조하십시오.

다음 매개변수는 INTEGRATEDPARAMS로 설정할 수 있습니다.

Managing Server Resources를 참조하십시오.