Skip to main content
Skip table of contents

Google Cloud에서 DB 리소스 동기화

Overview

QueryPie 에서는 데이터베이스 등록 및 관리를 위한 Google Cloud(GCP) 연동을 지원합니다. GCP 내의 리소스를 동기화하여 QueryPie에서 관리하는 데이터베이스로 등록하고, 사용자 및 그룹에 동기화해온 데이터베이스에 대한 접근 권한을 부여하고 정책을 설정할 수 있습니다.

QueryPie에서 GCP 연동 정보 등록하기

image-20241217-123654.png

Administrator > Databases > Connection Management > Cloud Providers

  1. Database 설정 메뉴에서 Cloud Provider 메뉴로 이동합니다.

  2. 우측 상단의 Create Provider 버튼을 클릭합니다.

  3. Name 항목에 해당 프로바이더를 구분할 수 있는 이름을 입력합니다.

  4. Cloud Provider 항목에서 Google Cloud Platform 을 선택합니다.

  5. Project ID 항목에서 동기화하고자 하는 리소스의 프로젝트를 입력합니다.

  6. 리소스를 동기화하기 위해 필요한 Credential 정보를 입력합니다.

    • Synchronize 버튼 클릭시 GCP의 Service Account를 입력하는 수동 동기화 방식을 기본 제공합니다.
      QueryPie 10.2.2 부터 “Save Credential for Synchronization” 옵션을 제공하여 Credential type로 Service Account를 사용 할 때도 스케줄을 통한 동기화가 가능하도록 개선되었습니다.

  7. Database Type Filter 항목에서 동기화하고자 하는 리소스들을 선택합니다.

  8. Replication Frequency 항목에서 동기화 방식을 선택합니다.

    1. Manual : 동기화를 하고자 하는 시점에만 수동으로 동기화하는 방식입니다.

    2. Scheduling : 주기적인 스케쥴링을 통해 리소스를 동기화하는 방식입니다. Cron Expressions를 제공합니다.

  9. Save 버튼을 클릭하여 Cloud Provider 를 저장합니다.

Save Credential for Synchronization 옵션

image-20241220-094727.png

Save Credential for Synchronization

  • 이 옵션을 활성화해서 저장한 동기화 설정은 동기화 설정 상세페이지에서 이 옵션을 비활성 할 수 없으므로 신중히 선택해야 합니다. 저장된 credential은 교체할 수 없습니다. 다른 credential을 사용해야하는 상황이라면 동기화 설정을 새로 생성해야 합니다. credential 변경이 필요한 경우 기존과 동일한 권한이 할당된 credential을 생성하고 동기화 설정을 새로 만든 뒤 기존 동기화 설정을 삭제하는 것을 권장 드립니다.

  • 이 옵션이 활성화 되어 있지 않은 상태로 저장된 동기화 설정은 상세페이지에서 체크박스를 체크하는 것으로 옵션을 활성화 할 수 있습니다.

  • 이 옵션이 활성화 되어 있으면 동기화를 수동으로 할 수도 있고 스케줄을 지정할 수도 있습니다.

등록된 GCP Cloud Provider 동기화 및 관리

image-20241220-095231.png

Administrator > Databases > Connection Management > Cloud Providers > Details

  1. Database 설정 메뉴에서 Cloud Provider 메뉴로 이동합니다.

  2. 등록한 Cloud Provider 를 클릭하여 세부 정보 화면으로 들어갑니다.

  3. 우측 상단의 Sychronize 버튼을 클릭하면 GCP 에서 리소스를 동기화할 수 있습니다.

  4. 표시되는 Synchronization Log 에서 동기화 진행 상황을 확인할 수 있고, Administrator > General > Systems > Jobs 메뉴에서도 동기화 히스토리를 확인할 수 있습니다.

  5. Cloud Provider 를 한번 등록하고 나면 Provider 기본 정보 및 인증정보는 변경할 수 없습니다.

    1. Name: 변경 가능

    2. Cloud Provider: 변경 불가

    3. Project ID: 변경 불가

    4. Credential: 변경 불가

      1. “Save Credential for Synchronization” : 비활성화 상태는 활성화로 변경할 수 있으나 활성화 상태를 비활성화로 전환 불가

    5. Database Type Filter: 변경 가능

    6. Replication Frequency: 변경 가능

“Save Credential for Synchronization” 옵션이 활성화 되어 있지 않은 상태로 저장된 동기화 설정은 상세페이지에서 체크박스를 체크하는 것으로 옵션을 활성화 할 수 있습니다. 새로 생성할 때와 마찬가지로 이 설정은 활성화 한 뒤 다시 비활성화 할 수 없으므로 신중히 선택해야 합니다.

Service Account 를 통한 동기화

  1. GCP 연동을 위한 Cloud Provider 등록 후 상세페이지에서 Synchronize 버튼을 클릭합니다.

  2. 표시되는 Service Account JSON 항목에 JSON 키 값을 입력 후 Ok 버튼을 클릭합니다.

    • Service Account 는 Google Cloud 콘솔 > IAM 및 관리자 > 서비스 계정 메뉴에서 생성 후 JSON 키를 발급하여 사용하실 수 있습니다.

  3. 해당 JSON 키로 동기화된 리소스는 DB Connections 메뉴에서 확인하실 수 있습니다.

GCP 에서 Service Account 를 생성하실 때 다음의 권한이 필요합니다.

  • CloudSQL : CloudSQL Viewer

  • BigQuery : BigQuery Administrator

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.