인덱스 튜닝 구성

인덱스 튜닝은 튜닝 세션이 실행되는 빈도와 같이 동작을 제어하는 매개 변수 집합 을 통해 활성화, 비활성화 및 구성할 수 있습니다.

인덱스 튜닝은 쿼리 저장소에 따라 달라집니다. 성능에 영향을 주므로 버스트 가능한 가격 책정 계층에서 쿼리 저장소를 사용하도록 설정하지 않는 것이 좋습니다. 같은 이유로 버스트 가능 계층의 컴퓨팅을 사용하는 서버에는 인덱스 튜닝이 권장되지 않습니다.

인덱스 튜닝은 서버에서 기본적으로 사용하도록 설정되지 않은 옵트인 기능입니다. 지정된 서버의 모든 데이터베이스에 대해 전역적으로 사용하도록 설정하거나 사용하지 않도록 설정할 수 있으며 데이터베이스당 켜거나 끌 수 없습니다.

인덱스 튜닝을 사용하도록 설정하는 단계

비고

인덱스 튜닝은 Azure Database for PostgreSQL 버전 18에서 지원되지 않는 쿼리 저장소에 따라 달라집니다.

포털

Azure Portal 사용:

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

2. 리소스 메뉴의 지능형 성능 아래에서 인덱스 튜닝을 선택합니다.

   

3. pg_qs.query_capture_mode가 NONE로 설정되거나 index_tuning.mode가 OFF로 설정되면, 인덱스 튜닝 페이지에서 인덱스 튜닝을 활성화할 수 있는 옵션을 제공합니다. 쿼리 저장소를 사용하지 않도록 설정한 경우 인덱스 튜닝 기능 및 필요한 쿼리 저장소 종속성을 사용하도록 설정하려면 두 가지 인덱스 튜닝 사용 단추 중 하나를 선택합니다.

   

4. 배포가 성공적으로 완료된 후에야 기능이 활성화되었다고 볼 수 있으니 기다려야 합니다.

   

5. 인덱스 튜닝을 사용하도록 설정한 후 인덱스 튜닝 엔진이 해당 시간 동안 쿼리 저장소에서 수집한 워크로드를 분석하고 결국 인덱스 만들기 또는 삭제 권장 사항을 생성하도록 12시간을 허용합니다.

중요

인덱스 튜닝 사용 단추를 통해 인덱스 튜닝이 사용하도록 설정된 경우, pg_qs.query_capture_mode가 NONE으로 설정된 경우 ALL로 변경됩니다. 이미 설정 TOP 되었거나 ALL설정된 경우 현재 상태로 남아 있습니다.

CLI

az postgres flexible-server index-tuning update 명령을 통해 기존 서버에서 인덱스 튜닝을 사용하도록 설정할 수 있습니다.

인덱스 튜닝을 사용하도록 설정하려면 다음 명령을 사용합니다.

az postgres flexible-server index-tuning update \
  --resource-group <resource_group> \
  --server-name <server> \
  --enabled true

이전 명령이 성공적으로 실행되면 다음 출력이 표시됩니다.

WARNING: Enabling index tuning for the server.
WARNING: Index tuning is enabled for the server.

인덱스 튜닝을 사용하지 않도록 설정하는 단계

포털

Azure Portal 사용:

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

2. 리소스 메뉴의 지능형 성능 아래에서 인덱스 튜닝을 선택합니다.

   

3. 인덱스 튜닝 사용 안 함을 선택하여 기능을 사용하지 않도록 설정합니다.

   

4. 기능이 비활성화된 것을 고려하기 전에 배포가 성공적으로 완료될 때까지 기다립니다.

   

5. 쿼리 저장소에서 모니터 성능을 계속 사용하여 워크로드의 성능을 모니터링할 것인지 평가하십시오. 사용하도록 설정하거나, 사용하지 않도록 하려면 pg_qs.query_capture_mode을 NONE으로 설정하십시오.

중요

인덱스 튜닝 사용 안 함 단추를 통해 인덱스 튜닝을 사용하지 않도록 설정하면 서버 매개 변수 pg_qs.query_capture_mode 가 설정 NONE되지 않고 구성된 대로 남습니다.

CLI

az postgres flexible-server index-tuning update 명령을 통해 기존 서버에서 인덱스 튜닝을 사용하지 않도록 설정할 수 있습니다.

인덱스 튜닝을 사용하지 않도록 설정하려면 다음 명령을 사용합니다.

az postgres flexible-server index-tuning update \
  --resource-group <resource_group> \
  --server-name <server> \
  --enabled false

이전 명령이 성공적으로 실행되면 다음 출력이 표시됩니다.

WARNING: Disabling index tuning for the server.
WARNING: Index tuning is disabled for the server.

쿼리 저장소에서 모니터 성능을 계속 사용하여 워크로드의 성능을 모니터링할 것인지 평가하십시오. 사용하도록 설정하거나, 사용하지 않도록 하려면 pg_qs.query_capture_mode을 NONE으로 설정하십시오.

중요

CLI 명령을 통해 인덱스 튜닝이 비활성화되면 서버 매개 변수 pg_qs.query_capture_mode는 NONE로 설정되지 않고 현재 구성된 대로 유지됩니다.

인덱스 튜닝 상태를 표시하는 단계

포털

Azure Portal 사용:

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

2. 리소스 메뉴의 지능형 성능 아래에서 인덱스 튜닝을 선택합니다.

   

3. 인덱스 튜닝을 사용하도록 설정하면 페이지에 인덱스 튜닝 사용 안 함 단추가 표시됩니다.

   

4. 인덱스 튜닝이 비활성화되면 페이지에 인덱스 튜닝 사용 버튼이 표시됩니다.

   

CLI

az postgres flexible-server index-tuning show 명령을 통해 기존 서버에서 인덱스 튜닝 상태를 표시할 수 있습니다.

인덱스 튜닝을 사용하지 않도록 설정하려면 다음 명령을 사용합니다.

az postgres flexible-server index-tuning show \
  --resource-group <resource_group> \
  --server-name <server>

인덱스 튜닝을 사용하는 경우 다음 출력이 표시됩니다.

WARNING: Index tuning is enabled for the server.

인덱스 튜닝을 사용하지 않도록 설정하면 다음 출력이 표시됩니다.

WARNING: Index tuning is disabled for the server.

인덱스 튜닝 설정을 나열하는 단계

포털

Azure Portal 사용:

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

2. 리소스 메뉴의 지능형 성능 아래에서 인덱스 튜닝을 선택합니다.

   

3. 튜닝 설정을 선택합니다.

   

CLI

az postgres flexible-server index-tuning show-settings 명령을 통해 기존 서버에서 단일 인덱스 튜닝 설정의 값을 표시할 수 있습니다.

예를 들어 analyze_interval라는 인덱스 튜닝 설정의 값을 표시하려면 다음 명령어를 실행하십시오.

az postgres flexible-server index-tuning show-settings \
  --resource-group <resource_group> \
  --server-name <server> \
  --name analyze_interval

이 명령은 인덱스 튜닝 설정에 해당하는 서버 매개 변수에 대한 모든 정보를 반환하며 출력은 다음과 유사합니다.

{
  "allowedValues": "60-10080",
  "dataType": "Integer",
  "defaultValue": "720",
  "description": "Sets the frequency at which each index optimization session is triggered when index_tuning.mode is set to 'REPORT'.",
  "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.analysis_interval",
  "isConfigPendingRestart": false,
  "isDynamicConfig": true,
  "isReadOnly": false,
  "name": "index_tuning.analysis_interval",
  "resourceGroup": "<resource_group>",
  "source": "user-override",
  "systemData": null,
  "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
  "unit": "minutes",
  "value": "720"
}

또한 az postgres flexible-server index-tuning list-settings 명령을 통해 기존 서버의 모든 인덱스 튜닝 설정 목록을 표시할 수 있습니다.

모든 인덱스 튜닝 설정을 나열하려면 다음 명령을 사용합니다.

az postgres flexible-server index-tuning list-settings \
  --resource-group <resource_group> \
  --server-name <server>

이 명령은 인덱스 튜닝의 다양한 설정을 제어하는 모든 서버 매개 변수를 반환하며 출력은 다음과 유사합니다.

[
  {
    "allowedValues": "60-10080",
    "dataType": "Integer",
    "defaultValue": "720",
    "description": "Sets the frequency at which each index optimization session is triggered when index_tuning.mode is set to 'REPORT'.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.analysis_interval",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.analysis_interval",
    "resourceGroup": "<resource_group>",
    "source": "user-override",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": "minutes",
    "value": "720"
  },
  {
    "allowedValues": "1-10",
    "dataType": "Integer",
    "defaultValue": "2",
    "description": "Maximum number of columns that can be part of the index key for any recommended index.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.max_columns_per_index",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.max_columns_per_index",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": null,
    "value": "2"
  },
  {
    "allowedValues": "1-25",
    "dataType": "Integer",
    "defaultValue": "10",
    "description": "Maximum number of indexes that can be recommended for each database during one optimization session.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.max_index_count",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.max_index_count",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": null,
    "value": "10"
  },
  {
    "allowedValues": "1-25",
    "dataType": "Integer",
    "defaultValue": "10",
    "description": "Maximum number of indexes that can be recommended for each table.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.max_indexes_per_table",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.max_indexes_per_table",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": null,
    "value": "10"
  },
  {
    "allowedValues": "5-100",
    "dataType": "Integer",
    "defaultValue": "25",
    "description": "Number of slowest queries per database for which indexes can be recommended.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.max_queries_per_database",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.max_queries_per_database",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": null,
    "value": "25"
  },
  {
    "allowedValues": "0.05-0.2",
    "dataType": "Numeric",
    "defaultValue": "0.1",
    "description": "Acceptable regression introduced by a recommended index on any of the queries analyzed during one optimization session.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.max_regression_factor",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.max_regression_factor",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": "percentage",
    "value": "0.1"
  },
  {
    "allowedValues": "0-1.0",
    "dataType": "Numeric",
    "defaultValue": "0.1",
    "description": "Maximum total size, in percentage of total disk space, that all recommended indexes for any given database can use.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.max_total_size_factor",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.max_total_size_factor",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": "percentage",
    "value": "0.1"
  },
  {
    "allowedValues": "0-20.0",
    "dataType": "Numeric",
    "defaultValue": "0.2",
    "description": "Cost improvement that a recommended index must provide to at least one of the queries analyzed during one optimization session.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.min_improvement_factor",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.min_improvement_factor",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": "percentage",
    "value": "0.2"
  },
  {
    "allowedValues": "off,report",
    "dataType": "Enumeration",
    "defaultValue": "off",
    "description": "Configures index optimization as disabled ('OFF') or enabled to only emit recommendation. Requires Query Store to be enabled by setting pg_qs.query_capture_mode to 'TOP' or 'ALL'.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.mode",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.mode",
    "resourceGroup": "<resource_group>",
    "source": "user-override",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": null,
    "value": "off"
  },
  {
    "allowedValues": "0-9999999",
    "dataType": "Integer",
    "defaultValue": "1000",
    "description": "Minimum number of daily average DML operations affecting the table, so that their unused indexes are considered for dropping.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.unused_dml_per_table",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.unused_dml_per_table",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": null,
    "value": "1000"
  },
  {
    "allowedValues": "30-720",
    "dataType": "Integer",
    "defaultValue": "35",
    "description": "Minimum number of days the index has not been used, based on system statistics, so that it is considered for dropping.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.unused_min_period",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.unused_min_period",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": "days",
    "value": "35"
  },
  {
    "allowedValues": "0-9999999",
    "dataType": "Integer",
    "defaultValue": "1000",
    "description": "Minimum number of daily average read operations affecting the table, so that their unused indexes are considered for dropping.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.unused_reads_per_table",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.unused_reads_per_table",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": null,
    "value": "1000"
  }
]

인덱스 튜닝 설정을 수정하는 단계

포털

Azure Portal 사용:

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

2. 리소스 메뉴의 지능형 성능 아래에서 인덱스 튜닝을 선택합니다.

   

3. 튜닝 설정을 선택합니다.

   

4. 변경하려는 만큼의 설정 값을 수정하고 저장을 선택합니다.

   

5. 설정 값이 변경된 것을 고려하기 전에 배포가 성공적으로 완료될 때까지 기다립니다.

   

CLI

az postgres flexible-server index-tuning set-settings 명령을 통해 기존 서버에서 단일 인덱스 튜닝 설정의 값을 수정할 수 있습니다.

예를 들어 호출 analyze_interval1440된 인덱스 튜닝 설정의 값을 설정하려면 다음 명령을 사용합니다.

az postgres flexible-server index-tuning set-settings \
  --resource-group <resource_group> \
  --server-name <server> \
  --name analyze_interval \
  --value 1440

이 명령은 인덱스 튜닝 설정에 해당하는 서버 매개 변수에 대한 모든 정보를 반환하며 출력은 다음과 유사합니다.

{
  "allowedValues": "60-10080",
  "dataType": "Integer",
  "defaultValue": "720",
  "description": "Sets the frequency at which each index optimization session is triggered when index_tuning.mode is set to 'REPORT'.",
  "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
  "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.analysis_interval",
  "isConfigPendingRestart": false,
  "isDynamicConfig": true,
  "isReadOnly": false,
  "name": "index_tuning.analysis_interval",
  "resourceGroup": "<resource_group>",
  "source": "user-override",
  "systemData": null,
  "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
  "unit": "minutes",
  "value": "1440"
}

관련 콘텐츠

• 인덱스 튜닝
• 인덱스 권장 사항 사용
• 쿼리 저장소