Dizin ayarlarını yapılandır

Dizin ayarı etkinleştirilebilir, devre dışı bırakılabilir ve bir dizi parametre aracılığıyla yapılandırılabilir. Bu parametreler, bir ayar oturumunun ne sıklıkta çalışabileceği gibi dizin ayarının davranışını kontrol eder.

Dizin ayarlama, sorgu deposuna bağlıdır. Sahip olabileceği performans etkilerinden dolayı Sorgu deposunun Burstable fiyatlandırma katmanında etkinleştirilmesini önermeyiz. Aynı nedenle, Burstable katmanından işlem kullanan sunucular için dizin ayarlama önerilmez.

Dizin ayarlama, bir sunucuda varsayılan olarak etkinleştirilmemiş bir isteğe bağlı özelliktir. Belirli bir sunucudaki tüm veritabanları için genel olarak etkinleştirilebilir veya devre dışı bırakılabilir ve veritabanı başına açılamaz veya kapatılamaz.

Dizin ayarlamayı etkinleştirme adımları

Uyarı

Dizin ayarlama, PostgreSQL için Azure Veritabanı sürüm 18'de desteklenmeyen sorgu deposuna bağlıdır.

Portal

Azure portalını kullanma:

1. PostgreSQL için Azure Veritabanı esnek sunucu örneğinizi seçin.

2. Kaynak menüsünde, Zeki Performans altında, İndeks ayarlama'yı seçin.

   

3. Herhangi biri pg_qs.query_capture_mode olarak ayarlandıysa veya NONE olarak ayarlandıysa, index_tuning.mode sayfası size dizin ayarlamayı etkinleştirme seçeneği sunar. Sorgu deposu devre dışıysa dizin ayarlama özelliğini ve gerekli sorgu deposu bağımlılığını etkinleştirmek için iki Dizin ayarlamayı etkinleştir düğmesinden birini seçin.

   

4. Özelliğin etkinleştirildiğini düşünmeden önce dağıtımın başarıyla tamamlanmasını bekleyin.

   

5. Dizin ayarlamayı etkinleştirdikten sonra, dizin ayarlama altyapısının bu süre boyunca sorgu deposu tarafından toplanan iş yükünü analiz edebilmesi için 12 saat süre tanıyın ve sonunda dizin oluşturma veya bırakma önerileri oluşturun.

Önemli

Dizin ayarlama etkinleştirme düğmesi aracılığıyla etkinleştirildiğinde, pg_qs.query_capture_modeNONE olarak ayarlanırsa, ALL olarak değiştirilir. veya olarak ayarlanmışsa TOPALL, geçerli durumunda bırakılır.

CLI

Az postgres flexible-server index-tuning update komutuyla mevcut bir sunucuda dizin ayarlamayı etkinleştirebilirsiniz.

Dizin ayarlamayı etkinleştirmek için şu komutu kullanın:

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

Önceki komut başarıyla yürütülürse aşağıdaki çıkışı görmeniz gerekir:

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

Dizin ayarlamayı devre dışı bırakma adımları

Portal

Azure portalını kullanma:

1. PostgreSQL için Azure Veritabanı esnek sunucu örneğinizi seçin.

2. Kaynak menüsünde, Zeki Performans altında, İndeks ayarlama'yı seçin.

   

3. Özelliği devre dışı bırakmak için Dizin ayarlamayı devre dışı bırak’ı seçin.

   

4. Özelliğin devre dışı bırakıldığını dikkate almadan önce dağıtımın başarıyla tamamlanmasını bekleyin.

   

5. İş yükünüzün performansını izlemek için sorgu deposu ile performansı izlemeye devam etmek ve etkin bırakmak isteyip istemediğinizi veya pg_qs.query_capture_mode öğesini NONE olarak ayarlayarak devre dışı bırakmak isteyip istemediğinizi değerlendirin.

Önemli

Dizin ayarlama, dizin ayarlamayı devre dışı bırak düğmesi aracılığıyla devre dışı bırakıldığında, sunucu parametresi pg_qs.query_capture_mode, NONE olarak ayarlanmamış, ancak yapılandırıldığı gibi bırakılmıştır.

CLI

Az postgres flexible-server index-tuning update komutuyla mevcut bir sunucuda dizin ayarlamayı devre dışı bırakabilirsiniz.

Dizin ayarlamayı devre dışı bırakmak için şu komutu kullanın:

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

Önceki komut başarıyla yürütülürse aşağıdaki çıkışı görmeniz gerekir:

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

İş yükünüzün performansını izlemek için sorgu deposu ile performansı izlemeye devam etmek ve etkin bırakmak isteyip istemediğinizi veya pg_qs.query_capture_mode öğesini NONE olarak ayarlayarak devre dışı bırakmak isteyip istemediğinizi değerlendirin.

Önemli

İndeks ayarlama CLI komutu aracılığıyla devre dışı bırakıldığında, sunucu parametresi pg_qs.query_capture_mode'de NONE olarak ayarlanmamış, ancak yapılandırıldığı gibi bırakılmıştır.

Dizin ayarlama durumunu gösterme adımları

Portal

Azure portalını kullanma:

1. PostgreSQL için Azure Veritabanı esnek sunucu örneğinizi seçin.

2. Kaynak menüsünde, Zeki Performans altında, İndeks ayarlama'yı seçin.

   

3. Dizin ayarlama etkin olduğunda, sayfada Dizin ayarlamayı devre dışı bırak düğmesi görüntülenir.

   

4. Dizin ayarlama devre dışı bırakılırsa, sayfada Dizin ayarlamayı etkinleştir düğmesi görüntülenir.

   

CLI

Az postgres flexible-server index-tuning show komutu aracılığıyla mevcut bir sunucuda dizin ayarlama durumunu gösterebilirsiniz.

Dizin ayarlamayı devre dışı bırakmak için şu komutu kullanın:

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

Dizin ayarlama etkinleştirildiyse aşağıdaki çıkışı görmeniz gerekir:

WARNING: Index tuning is enabled for the server.

Dizin ayarlama devre dışı bırakıldıysa aşağıdaki çıkışı görmeniz gerekir:

WARNING: Index tuning is disabled for the server.

Dizin ayarlama ayarlarını listeleme adımları

Portal

Azure portalını kullanma:

1. PostgreSQL için Azure Veritabanı esnek sunucu örneğinizi seçin.

2. Kaynak menüsünde, Zeki Performans altında, İndeks ayarlama'yı seçin.

   

3. Ayar Ayarları'nı seçin.

   

CLI

Az postgres flexible-server index-tuning show-settings komutu aracılığıyla mevcut bir sunucuda tek bir dizin ayarlama ayarının değerini gösterebilirsiniz.

Örneğin, adlı analyze_intervaldizin ayarlama ayarının değerini göstermek için şu komutu kullanın:

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

komutu, bu dizin ayarlama ayarına karşılık gelen sunucu parametresi hakkındaki tüm bilgileri döndürür ve çıktı aşağıdakine benzer:

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

Ayrıca az postgres flexible-server index-tuning list-settings komutu aracılığıyla mevcut bir sunucudaki tüm dizin ayarlarının listesini gösterebilirsiniz.

Tüm dizin ayarlama ayarlarını listelemek için şu komutu kullanın:

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

komutu, farklı dizin ayarlama ayarlarını denetleen tüm sunucu parametrelerini döndürür ve çıktı aşağıdakine benzer:

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

Dizin ayarlama ayarlarını değiştirme adımları

Portal

Azure portalını kullanma:

1. PostgreSQL için Azure Veritabanı esnek sunucu örneğinizi seçin.

2. Kaynak menüsünde, Zeki Performans altında, İndeks ayarlama'yı seçin.

   

3. Ayar Ayarları'nı seçin.

   

4. Değiştirmek istediğiniz sayıda ayarın değerlerini değiştirin ve Kaydet'i seçin.

   

5. Ayarların değerinin değiştirildiğini düşünmeden önce dağıtımın başarıyla tamamlanmasını bekleyin.

   

CLI

Az postgres flexible-server index-tuning set-settings komutu aracılığıyla mevcut bir sunucudaki tek bir dizin ayarlama ayarının değerini değiştirebilirsiniz.

Örneğin, analyze_interval olarak adlandırılan dizin ayarlama ayarının değerini 1440 olarak ayarlamak için şu komutu kullanın:

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

komutu, bu dizin ayarlama ayarına karşılık gelen sunucu parametresi hakkındaki tüm bilgileri döndürür ve çıktı aşağıdakine benzer:

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

İlgili içerik

• Endeks ayarlaması
• Dizin önerilerini kullanma
• Query Store