Azure Database for PostgreSQL - 유연한 서버에서 서버 매개 변수 구성

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

Azure Database for PostgreSQL 유연한 서버 인스턴스에 대한 구성 매개 변수를 나열, 표시 및 업데이트할 수 있습니다.

매개 변수 사용자 지정

특정 요구 사항에 따라 매개 변수를 사용자 지정하기 위해 다양한 방법과 수준을 사용할 수 있습니다.

전역 수준

서버 매개 변수에 대해 현재 구성된 값을 보거나 인스턴스 또는 서버 수준에서 전역적으로 변경하려면 Azure Portal에서 서버 매개 변수 페이지를 사용할 수 있습니다. CLI, REST API, Azure Resource Manager 템플릿 또는 타사 IaC 도구를 사용하여 전역적으로 서버 매개 변수와 상호 작용할 수도 있습니다.

참고 항목

Azure Database for PostgreSQL은 관리되는 데이터베이스 서비스이므로 사용자는 postgresql.conf와 같은 구성 파일을 보거나 수정할 수 있는 호스트 또는 운영 체제에 대한 액세스 권한이 없습니다. 파일의 내용은 사용자가 변경한 매개 변수에 따라 자동으로 업데이트됩니다.

이 같은 문서에서는 서버 매개 변수와 전역적으로 상호 작용하는 섹션을 찾아 다음을 수행할 수 있습니다.

• 모든 서버 매개 변수를 나열합니다.
• 수정된 기본값을 사용하여 서버 매개 변수를 나열합니다.
• 읽기-쓰기 정적 서버 매개 변수를 나열합니다.
• 읽기-쓰기 동적 서버 매개 변수를 나열합니다.
• 읽기 전용 서버 매개 변수를 나열합니다.
• 하나 이상의 서버 매개 변수 값을 설정합니다.
• 하나의 서버 매개 변수를 기본값으로 되돌려 갑니다.
• 모든 서버 매개 변수를 기본값으로 되돌려 줍니다.

세분화된 수준

보다 세분화된 수준에서 매개 변수를 조정할 수 있습니다. 이러한 조정은 전역적으로 설정된 값을 재정의합니다. 범위 및 기간은 사용자가 지정하는 수준에 따라 달라집니다.

• 데이터베이스 수준: 데이터베이스별 구성에 대한 ALTER DATABASE 명령을 사용합니다.

• 역할 또는 사용자 수준: 사용자 중심 설정에 대한 ALTER USER 명령을 사용합니다.

• 함수, 프로시저 수준: 함수 또는 프로시저를 정의할 때 함수를 호출할 때 사용되는 구성 매개 변수를 지정하거나 변경할 수 있습니다.

• 테이블 수준: 예를 들어 이 수준에서 자동 진공과 관련된 매개 변수를 수정할 수 있습니다.

• 세션 수준: 개별 데이터베이스 세션의 수명 동안 특정 매개 변수를 조정할 수 있습니다. PostgreSQL은 다음 SQL 명령을 사용하여 이 조정을 용이하게 합니다.

  • SET 명령을 사용하여 세션별 조정을 수행합니다. 이러한 변경 내용은 현재 세션 중에 기본 설정으로 사용됩니다. 이러한 변경 내용에 액세스하려면 특정 SET 권한이 필요할 수 있으며 위에서 설명한 수정 가능한 읽기 전용 매개 변수에 대한 이전 제한 사항이 적용되지 않습니다. 해당 SQL 함수는 set_config(setting_name, new_value, is_local)입니다.
  • SHOW 명령을 사용하여 기존 매개 변수 설정을 검사합니다. 해당 SQL 함수는 current_setting(setting_name text)입니다.

모든 서버 매개 변수 나열

포털

Azure Portal 사용:

1. Azure Database for PostgreSQL 유연한 서버 인스턴스를 선택합니다.

2. 리소스 메뉴의 설정 섹션에서 서버 매개 변수를 선택합니다. 페이지에는 매개 변수 목록, 구성된 값, 선택적 단위, 읽기 전용/동적/정적 여부 및 설명이 표시됩니다.

   

3. i(정보) 아이콘을 선택하거나 마우스로 가리키면 각 매개 변수를 설정할 수 있는 허용되는 값을 볼 수 있습니다. 문자열, 열거형, 정수, 부울, 숫자, 집합일 수 있는 매개 변수의 데이터 형식에 따라 허용되는 값이 달라집니다. 정규식, 값 목록, 정수 범위, 켜기/끄기, 소수점 범위, 값 목록일 수 있습니다.

   

4. 인스턴스에서 지원하는 서버 매개 변수 목록은 각각 20개 항목 페이지로 렌더링되는 수백 개의 항목으로 구성됩니다. 페이지 아래쪽에는 현재 위치를 알려주는 컨트롤이 있습니다. 페이지 전체 집합을 탐색하는 데 사용할 수 있는 페이징 컨트롤도 있습니다.

   

5. 필요한 경우 검색을 사용하여 항목을 필터링합니다. 텍스트 상자를 사용하여 목록의 범위를 이름이나 설명에 검색 용어가 포함된 매개 변수로 좁힐 수 있습니다.

   

매개 변수 형식 열에는 각 매개 변수에 대해 다음 값이 표시 될 수 있습니다.

매개 변수 형식	설명
Static	변경을 적용하려면 서버를 다시 시작해야 합니다.
동적	서버 인스턴스를 다시 시작할 필요 없이 변경할 수 있습니다. 그러나 변경 내용은 수정 후 새로 설정된 연결에만 적용됩니다.
읽기 전용	서비스의 안정성, 보안 또는 기타 운영 측면을 유지하는 데 중요한 역할을 하므로 사용자가 구성할 수 없습니다.

CLI

az postgres flexible-server parameter list 명령을 통해 서버의 모든 서버 매개 변수를 나열 할 수 있습니다.

az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server>

각 매개 변수에는 다음과 같은 특성이 있습니다.

특성 이름	설명	사용 가능한 값:
allowedValues	매개 변수에 허용되는 값을 설명합니다.	dataType 값에 따라 정규식(문자열), 값 목록(열거형), 정수 범위(정수), 켜기/끄기(부울), 소수점 범위(숫자), 값 목록(집합)이 될 수 있습니다.
dataType	매개 변수에 사용되는 데이터의 형식입니다.	, setstringenumerationnumericinteger중 어느 것이든 boolean될 수 있습니다.
defaultValue	새 서버를 배포할 때 매개 변수에 할당된 값입니다.	매개 변수의 데이터 형식 및 허용되는 값에 따라 달라집니다.
description	매개 변수가 제어하는 내용에 대한 간략한 설명입니다.	각 매개 변수에 대해 다른 텍스트 설명입니다.
documentationLink	매개 변수의 설명서를 가리키는 페이지의 URL 주소입니다.	URL의 일부 형태입니다.
id	유연한 서버의 특정 인스턴스에서 서버 매개 변수를 고유하게 참조하는 리소스 식별자입니다.	패턴을 /subscriptions/<subscription_identifier>/resourceGroups/<resource_group_name>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server_name>/configurations/<parameter_name>따르는 문자열입니다.
isConfigPendingRestart	값 특성에 현재 설정된 값이 적용되려면 서버를 다시 시작해야 하는지 여부를 나타냅니다.	true: 값이 변경된 매개 변수의 경우 동적이 아니므로(즉, 정적) 변경 내용이 적용되려면 서버를 다시 시작해야 합니다. false: 현재 값 특성에 설정된 값이 적용되고 서버 다시 시작이 적용될 때까지 기다리지 않는 매개 변수의 경우입니다.
isDynamicConfig	변경 내용이 적용되려면 매개 변수에 할당된 값의 변경 내용이 서버를 다시 시작할 필요가 없거나 필요한지 여부를 나타냅니다.	true: 매개 변수의 경우 값이 변경되면 변경 내용이 즉시 적용됩니다. false: 매개 변수의 경우 값이 변경되면 변경 내용을 적용하려면 서버를 다시 시작해야 합니다.
isReadOnly	매개 변수에 할당된 기본값을 사용자가 재정의할 수 있는지 여부를 나타냅니다.	true: 읽기 전용으로 지정되고 사용자가 변경할 수 없는 매개 변수의 경우 false: 읽기/쓰기로 지정된 매개 변수의 경우 사용자가 기본값과 다른 값으로 설정할 수 있습니다.
이름	매개 변수의 이름입니다.	서버 매개 변수의 유효한 이름입니다.
resourceGroup	서버가 배포되는 리소스 그룹의 이름입니다.	Azure의 리소스 그룹에 대한 유효한 이름입니다.
source	현재 매개 변수에 대해 설정된 값이 시작되는 원본입니다.	system-default또는 user-override값이 시스템 기본값으로 설정되었는지 아니면 사용자가 재정의하는지에 따라 달라집니다.
단위	매개 변수가 표현되는 단위를 설명하는 선택적 텍스트입니다.	무언가로 설정하면 , ,, , KBmillisecondspercentagesecondsmegabytesminutesdaysmicroseconds, bytes, 중 어느 것이든 8KB될 수 있습니다.
value	현재 매개 변수에 할당된 값입니다.	매개 변수의 데이터 형식 및 허용되는 값에 따라 달라집니다.

수정된 기본값을 사용하여 서버 매개 변수 나열

포털

Azure Portal 사용:

1. Azure Database for PostgreSQL 유연한 서버 인스턴스를 선택합니다.

2. 리소스 메뉴의 설정 섹션에서 서버 매개 변수를 선택한 다음 수정된 탭을 선택합니다. 페이지에는 현재 설정된 값이 기본값에서 벗어난 매개 변수 목록이 표시됩니다.

   

CLI

az postgres flexible-server parameter list 명령을 통해 기본값에서 값이 수정된 모든 서버 매개 변수를 나열 할 수 있습니다.

az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server> --query "[?value!=defaultValue && isReadOnly==\`false\` && name!='temp_tablespaces' && name!='vacuum_cost_page_miss'] | [].name"

참고 항목

이전 CLI 명령은 읽기 전용으로 지정된 수정된 서버 매개 변수를 고려하지 않으며 Azure temp_tablespaces Portal의 서버 매개 변수 페이지와 vacuum_cost_page_miss정확히 동일한 조건을 따르지 않습니다.

읽기-쓰기 정적 서버 매개 변수 나열

포털

Azure Portal 사용:

1. Azure Database for PostgreSQL 유연한 서버 인스턴스를 선택합니다.

2. 리소스 메뉴의 설정 섹션에서 서버 매개 변수를 선택한 다음 정적 탭을 선택합니다. 페이지에는 해당 값이 변경된 경우 새 값이 적용되려면 서버를 다시 시작해야 하는 읽기-쓰기 매개 변수 목록이 표시됩니다.

   

CLI

az postgres flexible-server parameter list 명령을 통해 변경 내용이 적용되도록 값을 변경한 후 다시 시작해야 하는 모든 서버 매개 변수를 나열 할 수 있습니다.

az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server> --query "[?isDynamicConfig==\`false\` && isReadOnly==\`false\`] | [].name"

읽기-쓰기 동적 서버 매개 변수 나열

포털

Azure Portal 사용:

1. Azure Database for PostgreSQL 유연한 서버 인스턴스를 선택합니다.

2. 리소스 메뉴의 설정 섹션에서 서버 매개 변수를 선택한 다음 동적 탭을 선택합니다. 페이지에는 해당 값이 변경된 경우 새 값이 적용되려면 서버를 다시 시작해야 하는 읽기-쓰기 매개 변수 목록이 표시됩니다.

   

CLI

az postgres flexible-server parameter list 명령을 통해 변경 내용을 적용하기 위해 값을 변경한 후 다시 시작할 필요가 없는 모든 서버 매개 변수를 나열 할 수 있습니다.

az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server> --query "[?isDynamicConfig==\`true\` && isReadOnly==\`false\`] | [].name"

읽기 전용 서버 매개 변수 나열

포털

Azure Portal 사용:

1. Azure Database for PostgreSQL 유연한 서버 인스턴스를 선택합니다.

2. 리소스 메뉴의 설정 섹션에서 서버 매개 변수를 선택한 다음 읽기 전용 탭을 선택합니다. 페이지에는 읽기 전용 매개 변수 목록이 표시됩니다.

   

CLI

az postgres flexible-server parameter list 명령을 통해 사용자가 값을 변경할 수 없는 읽기 전용으로 지정된 모든 서버 매개 변수를 나열 할 수 있습니다.

az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server> --query "[?isReadOnly==\`true\`] | [].name"

하나 이상의 서버 매개 변수 값 설정

포털

Azure Portal 사용:

1. Azure Database for PostgreSQL 유연한 서버 인스턴스를 선택합니다.

2. 리소스 메뉴의 설정 섹션에서 서버 매개 변수를 선택합니다.

3. 현재 값을 변경하려는 읽기/쓰기 매개 변수를 찾아 원하는 새 값으로 설정하고, 정보 메시지는 아직 저장되지 않은 서버 매개 변수 변경 내용을 나타내는 것을 확인하고 저장을 선택합니다.

   

4. 변경된 매개 변수의 열 매개 변수 형식이 Static과 같으면 변경 내용을 적용하려면 서버를 다시 시작해야 합니다. 이 경우 원하는 경우 선택할 수 있도록 대화 상자가 나타납니다.

   • 저장 및 다시 시작: 값이 수정된 모든 매개 변수에 대한 모든 변경 내용을 유지하려는 경우와 정적 매개 변수에 대한 변경 내용을 적용하려면 서버를 다시 시작한 직후에 유지합니다.
   • 저장만: 설정된 값이 변경된 모든 매개 변수에 대한 모든 변경 내용을 유지하지만 나중에 서버 다시 시작을 연기하려는 경우 서버 다시 시작 작업을 완료하지 않으면 정적 서버 매개 변수에 대한 변경 내용이 적용되지 않습니다.
   • 취소: 아직 변경 내용을 구현하지 않습니다.

   

CLI

az postgres flexible-server parameter set 명령을 통해 서버 매개 변수의 값을 설정할 수 있습니다.

az postgres flexible-server parameter set --resource-group <resource_group> --server-name <server> --source user-override --name <parameter> --value <value>

또한 변경된 매개 변수 중에서 변경 내용을 적용하기 위해 다시 시작해야 하는 경우 다음 스크립트를 사용하여 서버를 조건부로 다시 시작할 수 있습니다.

parameters_requiring_restart=$(az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server> --query "[?isConfigPendingRestart==\`true\`] | length(@)")

if [ "$parameters_requiring_restart" -gt 0 ]; then
  az postgres flexible-server restart --resource-group <resource_group> --name <server>
fi

서버 매개 변수 하나를 기본값으로 되돌리기

포털

Azure Portal 사용:

1. Azure Database for PostgreSQL 유연한 서버 인스턴스를 선택합니다.

2. 리소스 메뉴의 설정 섹션에서 서버 매개 변수를 선택합니다.

3. 현재 값을 기본값으로 되돌리려는 읽기-쓰기 매개 변수를 찾고, scree의 오른쪽 끝에 있는 줄임표를 선택하고, 기본값으로 다시 설정을 선택합니다.

   

Important

읽기 전용으로 지정된 매개 변수의 경우 줄임표를 선택하면 기본 메뉴 옵션으로 다시 설정이 표시되지 않습니다.

4. 기본값으로 다시 설정하려는 매개 변수의 열 매개 변수 형식이 Static과 같으면 변경 내용이 적용되려면 서버를 다시 시작해야 합니다. 이 경우 원하는 경우 선택할 수 있도록 대화 상자가 나타납니다.

   • 저장 및 다시 시작: 값이 수정된 모든 매개 변수에 대한 모든 변경 내용을 유지하려는 경우와 정적 매개 변수에 대한 변경 내용을 적용하려면 서버를 다시 시작한 직후에 유지합니다.
   • 저장만: 설정된 값이 변경된 모든 매개 변수에 대한 모든 변경 내용을 유지하지만 나중에 서버 다시 시작을 연기하려는 경우 서버 다시 시작 작업을 완료하지 않으면 정적 서버 매개 변수에 대한 변경 내용이 적용되지 않습니다.
   • 취소: 아직 변경 내용을 구현하지 않습니다.

   

CLI

az postgres flexible-server 매개 변수 집합 명령을 통해 서버 매개 변수의 값을 기본값으로 되돌릴 수 있습니다.

az postgres flexible-server parameter set --resource-group <resource_group> --server-name <server> --source user-override --name <parameter> --value $(az postgres flexible-server parameter show --resource-group <resource_group> --server-name <server> --name <parameter> --output tsv) 

또한 다음 스크립트를 사용하여 변경된 매개 변수를 다시 시작해야 변경 내용이 적용되도록 서버를 조건부로 다시 시작할 수 있습니다.

parameters_requiring_restart=$(az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server> --query "[?isConfigPendingRestart==\`true\`] | length(@)")

if [ "$parameters_requiring_restart" -gt 0 ]; then
  az postgres flexible-server restart --resource-group <resource_group> --name <server>
fi

모든 서버 매개 변수를 기본값으로 되돌리기

포털

Azure Portal 사용:

1. Azure Database for PostgreSQL 유연한 서버 인스턴스를 선택합니다.

2. 리소스 메뉴의 설정 섹션에서 서버 매개 변수를 선택합니다.

3. 모두 기본값으로 다시 설정을 선택합니다.

   

4. 현재 값이 기본값과 일치하지 않는 매개 변수의 경우 열 매개 변수 형식이 Static과 같으면 서버에서 변경 내용을 적용하려면 다시 시작해야 합니다. 이 경우 원하는 경우 선택할 수 있도록 대화 상자가 나타납니다.

   • 저장 및 다시 시작: 값이 수정된 모든 매개 변수에 대한 모든 변경 내용을 유지하려는 경우와 정적 매개 변수에 대한 변경 내용을 적용하려면 서버를 다시 시작한 직후에 유지합니다.
   • 저장만: 설정된 값이 변경된 모든 매개 변수에 대한 모든 변경 내용을 유지하지만 나중에 서버 다시 시작을 연기하려는 경우 서버 다시 시작 작업을 완료하지 않으면 정적 서버 매개 변수에 대한 변경 내용이 적용되지 않습니다.
   • 취소: 아직 변경 내용을 구현하지 않습니다.

   

CLI

az postgres flexible-server parameter set 명령을 통해 모든 읽기-쓰기 서버 매개 변수의 값을 기본값으로 되돌릴 수 있습니다.

parameters_to_reset=$(az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server> --query "[?value!=defaultValue && isReadOnly==\`false\`].name" -o tsv)
for parameter_to_reset in $parameters_to_reset; do
  az postgres flexible-server parameter set --resource-group <resource_group> --server-name <server> --name $parameter_to_reset --value $(az postgres flexible-server parameter show --resource-group <resource_group> --server-name <server> --name $parameter_to_reset --output tsv)
done

또한 변경된 매개 변수 중에서 변경 내용을 적용하기 위해 다시 시작해야 하는 경우 다음 스크립트를 사용하여 서버를 조건부로 다시 시작할 수 있습니다.

parameters_requiring_restart=$(az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server> --query "[?isConfigPendingRestart==\`true\`] | length(@)")

if [ "$parameters_requiring_restart" -gt 0 ]; then
  az postgres flexible-server restart --resource-group <resource_group> --name <server>
fi

표준 시간대 매개 변수 작업

PostgreSQL에서 날짜 및 시간 데이터를 사용하려는 경우 해당 위치에 대한 올바른 표준 시간대를 설정해야 합니다. 모든 표준 시간대 인식 날짜와 시간은 UTC의 PostgreSQL에 내부적으로 저장됩니다. 클라이언트에 표시되기 전에 TimeZone 서버 매개 변수로 지정된 영역에서 현지 시간으로 변환됩니다. 이 매개 변수는 서버 매개 변수 페이지에서 편집할 수 있습니다. PostgreSQL을 사용하면 세 가지 다른 형식으로 표준 시간대를 지정할 수 있습니다.

• 전체 표준 시간대 이름(예: America/New_York). 인식된 표준 시간대 이름은 pg_timezone_names 뷰에 나열됩니다.
  psql에서 이 뷰를 쿼리하고 표준 시간대 이름 목록을 가져오는 예:

  select name FROM pg_timezone_names LIMIT 20;

  다음과 같은 결과 집합이 표시되어야 합니다.

            name
        -----------------------
        GMT0
        Iceland
        Factory
        NZ-CHAT
        America/Panama
        America/Fort_Nelson
        America/Pangnirtung
        America/Belem
        America/Coral_Harbour
        America/Guayaquil
        America/Marigot
        America/Barbados
        America/Porto_Velho
        America/Bogota
        America/Menominee
        America/Martinique
        America/Asuncion
        America/Toronto
        America/Tortola
        America/Managua
        (20 rows)
    

• 표준 시간대 약어(예: PST)입니다. 이러한 사양은 일광 절약 시간제 전환 날짜 규칙 집합도 암시할 수 있는 전체 표준 시간대 이름과 달리 UTC에서 특정 오프셋을 정의합니다. 인식된 약어는 pg_timezone_abbrevs 뷰에 나열되어 있습니다. psql에서 이 뷰를 쿼리하고 표준 시간대 약어 목록을 가져오는 예는 다음과 같습니다.

   select abbrev from pg_timezone_abbrevs limit 20;

  다음과 같은 결과 집합이 표시되어야 합니다.

        abbrev|
        ------+
        ACDT  |
        ACSST |
        ACST  |
        ACT   |
        ACWST |
        ADT   |
        AEDT  |
        AESST |
        AEST  |
        AFT   |
        AKDT  |
        AKST  |
        ALMST |
        ALMT  |
        AMST  |
        AMT   |
        ANAST |
        ANAT  |
        ARST  |
        ART   |
    

• 표준 시간대 이름 및 약어 외에도 PostgreSQL은 STD가 영역 약어이고, 오프셋이 UTC에서 서쪽으로 몇 시간 내의 숫자 오프셋이며, DST는 지정된 오프셋보다 1시간 앞서 있는 것으로 간주되는 선택적 일광 절약 영역 약어인 STDoffset 또는 STDoffsetDST 형식의 POSIX 스타일 표준 시간대 사양을 허용합니다.

Azure Database for PostgreSQL 제품 팀과 제안 및 버그를 공유합니다.

관련 콘텐츠

• 서버 매개 변수 개요