تكوين ضبط الفهرس

يمكن تمكين ضبط الفهرس وتعطيله وتكوينه من خلال مجموعة من المعلمات التي تتحكم في سلوكه، مثل عدد المرات التي يمكن فيها تشغيل جلسة الضبط.

يعتمد ضبط الفهرس على مخزن الاستعلام. لا نوصي بتمكين مخزن الاستعلام على مستوى تسعير Burtable، نظرا للآثار المترتبة على الأداء. للسبب نفسه، لا يوصى بضبط الفهرس للخوادم التي تستخدم الحوسبة من طبقة Burtable.

ضبط الفهرس هو ميزة اشتراك لا يتم تمكينها افتراضيا على الخادم. يمكن تمكينه أو تعطيله بشكل عام لجميع قواعد البيانات على خادم معين ولا يمكن تشغيله أو إيقاف تشغيله لكل قاعدة بيانات.

خطوات تمكين ضبط الفهرس

إشعار

ضبط الفهرس يعتمد على مخزن الاستعلامات، وهو أمر غير مدعوم في قاعدة بيانات Azure لإصدار PostgreSQL 18.

Portal

استخدام المدخل الخاص بـ Microsoft Azure:

1. حدد قاعدة بيانات Azure لمثيل خادم PostgreSQL المرن.

2. في قائمة الموارد، ضمن الأداء الذكي، حدد ضبط الفهرس.

   

3. إذا تم تعيين أي منهما pg_qs.query_capture_mode أو NONEindex_tuning.mode تم تعيينه على OFF، تمنحك صفحة ضبط الفهرس خيار تمكين ضبط الفهرس. حدد على أي من زري تمكين ضبط الفهرس ، لتمكين ميزة ضبط الفهرس وتبعية مخزن الاستعلام المطلوبة، إذا تم تعطيل مخزن الاستعلام.

   

4. انتظر حتى يكتمل النشر بنجاح قبل التفكير في تمكين الميزة.

   

5. بعد تمكين ضبط الفهرس، اترك 12 ساعة لمحرك ضبط الفهرس لتحليل حمل العمل الذي تم جمعه بواسطة مخزن الاستعلام خلال ذلك الوقت، وفي النهاية إنتاج توصيات إنشاء فهرس أو إسقاطها.

Important

عند تمكين ضبط الفهرس من خلال زر تمكين ضبط الفهرس ، إذا 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.

خطوات تعطيل ضبط الفهرس

Portal

استخدام المدخل الخاص بـ Microsoft Azure:

1. حدد قاعدة بيانات Azure لمثيل خادم PostgreSQL المرن.

2. في قائمة الموارد، ضمن الأداء الذكي، حدد ضبط الفهرس.

   

3. حدد تعطيل ضبط الفهرس لتعطيل الميزة.

   

4. انتظر حتى يكتمل النشر بنجاح قبل التفكير في تعطيل الميزة.

   

5. قم بتقييم ما إذا كنت تريد الاستمرار في استخدام مراقبة الأداء مع مخزن الاستعلام لمراقبة أداء حمل العمل الخاص بك وتركه ممكنا أو إذا كنت تريد تعطيله، عن طريق التعيين pg_qs.query_capture_mode على NONE.

Important

عند تعطيل ضبط الفهرس من خلال الزر تعطيل ضبط الفهرس ، لا يتم تعيين معلمة 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.

Important

عند تعطيل ضبط الفهرس من خلال الأمر CLI، لا يتم تعيين معلمة pg_qs.query_capture_mode الخادم على NONE، ولكن يتم تركها كما تم تكوينها.

خطوات إظهار حالة ضبط الفهرس

Portal

استخدام المدخل الخاص بـ Microsoft Azure:

1. حدد قاعدة بيانات Azure لمثيل خادم 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.

خطوات سرد إعدادات ضبط الفهرس

Portal

استخدام المدخل الخاص بـ Microsoft Azure:

1. حدد قاعدة بيانات Azure لمثيل خادم 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"
  }
]

خطوات تعديل إعدادات ضبط الفهرس

Portal

استخدام المدخل الخاص بـ Microsoft Azure:

1. حدد قاعدة بيانات Azure لمثيل خادم PostgreSQL المرن.

2. في قائمة الموارد، ضمن الأداء الذكي، حدد ضبط الفهرس.

   

3. حدد ضبط الإعدادات.

   

4. قم بتعديل قيم أي عدد تريد تغييره من الإعدادات، وحدد حفظ.

   

5. انتظر حتى يكتمل النشر بنجاح قبل التفكير في تغيير قيمة الإعدادات.

   

CLI

يمكنك تعديل قيمة إعداد ضبط فهرس واحد في خادم موجود عبر الأمر az postgres flexible-server index-tuning set-settings .

على سبيل المثال، لتعيين قيمة إعداد ضبط الفهرس المستدعى analyze_interval إلى 1440، استخدم هذا الأمر:

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

المحتوى ذو الصلة

• ضبط الفهرس
• استخدام توصيات الفهرس
• متجر الاستعلام