다음을 통해 공유


Azure CLI를 사용하여 Azure Database for PostgreSQL - 유연한 서버에 대한 지능형 튜닝 구성

적용 대상: Azure Database for PostgreSQL - 유연한 서버

Azure CLI를 사용하여 Azure Database for PostgreSQL 유연한 서버 인스턴스에 대한 지능형 튜닝 구성을 확인하고 업데이트할 수 있습니다.

지능형 튜닝에 대한 자세한 내용은 개요를 참조하세요.

필수 조건

  • Azure 구독이 없는 경우 시작하기 전에 체험 계정을 만듭니다.

  • Azure CLI를 설치하거나 최신 버전으로 업그레이드합니다. Azure CLI 설치를 참조하세요.

  • az login 명령을 사용하여 Azure 계정에 로그인합니다. Azure 계정의 구독 ID를 나타내는 id 속성을 확인합니다.

    az login
    
  • 구독이 여러 개인 경우 az account set 명령을 사용하여 서버를 만들려는 적절한 구독을 선택합니다.

    az account set --subscription <subscription id>
    
  • Azure Database for PostgreSQL 유연한 서버 인스턴스를 아직 만들지 않았으면 az postgres flexible-server create 명령을 사용하여 만듭니다.

    az postgres flexible-server create --resource-group myresourcegroup --name myservername
    

현재 설정 확인

az postgres flexible-server parameter show 명령을 사용하여 지능형 튜닝 기능의 현재 설정을 확인합니다.

다음 명령을 사용하여 myresourcegroup 리소스 그룹에서 mydemoserver.postgres.database.azure.com 서버에 이 기능이 활성화되었는지 확인할 수 있습니다.

az postgres flexible-server parameter show --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning --query value

다음 명령을 사용하여 intelligent_tuning.metric_targets 서버 매개 변수의 현재 설정을 검사할 수 있습니다.

az postgres flexible-server parameter show --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets --query value

지능형 튜닝 사용

지능형 튜닝을 사용하거나 사용하지 않도록 설정하려면 az postgres flexible-server parameter set 명령을 사용합니다. none, Storage-checkpoint_completion_target, Storage-min_wal_size, Storage-max_wal_size, Storage-bgwriter_delay, tuning-autovacuumall 튜닝 대상 중에서 선택할 수 있습니다.

Important

자동 진공 튜닝은 현재 4개 이상의 vCore가 있는 범용 및 메모리 최적화 서버 컴퓨팅 계층에 대해 지원됩니다. 버스트 가능 서버 컴퓨팅 계층은 지원되지 않습니다.

  1. 다음 명령을 사용하여 지능형 튜닝 기능을 활성화합니다.

    az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning --value ON
    
  2. 활성화하려는 튜닝 대상을 선택합니다.

    • 모든 튜닝 대상을 활성화하려면 다음 명령을 사용합니다.

      az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets --value all
      
    • 자동 진공 튜닝만 사용하도록 설정하려면 다음 명령을 사용합니다.

      az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets --value tuning-autovacuum
      
    • 튜닝 대상 2개를 활성화하려면 다음 명령을 사용합니다.

      az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets --value tuning-autovacuum,Storage-bgwriter_delay
      

    매개 변수 값을 기본값으로 초기화하려면 선택적 --value 매개 변수를 제외하기만 하면 됩니다. 그러면 서비스에서 기본값을 적용합니다. 앞의 예제에서 명령은 다음과 같으며 intelligent_tuning.metric_targetsnone으로 설정합니다.

    az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets
    

참고 항목

intelligent_tuningintelligent_tuning.metric_targets 서버 매개 변수 모두 동적이므로 값이 변경되면 서버를 다시 시작할 필요가 없습니다.

대상 튜닝 값 선택 시 고려 사항

intelligent_tuning.metric_targets 서버 매개 변수에서 값을 선택할 때 다음 사항을 고려합니다.

  • NONE 값이 다른 모든 값보다 우선 적용됩니다. 다른 값의 조합과 함께 NONE을 선택하면 매개 변수는 NONE으로 설정된 것으로 인식됩니다. 이는 intelligent_tuning = OFF와 동일하므로 튜닝이 발생하지 않습니다.

  • ALL 값은 NONE을 제외하고 다른 모든 값보다 우선 적용됩니다. NONE을 제외하는 조합으로 ALL을 선택하면 나열된 모든 매개 변수가 튜닝됩니다.

  • ALL 값은 모든 기존 메트릭 대상을 포함합니다. 이 값은 나중에 추가할 수 있는 모든 새 메트릭 대상에도 자동으로 적용됩니다. 이를 통해 Azure Database for PostgreSQL 유연한 서버 인스턴스를 미래에 사용할 수 있도록 포괄적으로 튜닝할 수 있습니다.

  • 다른 튜닝 대상을 포함하려면 기존 및 새 튜닝 대상을 모두 지정해야 합니다. 예를 들어 bgwriter_delay가 이미 사용되도록 설정되어 있고 자동 진공 튜닝을 추가하려는 경우 명령은 다음과 같이 표시됩니다.

    az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets --value tuning-autovacuum,Storage-bgwriter_delay
    

    새 값만 지정하면 현재 설정을 덮어씁니다. 새 튜닝 대상을 추가할 때는 항상 기존 튜닝 대상을 명령에 포함해야 합니다.

다음 단계