전제 조건
데이터를 랜딩하거나 복제하려면 먼저 다음 전제 조건을 완료해야 합니다.
-
데이터 이동 게이트웨이 서버에 필요한 driver를 설치합니다.
정보 메모이는 데이터 이동 게이트웨이를 사용하기로 선택한 경우에만 필요합니다. 데이터 이동 게이트웨이의 이점과 필요한 경우에 대한 자세한 내용은 Qlik 데이터 게이트웨이 - 데이터 이동를 참조하십시오.
-
데이터 소스에 필요한 권한 부여
-
데이터 소스 커넥터 구성
드라이버 설정
드라이버 설치 유틸리티(권장)를 사용하거나 수동으로 driver를 설치할 수 있습니다. 수동 설치는 드라이버 설치 유틸리티에 문제가 발생하는 드문 경우에만 시도해야 합니다.
드라이버 설치 유틸리티를 사용하여 드라이버 설치
이 섹션에서는 필수 driver를 설치하는 방법에 대해 설명합니다. 이 프로세스에는 필수 driver를 자동으로 다운로드, 설치 및 구성하는 스크립트 실행이 포함됩니다. 필요에 따라 스크립트를 실행하여 driver를 업데이트하고 제거할 수도 있습니다.
설치 준비
-
Python 3.6 이상이 데이터 이동 게이트웨이 서버에 설치되어 있는지 확인합니다.
Python은 대부분의 Linux 배포에 사전 설치되어 있습니다. 다음 명령을 실행하여 시스템에 설치된 Python 버전을 확인할 수 있습니다.
python3 --version
driver 설치
driver를 다운로드하고 설치하려면:
-
데이터 이동 게이트웨이 컴퓨터에서 작업 디렉터리를 다음으로 변경합니다.
opt/qlik/gateway/movement/drivers/bin
-
다음 명령을 실행합니다.
구문:
./install oracle
driver를 다운로드할 수 없는 경우(액세스 제한 또는 기술 문제로 인해) driver를 다운로드할 위치와 데이터 이동 게이트웨이 컴퓨터에서 복사할 위치를 알려 주는 메시지가 표시됩니다. 완료했으면 install oracle 명령을 다시 실행합니다.
그렇지 않으면 driver에 대한 EULA가 표시됩니다.
-
다음 중 하나를 수행합니다.
- [Enter] 키를 반복해서 눌러 EULA를 천천히 스크롤합니다.
- 스페이스바를 반복해서 눌러 EULA를 빠르게 스크롤합니다.
- q를 눌러 라이센스 텍스트를 종료하고 EULA 동의 옵션이 표시됩니다.
-
다음 중 하나를 수행합니다.
- "y"를 입력하고 [Enter]를 눌러 EULA에 동의하고 설치를 시작합니다.
- "n"을 입력하고 [Enter] 키를 눌러 EULA를 거부하고 설치를 종료합니다.
-
"v"를 입력하고 [Enter] 키를 눌러 EULA를 다시 봅니다.
driver가 설치됩니다.
driver 업데이트
제공된 driver를 설치하기 전에 driver의 이전 버전을 제거하려면 업데이트 명령을 실행합니다.
driver를 다운로드하고 업데이트하려면:
-
데이터 이동 게이트웨이 컴퓨터에서 작업 디렉터리를 다음으로 변경합니다.
opt/qlik/gateway/movement/drivers/bin
-
다음 명령을 실행합니다.
구문:
./update oracle
driver를 다운로드할 수 없는 경우(액세스 제한 또는 기술 문제로 인해) driver를 다운로드할 위치와 데이터 이동 게이트웨이 컴퓨터에서 복사할 위치를 알려 주는 메시지가 표시됩니다. 완료했으면 update oracle 명령을 다시 실행합니다.
그렇지 않으면 driver에 대한 EULA가 표시됩니다.
-
다음 중 하나를 수행합니다.
- [Enter] 키를 반복해서 눌러 EULA를 천천히 스크롤합니다.
- 스페이스바를 반복해서 눌러 EULA를 빠르게 스크롤합니다.
- q를 눌러 라이센스 텍스트를 종료하고 EULA 동의 옵션이 표시됩니다.
-
다음 중 하나를 수행합니다.
- "y"를 입력하고 [Enter]를 눌러 EULA에 동의하고 설치를 시작합니다.
- "n"을 입력하고 [Enter] 키를 눌러 EULA를 거부하고 설치를 종료합니다.
- "v"를 입력하고 [Enter] 키를 눌러 EULA를 처음부터 검토합니다.
이전 driver가 제거되고 새 driver가 설치됩니다.
driver 제거
driver를 제거하려면 제거 명령을 실행합니다.
driver를 제거하려면:
-
이 커넥터를 사용하도록 구성된 모든 작업을 중지합니다.
-
데이터 이동 게이트웨이 컴퓨터에서 작업 디렉터리를 다음으로 변경합니다.
opt/qlik/gateway/movement/drivers/bin
-
다음 명령을 실행합니다.
구문:
./uninstall oracle
driver이 제거됩니다.
수동으로 드라이버 설치
자동 드라이버 설치가 성공적으로 완료되지 않은 경우에만 수동으로 driver 설치를 시도해야 합니다.
데이터 이동 게이트웨이를 설치한 후 oracle-instantclient-basiclite-<version>.x86_64.rpm 드라이버를 다운로드합니다. /opt/qlik/gateway/movement/drivers/manifests/oracle.yaml의 binary-artifacts에서 지원되는 버전에 대한 직접 다운로드 링크를 찾을 수 있습니다. 다운로드가 완료되면 RPM을 데이터 이동 게이트웨이 컴퓨터에 복사합니다.
그런 다음 데이터 이동 게이트웨이 서버에서 셸 프롬프트를 열고 다음을 수행합니다.
-
데이터 이동 게이트웨이 서비스 중지:
sudo systemctl stop repagent
-
선택적으로 서비스가 중지되었는지 확인합니다.
sudo systemctl status repagent
- 드라이버(RPM)를 설치합니다.
-
또한 시스템에 아직 포함되어 있지 않은 경우 $Oracle_Home\lib 디렉터리에 기호 링크를 만듭니다. 링크 libclntsh.so의 이름을 지정하고 이 파일의 특정 버전을 가리킵니다.
예:
lrwxrwxrwx 1 oracle oracle 63 Oct 2 14:16 libclntsh.so -> /u01/app/oracle/home/lib/libclntsh.so.21.1
-
작업 디렉터리를 <데이터 이동 게이트웨이-Install-Dir>/bin으로 변경하고 드라이버 위치를 site_arep_login.sh 파일에 복사하여 Oracle Instant Client 디렉터리와 데이터 이동 게이트웨이lib 디렉터리에 LD_LIBRARY_PATH 환경 변수를 추가합니다.
echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/oracle/instantclient_<version>:/opt/qlik/gateway/movement/lib/" >> site_arep_login.sh
-
선택적으로 드라이버 위치가 복사되었는지 확인합니다.
cat site_arep_login.sh -
데이터 이동 게이트웨이 서비스 시작:
sudo systemctl start repagent
-
선택적으로 서비스가 시작되었는지 확인합니다.
sudo systemctl status repagent
상태는 다음과 같아야 합니다.
Active: active (running) since <timestamp> ago
상태는 다음과 같아야 합니다.
Active: inactive (dead) since <timestamp> ago
Oracle 계정 액세스 제공
데이터 이동 게이트웨이 사용자에게 Oracle 계정 액세스 권한을 제공해야 합니다. 이 사용자는 Oracle 데이터베이스에 대한 읽기/쓰기 권한이 있어야 합니다. Oracle 계정에 대한 액세스 설정에 대한 자세한 내용은 필요한 권한을 참조하십시오.
ARCHIVELOG 모드가 켜져 있는지 확인
Oracle은 ARCHIVELOG 모드와 NOARCHIVELOG 모드의 두 가지 다른 모드에서 실행할 수 있습니다. 데이터 이동 게이트웨이에서 Oracle 로그를 사용하려면 데이터베이스를 ARCHIVELOG 모드로 실행합니다. 로그가 ARCHIVELOG 모드로 설정되지 않은 경우 다음 쿼리를 실행합니다.
ALTER database ARCHIVELOG
Oracle 데이터베이스 인스턴스가 Amazon RDS에 있는 경우 다른 명령을 실행해야 합니다. 자세한 내용은 자동 백업 활성화 및 보관 설정를 참조하십시오
보충 로깅 설정
데이터베이스 수준과 테이블 수준 모두에서 Oracle 데이터베이스에 대해 보충 로깅을 활성화해야 합니다.
Oracle 대기 환경에서 이동의 경우 대기 인스턴스가 아닌 기본 Oracle 인스턴스(아래 설명 참조)에 보충 로깅을 설정해야 합니다.
데이터베이스 수준에서 보충 로깅 확인 및 활성화
-
다음 쿼리를 실행합니다.
SELECT name, value, description FROM v$parameter WHERE name = 'compatible';
반환된 결과는 GE to n.n.n에서 나와야 합니다. 여기서 n.n.n은 Oracle 데이터베이스 버전(예: 10.0.0)입니다.
경고 메모매개 변수 값은 데이터베이스의 실제 버전과 일치해야 합니다.
-
다음 쿼리를 실행합니다.
SELECT supplemental_log_data_min FROM v$database;
반환된 결과는 YES 또는 IMPLICIT여야 합니다.
다음 쿼리를 실행하여 보충 로깅을 활성화합니다.
ALTER DATABASE ADD SUPPLEMENTAL LOG DATA
정보 메모Oracle 데이터베이스 인스턴스가 Amazon RDS에 있는 경우 다른 명령을 실행해야 합니다. 자세한 내용은 Oracle용 Amazon RDS 작업을 참조하십시오.
테이블 수준에서 보충 로깅 확인 및 활성화
-
테이블 수준에서 보충 로깅이 활성화되어 있는지 확인하려면 다음 쿼리를 실행합니다.
구문:
select count(*) from ALL_LOG_GROUPS where LOG_GROUP_TYPE='ALL COLUMN LOGGING' and OWNER= 'OWNER' and TABLE_NAME='TABLE-NAME';
예:
select count(*) from ALL_LOG_GROUPS where LOG_GROUP_TYPE='ALL COLUMN LOGGING' and OWNER= 'HR' and TABLE_NAME='EMPLOYEES';
-
테이블 수준에서 보충 로깅을 활성화하려면 다음 쿼리를 실행합니다.
구문:
ALTER TABLE TABLE-NAME ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;
예:
ALTER TABLE HR.EMPLOYEES ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;
관련 항목: 필요한 권한