기본 콘텐츠로 건너뛰기 보완적인 콘텐츠로 건너뛰기
Qlik 리소스

전제 조건

데이터를 랜딩하거나 복제하려면 먼저 다음 전제 조건을 완료해야 합니다.

  • 데이터 이동 게이트웨이 서버에 필요한 driver 설치

  • 데이터 소스에 필요한 권한 부여

  • 데이터 소스 커넥터 구성

지원되는 에디션

다음 MySQL Edition이 지원됩니다.

  • MySQL Community 에디션
  • MySQL Standard 에디션
  • MySQL Enterprise 에디션
  • MySQL Cluster Carrier Grade 에디션

드라이버 설정

드라이버 설치 유틸리티(권장)를 사용하거나 수동으로 driver를 설치할 수 있습니다. 수동 설치는 드라이버 설치 유틸리티에 문제가 발생하는 드문 경우에만 시도해야 합니다.

드라이버 설치 유틸리티를 사용하여 드라이버 설치

이 섹션에서는 필수 driver를 설치하는 방법에 대해 설명합니다. 이 프로세스에는 필수 driver를 자동으로 다운로드, 설치 및 구성하는 스크립트 실행이 포함됩니다. 필요에 따라 스크립트를 실행하여 driver를 업데이트하고 제거할 수도 있습니다.

설치 준비

  • Python 3.6 이상이 데이터 이동 게이트웨이 서버에 설치되어 있는지 확인합니다.

    Python은 대부분의 Linux 배포에 사전 설치되어 있습니다. 다음 명령을 실행하여 시스템에 설치된 Python 버전을 확인할 수 있습니다.

    python3 --version

driver 설치

driver를 다운로드하고 설치하려면:

  1. 데이터 이동 게이트웨이 컴퓨터에서 작업 디렉터리를 다음으로 변경합니다.

    opt/qlik/gateway/movement/drivers/bin

  2. 다음 명령을 실행합니다.

    구문:

    ./install mysql

    driver를 다운로드할 수 없는 경우(액세스 제한 또는 기술 문제로 인해) driver를 다운로드할 위치와 데이터 이동 게이트웨이 컴퓨터에서 복사할 위치를 알려 주는 메시지가 표시됩니다. 완료했으면 install mysql 명령을 다시 실행합니다.

    그렇지 않으면 driver에 대한 EULA가 표시됩니다.

  3. 다음 중 하나를 수행합니다.

    • [Enter] 키를 반복해서 눌러 EULA를 천천히 스크롤합니다.
    • 스페이스바를 반복해서 눌러 EULA를 빠르게 스크롤합니다.
    • q를 눌러 라이센스 텍스트를 종료하고 EULA 동의 옵션이 표시됩니다.

  4. 다음 중 하나를 수행합니다.

    • "y"를 입력하고 [Enter]를 눌러 EULA에 동의하고 설치를 시작합니다.
    • "n"을 입력하고 [Enter] 키를 눌러 EULA를 거부하고 설치를 종료합니다.

    • "v"를 입력하고 [Enter] 키를 눌러 EULA를 다시 봅니다.

    5. driver가 설치됩니다.

driver 업데이트

제공된 driver를 설치하기 전에 driver의 이전 버전을 제거하려면 업데이트 명령을 실행합니다.

driver를 다운로드하고 업데이트하려면:

  1. 데이터 이동 게이트웨이 컴퓨터에서 작업 디렉터리를 다음으로 변경합니다.

    opt/qlik/gateway/movement/drivers/bin

  2. 다음 명령을 실행합니다.

    구문:

    ./update mysql

    driver를 다운로드할 수 없는 경우(액세스 제한 또는 기술 문제로 인해) driver를 다운로드할 위치와 데이터 이동 게이트웨이 컴퓨터에서 복사할 위치를 알려 주는 메시지가 표시됩니다. 완료했으면 update mysql 명령을 다시 실행합니다.

    그렇지 않으면 driver에 대한 EULA가 표시됩니다.

  3. 다음 중 하나를 수행합니다.

    • [Enter] 키를 반복해서 눌러 EULA를 천천히 스크롤합니다.
    • 스페이스바를 반복해서 눌러 EULA를 빠르게 스크롤합니다.
    • q를 눌러 라이센스 텍스트를 종료하고 EULA 동의 옵션이 표시됩니다.

  4. 다음 중 하나를 수행합니다.

    • "y"를 입력하고 [Enter]를 눌러 EULA에 동의하고 설치를 시작합니다.
    • "n"을 입력하고 [Enter] 키를 눌러 EULA를 거부하고 설치를 종료합니다.
    • "v"를 입력하고 [Enter] 키를 눌러 EULA를 처음부터 검토합니다.

    5. 이전 driver가 제거되고 새 driver가 설치됩니다.

driver 제거

driver를 제거하려면 제거 명령을 실행합니다.

driver를 제거하려면:

  1. 이 커넥터를 사용하도록 구성된 모든 작업을 중지합니다.

  2. 데이터 이동 게이트웨이 컴퓨터에서 작업 디렉터리를 다음으로 변경합니다.

    opt/qlik/gateway/movement/drivers/bin

  3. 다음 명령을 실행합니다.

    구문:

    ./uninstall mysql

    driver이 제거됩니다.

수동으로 드라이버 설치

자동 드라이버 설치가 성공적으로 완료되지 않은 경우에만 수동으로 driver 설치를 시도해야 합니다.

데이터 이동 게이트웨이이 설치된 후 mysql-connector-odbc-<version>.x86_64.rpm 드라이버를 다운로드합니다. /opt/qlik/gateway/movement/drivers/manifests/mysql.yaml의 binary-artifacts에서 지원되는 버전에 대한 직접 다운로드 링크를 찾을 수 있습니다. 다운로드가 완료되면 RPM을 데이터 이동 게이트웨이 컴퓨터에 복사합니다.

Data Movement gateway 서버에서 셸 프롬프트를 열고 다음을 수행합니다.

  1. Data Movement gateway 서비스 중지:

    sudo systemctl stop repagent

  2. 선택적으로 서비스가 중지되었는지 확인합니다.

    sudo systemctl status repagent

    상태는 다음과 같아야 합니다.

    Active: inactive (dead) since <timestamp> ago

  3. Data Movement gateway 컴퓨터에 드라이버를 설치합니다.

  4. 작업 디렉터리를 <Data Movement gateway 설치 디렉터리>/bin으로 변경합니다.

  5. 드라이버 위치를 site_arep_login.sh 파일에 복사:

    echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/usr/lib64" >> site_arep_login.sh

    그러면 "LD_LIBRARY_PATH"에 드라이버가 추가되고 site_arep_login.sh 파일에서 드라이버 위치가 업데이트됩니다.

  6. 선택적으로 드라이버 위치가 복사되었는지 확인합니다.

    cat site_arep_login.sh

  7. /etc/odbcinst.ini 파일에 다음 예와 같이 MySQL에 대한 항목이 포함되어 있는지 확인합니다.

    [MySQL ODBC 8.0 Unicode Driver]

    Driver = /usr/lib64/libmyodbc8w.so

    UsageCount = 1

  8. Data Movement gateway 서비스 시작:

    sudo systemctl start repagent

  9. 선택적으로 서비스가 시작되었는지 확인합니다.

    sudo systemctl status repagent

    상태는 다음과 같아야 합니다.

    Active: active (running) since <timestamp> ago

포트

기본적으로 Data Movement gateway 서버에서 아웃바운드 통신을 위해 포트 3306을 열어야 합니다. 커넥터 설정에서 변경할 수 있습니다.

일반 전제 조건

다음 전제 조건이 충족되었는지 확인합니다.

  • 필요한 권한이 있는 MySQL 계정.
  • MySQL 8: 변경 내용 캡처를 위한 표준 인증

  • 인증된 MySQL 버전은 임시 데이터 유형에 대한 소수 값을 지원합니다(MySQL 5.6에 소개됨). 따라서 이전 임시 데이터 유형 서식의 랜딩는 더 이상 지원되지 않습니다.

    정보 메모임시 데이터 유형에 대한 소수 값을 지원하는 MySQL 버전으로 업그레이드해도 임시 데이터 유형 서식은 자동으로 업그레이드되지 않습니다. 이 작업은 별도로 수행해야 합니다. 이는 MariaDB 10.1에서 업그레이드할 때도 적용됩니다. 임시 데이터 유형 서식을 업그레이드하는 방법에 대한 지침은 공급업체의 온라인 도움말을 참조하십시오.

고객이 설치한 MySQL 데이터베이스에서 변경 내용 캡처

다음 섹션에서는 온프레미스 MySQL 데이터베이스에서 변경 내용을 캡처하기 위한 요구 사항을 설명합니다.

이진 로깅 활성화

이진 로깅(CDC 랜딩에 필요)을 활성화하려면 MySQL의 my.ini(Windows) 또는 my.cnf(UNIX) 파일에서 다음 매개 변수를 구성해야 합니다.

이진 로깅 매개 변수
매개 변수 값

server_id

1부터 모든 값입니다.

예:

server_id=1

log-bin=<경로>

이진 로그 파일의 경로(확장자 제외)입니다.

예:

log-bin=E:\MySql_Logs\BinLog

binlog_format

다음과 같아야 합니다.

binlog_format=row

expire_logs_days

디스크 공간 문제를 방지하려면 기본값(0)을 사용하지 않는 것이 좋습니다.

예:

expire_logs_days=5

binlog_row_image

다음과 같아야 합니다.

binlog_row_image=full

클러스터 전제 조건

(클러스터 노드에 연결하여) 클러스터된 (NDB) 테이블을 랜딩하려면 다음 매개 변수를 MySQL의 my.ini(Windows) 또는 my.cnf(UNIX) 파일에 구성해야 합니다.

정보 메모

Percona를 소스로 사용하는 경우 이 섹션에 설명된 절차를 수행할 필요가 없습니다.

클러스터 매개 변수
매개 변수 값

ndb_log_bin

다음과 같아야 합니다.

ndb_log_bin=on

클러스터링된 테이블의 변경 내용이 이진 로그에 기록되도록 합니다.

ndb_log_update_as_write

다음과 같아야 합니다.

ndb_log_update_as_write=OFF

이진 로그에서 UPDATE가 INSERT로 기록되는 것을 방지합니다.

ndb_log_updated_only

다음과 같아야 합니다.

ndb_log_updated_only=OFF

이진 로그에 변경된 열뿐만 아니라 전체 행이 포함되도록 합니다.

MySQL용 Google Cloud에서 변경 내용 캡처

이진 로깅

변경 내용을 캡처하려면 이진 로깅이 필요합니다. 이진 로깅 상태가 활성화됨(기본값)인지 확인하려면 데이터베이스의 binlog_row_image 매개 변수가 full로 설정되어 있는지 확인합니다.

복제

복제를 사용하면 기본 데이터베이스 서버의 데이터를 하나 이상의 보조 서버로 복사할 수 있습니다.

데이터를 기본 서버 또는 보조 서버에서 랜딩할 수 있습니다.

보조 서버에서 변경 내용을 캡처하려면 이진 로깅 매개 변수 log_slave_updates 를 true (1)로 설정해야 합니다.

추가 읽기: https://cloud.google.com/sql/docs/mysql/replication

MySQL용 Amazon RDS 및 MySQL용 Amazon Aurora에서 변경 내용 캡처

이진 로깅

Amazon RDS for MySQL 또는 CDC용 Amazon Aurora for MySQL을 설정하려면:

  1. 새 매개 변수 그룹을 만들려면 AWS 도움말의 지침을 따르십시오(이진 로깅 서식 섹션 참조).

  2. 새 매개 변수 그룹을 만들 때 다음을 설정합니다. binlog_format=row

  3. 새 매개 변수 그룹을 저장합니다.
  4. Amazon RDS for MySQL의 기존 인스턴스가 있는 경우 위의 2단계에서 지정한 매개 변수를 사용하도록 인스턴스를 편집합니다. Amazon RDS for MySQL의 새 인스턴스를 프로비저닝하는 경우 위의 1단계에서 만들어진 새 매개 변수 그룹을 참조하십시오.
  5. 마지막으로 자동 백업이 활성화되어 있는지 확인합니다(기본값).

추가 정보: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.MySQL.BinaryFormat.html

복제

복제를 사용하면 기본 데이터베이스 서버의 데이터를 하나 이상의 보조 서버로 복사할 수 있습니다.

데이터를 기본 서버 또는 보조 서버에서 랜딩할 수 있습니다.

보조 서버에서 변경 내용을 캡처하려면 이진 로깅 매개 변수 log_slave_updates 를 true (1)로 설정해야 합니다.

추가 읽기: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_MySQL.Replication.html

MySQL용 Microsoft Azure 데이터베이스에서 변경 내용 캡처

변경 내용을 캡처하려면 이진 로깅이 필요합니다. 이진 로깅 상태가 활성화됨(기본값)인지 확인하려면 데이터베이스의 binlog_row_image 매개 변수가 full로 설정되어 있는지 확인합니다.

이 페이지가 도움이 되었습니까?

이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 개선 방법을 알려 주십시오!

여기에 피드백을 남겨주십시오.