인스턴스의 데이터베이스 플래그 구성

이 페이지에서는 PostgreSQL용 AlloyDB 클러스터에서 인스턴스의 데이터베이스 플래그를 추가하고, 데이터베이스 플래그를 수정하고, 인스턴스에서 데이터베이스 플래그를 삭제하는 방법을 설명합니다.

데이터베이스 플래그는 PostgreSQL 매개변수 조정, 옵션 조정, 인스턴스 구성 및 조정을 포함한 여러 작업에 사용합니다. 데이터베이스 플래그의 값 수정사항은 플래그를 삭제하거나 값을 다시 수정할 때까지 인스턴스에 유지됩니다.

경우에 따라 한 플래그를 설정할 때 원하는 기능을 완전히 활성화하기 위해 다른 플래그를 설정해야 할 수도 있습니다.

데이터베이스 인스턴스의 플래그를 설정, 삭제, 수정하면 AlloyDB에서 인스턴스를 다시 시작할 수 있습니다. 이는 지원되는 데이터베이스 플래그에 나열된 플래그에 따라 다릅니다.

다시 시작해야 하는 기본 인스턴스 또는 읽기 풀 인스턴스에서 데이터베이스 플래그를 수정할 때 다음 유지보수 정책 중 하나를 선택할 수 있습니다.

  • 다운타임이 적습니다. 이 정책은 기본적으로 사용 설정되어 있습니다. 애플리케이션 다운타임을 최소화하므로 모든 프로덕션 AlloyDB 클러스터에 이 정책을 사용하는 것이 좋습니다.

    다운타임 최소화 정책이 사용 설정된 경우 클러스터의 기본 인스턴스에서 다시 시작이 필요한 플래그를 업데이트하면 다음과 같은 효과가 있습니다.

    • 기본 인스턴스는 대부분의 워크로드에서 1초 미만의 다운타임을 경험합니다.

    • 기본 인스턴스의 플래그가 새 값으로 업데이트되는 데 약 15분이 걸립니다.

    읽기 풀 인스턴스에서 다시 시작이 필요한 플래그를 업데이트하면 다음과 같은 효과가 있습니다.

    • 읽기 풀 인스턴스에는 다운타임이 필요하지 않습니다.

    • 읽기 풀 인스턴스의 플래그가 새 값으로 업데이트되는 데 약 10분이 걸립니다.

  • 강제 적용 플래그 업데이트를 더 빠르게 적용하려면 gcloud beta alloydb instances update 명령어와 함께 FORCE_APPLY 옵션을 사용하세요.

    이 정책은 개발 환경에 더 적합하며, 인스턴스 다운타임이 길어지고 데이터베이스 성능 또는 처리량이 일시적으로 감소하는 대신 플래그를 빠르게 추가하거나 수정할 수 있습니다. 플래그 업데이트를 강제 적용한 후 몇 분이 지나면 클러스터가 최고 성능으로 돌아갑니다.

    강제 적용 정책이 사용 설정된 경우 클러스터의 기본 인스턴스에서 다시 시작이 필요한 플래그를 업데이트하면 다음과 같은 효과가 있습니다.

    • 기본 인스턴스에 약 1분의 다운타임이 발생합니다.

    • 기본 인스턴스의 플래그가 1~2분 후에 새 값으로 업데이트됩니다.

    읽기 풀 인스턴스에서 다시 시작이 필요한 플래그를 업데이트하면 다음과 같은 효과가 있습니다.

    • 읽기 풀 인스턴스에 약 1분의 다운타임이 발생합니다.

    • 읽기 풀 인스턴스의 플래그는 1~2분 후에 새 값으로 업데이트됩니다.

시작하기 전에

  • 사용 중인 Google Cloud 프로젝트가 AlloyDB에 액세스할 수 있도록 설정되어 있어야 합니다.
  • 사용 중인 Google Cloud 프로젝트에 다음 IAM 역할 중 하나가 있어야 합니다.
    • roles/alloydb.admin (AlloyDB 관리자가 사전 정의한 IAM 역할)
    • roles/owner(소유자 기본 IAM 역할)
    • roles/editor(편집자 기본 IAM 역할)

    이러한 역할이 없는 경우 조직 관리자에게 문의하여 액세스 권한을 요청하세요.

콘솔

  1. Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.

    클러스터로 이동

  2. 리소스 이름 열에서 클러스터를 클릭합니다.

  3. 개요 페이지에서 클러스터의 인스턴스로 이동하여 인스턴스를 선택한 다음 수정을 클릭합니다.

  4. 인스턴스에서 데이터베이스 플래그를 추가, 수정 또는 삭제합니다.

    플래그 추가

    1. 인스턴스에 데이터베이스 플래그를 추가하려면 플래그 추가를 클릭합니다.
    2. 새 데이터베이스 플래그 목록에서 플래그를 선택합니다.
    3. 플래그 값을 제공합니다.
    4. 완료를 클릭합니다.

    플래그 수정

    1. 인스턴스에 있는 데이터베이스 플래그를 수정하려면 데이터베이스 플래그를 펼치고 데이터베이스 플래그 수정 섹션에서 기존 플래그의 값을 수정합니다.
    2. 완료를 클릭합니다.

    플래그 삭제하기

    1. 인스턴스에서 데이터베이스 플래그를 삭제하려면 플래그를 선택하고 삭제 아이콘을 클릭합니다.
    2. 완료를 클릭합니다.

  5. 인스턴스 업데이트를 클릭합니다.

gcloud

gcloud alloydb instances update 명령어를 사용하여 인스턴스의 데이터베이스 플래그를 변경합니다.

   gcloud alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID

플래그 업데이트를 더 빠르게 적용하려면 --update-mode=FORCE_APPLY 인수를 포함하세요. 이 옵션을 사용하면 데이터베이스 성능이 일시적으로 저하될 수 있으므로 프로덕션 환경에서는 이 옵션을 사용하지 마세요.

   gcloud beta alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID \
   --update-mode=FORCE_APPLY

다음을 바꿉니다.

  • INSTANCE_ID: 인스턴스의 ID
  • FLAGS_LIST: 하나 이상의 데이터베이스 플래그 사양을 쉼표로 구분한 목록입니다. 각 사양은 플래그 이름, 등호 (=), 플래그에 할당할 값으로 구성됩니다. 값을 사용하지 않는 데이터베이스 플래그의 경우 플래그 이름 뒤에 등호 (=)를 입력합니다.
  • REGION_ID: 인스턴스가 배치된 리전입니다(예: us-central1).
  • CLUSTER_ID: 인스턴스가 배치된 클러스터의 ID입니다.
  • PROJECT_ID: 클러스터가 배치된 프로젝트의 ID입니다. 데이터베이스 플래그를 수정한 후 다운타임이 적거나 없는 유지관리 주기가 진행됩니다.

인스턴스의 현재 수동 설정 플래그 목록을 보려면 다음 명령어를 실행합니다.

   gcloud alloydb instances describe INSTANCE_ID \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID