데이터베이스 파라미터 구성

문서 버전을 선택합니다.

이 페이지에서는 AlloyDB Omni RPM 조정자를 사용하여 데이터베이스 매개변수를 구성하는 방법을 설명합니다.

데이터베이스 매개변수(GUC(Grand Unified Configuration) 매개변수라고도 함)를 사용하면 AlloyDB Omni 데이터베이스 클러스터의 성능과 동작을 조정할 수 있습니다. 자세한 내용은 PostgreSQL 문서의 매개변수 설정을 참조하세요.

시작하기 전에

데이터베이스 매개변수를 구성하기 전에 다음을 확인하세요.

  1. 설치했습니다 AlloyDB Omni 조정자를.
  2. AlloyDB Omni 클러스터를 프로비저닝하고 만들었습니다.

데이터베이스 매개변수 구성

데이터베이스 매개변수를 구성하려면 DBCluster 리소스 사양의 primarySpec 섹션 내에서 parameters 필드를 사용합니다.

리소스 사양 업데이트

DBCluster 리소스 사양에서 필요한 매개변수와 값을 추가하거나 수정합니다. 클러스터를 만드는 동안 매개변수를 구성하거나 클러스터를 만든 후 매개변수를 업데이트할 수 있습니다.

다음 스니펫은 GUC 매개변수의 예를 보여줍니다. 지원되는 다른 데이터베이스 매개변수도 비슷하게 구성할 수 있습니다.

DBCluster:
  metadata:
    name: CLUSTER_NAME
  spec:
    primarySpec:
      # ... other settings ...
      parameters:
        # ... existing parameters ...
        max_wal_size: "MAX_WAL_SIZE"
        max_connections: "MAX_CONNECTIONS_LIMIT"
        huge_pages: "HUGE_PAGES"
        log_statement: "LOG_STATEMENT"
        # ... other parameters ...

다음을 바꿉니다.

  • CLUSTER_NAME: 데이터베이스 클러스터의 이름입니다.
  • MAX_WAL_SIZE: 자동 WAL 체크포인트 간에 WAL이 증가할 수 있는 최대 크기를 제어하는 매개변수입니다(예: 2GB).
  • MAX_CONNECTIONS_LIMIT: 데이터베이스 서버에 허용되는 최대 동시 연결 수를 제어하는 매개변수입니다(예: 200). 지원 값의 최솟값은 50입니다.
  • HUGE_PAGES: 큰 페이지 사용을 제어하는 매개변수입니다(예: on).
  • LOG_STATEMENT: 로깅되는 SQL 문을 제어하는 매개변수입니다(예: all).

구성 적용

선호하는 조정자 인터페이스를 사용하여 변경사항을 적용합니다.

Ansible

Ansible을 사용하여 AlloyDB Omni RPM 조정자 인프라를 직접 관리하는 경우 적절한 플레이북을 실행하고 선택한 update_action을 추가 변수로 전달하여 업데이트를 트리거합니다.

update.yml의 샘플 파일:

---
- hosts: localhost
  vars:
    update_action: "update_resource_spec"
    ansible_user: your_ssh_user
    ansible_ssh_private_key_file: ~/path/to/private-key
  roles:
    - role: google.alloydbomni_orchestrator.update

Ansible 명령어를 실행합니다.

ansible-playbook -i DEPLOYMENT_SPECIFICATION update.yml -e resource_spec="DBCLUSTER_SPECIFICATION"

다음 변수를 바꿉니다.

alloydbctl 

alloydbctl apply -d DEPLOYMENT_SPECIFICATION -r DBCLUSTER_SPECIFICATION

다음 변수를 바꿉니다.

매개변수 변경사항 확인

구성을 적용한 후 psql에서 SHOW 명령어를 사용하여 매개변수가 업데이트되었는지 확인할 수 있습니다.

SHOW PARAMETER_NAME;

PARAMETER_NAME을 구성한 매개변수의 이름으로 바꿉니다.