Konfigurasi penyetelan indeks

Penyetelan indeks dapat diaktifkan, dinonaktifkan, dan dikonfigurasi melalui serangkaian parameter yang mengontrol perilakunya, seperti seberapa sering sesi penyetelan dapat berjalan.

Penyetelan indeks bergantung pada query store. Kami tidak menyarankan mengaktifkan penyimpanan kueri pada tingkat harga Burstable, karena dapat memiliki dampak terhadap performa. Untuk alasan yang sama, pengoptimalan indeks tidak disarankan untuk server yang menggunakan komputasi dari kelas Burstable.

Penyetelan indeks adalah fitur opsional yang tidak diaktifkan secara default di server. Ini dapat diaktifkan atau dinonaktifkan secara global untuk semua database di server tertentu dan tidak dapat diaktifkan atau dinonaktifkan per database.

Langkah-langkah untuk mengaktifkan penyetelan indeks

Nota

Penyetelan indeks bergantung pada penyimpanan kueri, yang tidak didukung di Azure Database for PostgreSQL versi 18.

Portal

Menggunakan Portal Azure:

1. Pilih server fleksibel instans Azure Database untuk PostgreSQL Anda.

2. Di menu sumber daya, di bawah Performa Cerdas, pilih Penyetelan indeks.

   

3. Jika pg_qs.query_capture_mode diatur ke NONE atau index_tuning.mode diatur ke OFF, halaman Penyetelan Indeks memberi Anda opsi untuk mengaktifkan penyetelan indeks. Pilih salah satu dari dua tombol Aktifkan penyetelan indeks, untuk mengaktifkan fitur penyetelan indeks dan ketergantungan penyimpanan kueri yang diperlukan, jika penyimpanan kueri dinonaktifkan.

   

4. Tunggu hingga implementasi diselesaikan dengan sukses sebelum mempertimbangkan bahwa fitur sudah aktif.

   

5. Setelah mengaktifkan penyesuaian indeks, izinkan 12 jam bagi mesin penyesuaian indeks untuk menganalisis beban kerja yang dikumpulkan oleh penyimpanan kueri selama periode tersebut, dan akhirnya menghasilkan rekomendasi untuk membuat atau menghapus indeks.

Penting

Saat penyetelan indeks diaktifkan melalui tombol Aktifkan penyetelan indeks, jika pg_qs.query_capture_mode diatur ke NONE, penyetelan indeks diubah menjadi ALL. Jika sudah diatur ke salah satu TOP atau ALL, maka dibiarkan dalam status saat ini.

CLI

Anda dapat mengaktifkan penyetelan indeks di server yang ada melalui perintah az postgres flexible-server index-tuning update .

Untuk mengaktifkan penyetelan indeks, gunakan perintah ini:

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

Jika perintah sebelumnya berhasil dijalankan, Anda akan melihat output berikut:

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

Langkah-langkah untuk menonaktifkan penyetelan indeks

Portal

Menggunakan Portal Azure:

1. Pilih server fleksibel instans Azure Database untuk PostgreSQL Anda.

2. Di menu sumber daya, di bawah Performa Cerdas, pilih Penyetelan indeks.

   

3. Pilih Nonaktifkan penyetelan indeks untuk menonaktifkan fitur.

   

4. Tunggu hingga penyebaran berhasil diselesaikan sebelum mempertimbangkan bahwa fitur dinonaktifkan.

   

5. Menilai apakah Anda ingin terus menggunakan performa Monitor dengan penyimpanan kueri untuk memantau performa beban kerja Anda dan membiarkannya diaktifkan atau, jika Anda ingin menonaktifkannya, dengan mengatur pg_qs.query_capture_mode ke NONE.

Penting

Saat penyetelan indeks dinonaktifkan melalui tombol Nonaktifkan penyetelan indeks , parameter pg_qs.query_capture_mode server tidak diatur ke NONE, tetapi dibiarkan seperti yang dikonfigurasi.

CLI

Anda dapat menonaktifkan penyetelan indeks di server yang ada melalui perintah az postgres flexible-server index-tuning update .

Untuk menonaktifkan penyetelan indeks, gunakan perintah ini:

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

Jika perintah sebelumnya berhasil dijalankan, Anda akan melihat output berikut:

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

Menilai apakah Anda ingin terus menggunakan performa Monitor dengan penyimpanan kueri untuk memantau performa beban kerja Anda dan membiarkannya diaktifkan atau, jika Anda ingin menonaktifkannya, dengan mengatur pg_qs.query_capture_mode ke NONE.

Penting

Saat penyetelan indeks dinonaktifkan melalui perintah CLI, parameter pg_qs.query_capture_mode server tidak diatur ke NONE, tetapi dibiarkan seperti yang dikonfigurasi.

Langkah-langkah untuk memperlihatkan status penyetelan indeks

Portal

Menggunakan Portal Azure:

1. Pilih server fleksibel instans Azure Database untuk PostgreSQL Anda.

2. Di menu sumber daya, di bawah Performa Cerdas, pilih Penyetelan indeks.

   

3. Jika penyetelan indeks diaktifkan, halaman akan menampilkan tombol Nonaktifkan penyetelan indeks .

   

4. Jika penyetelan indeks dinonaktifkan, halaman akan menampilkan tombol Aktifkan penyetelan indeks .

   

CLI

Anda dapat menampilkan status penyetelan indeks di server yang ada melalui perintah az postgres flexible-server index-tuning show .

Untuk menonaktifkan penyetelan indeks, gunakan perintah ini:

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

Jika penyetelan indeks diaktifkan, Anda akan melihat output berikut:

WARNING: Index tuning is enabled for the server.

Jika penyetelan indeks dinonaktifkan, Anda akan melihat output berikut:

WARNING: Index tuning is disabled for the server.

Langkah-langkah untuk menampilkan pengaturan penyetelan indeks

Portal

Menggunakan Portal Azure:

1. Pilih server fleksibel instans Azure Database untuk PostgreSQL Anda.

2. Di menu sumber daya, di bawah Performa Cerdas, pilih Penyetelan indeks.

   

3. Pilih Pengaturan penyetelan.

   

CLI

Anda dapat menampilkan nilai pengaturan penyetelan indeks tunggal di server yang ada melalui perintah az postgres flexible-server index-tuning show-settings .

Misalnya, untuk memperlihatkan nilai pengaturan penyetelan indeks yang disebut analyze_interval, gunakan perintah ini:

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

Perintah mengembalikan semua informasi tentang parameter server yang sesuai dengan pengaturan penyetelan indeks tersebut, dan outputnya mirip dengan yang berikut ini:

{
  "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"
}

Selain itu, Anda dapat menampilkan daftar semua pengaturan penyetelan indeks di server yang ada melalui perintah az postgres flexible-server index-tuning list-settings .

Untuk mencantumkan semua pengaturan penyetelan indeks, gunakan perintah ini:

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

Perintah mengembalikan semua parameter server yang mengontrol berbagai pengaturan penyetelan indeks, dan outputnya mirip dengan yang berikut ini:

[
  {
    "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"
  }
]

Langkah-langkah untuk mengubah pengaturan penyetelan indeks

Portal

Menggunakan Portal Azure:

1. Pilih server fleksibel instans Azure Database untuk PostgreSQL Anda.

2. Di menu sumber daya, di bawah Performa Cerdas, pilih Penyetelan indeks.

   

3. Pilih Pengaturan penyetelan.

   

4. Ubah nilai pengaturan sebanyak yang ingin Anda ubah, dan pilih Simpan.

   

5. Tunggu hingga penyebaran selesai dengan sukses sebelum mempertimbangkan bahwa nilai pengaturan telah berubah.

   

CLI

Anda dapat mengubah nilai pengaturan penyetelan indeks tunggal di server yang ada melalui perintah az postgres flexible-server index-tuning set-settings .

Misalnya, untuk mengatur nilai pengaturan penyetelan indeks yang dipanggil analyze_interval ke 1440, gunakan perintah ini:

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

Perintah mengembalikan semua informasi tentang parameter server yang sesuai dengan pengaturan penyetelan indeks tersebut, dan outputnya mirip dengan yang berikut ini:

{
  "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"
}

Konten terkait

• Pengoptimalan indeks
• Menggunakan rekomendasi indeks
• Penyimpanan kueri