Настройка параметров сервера в База данных Azure для PostgreSQL — гибкий сервер

ОБЛАСТЬ ПРИМЕНЕНИЯ: База данных Azure для PostgreSQL — гибкий сервер

Можно перечислять, отображать и обновлять параметры конфигурации для База данных Azure для PostgreSQL гибкого экземпляра сервера.

Настройка параметров

Различные методы и уровни доступны для настройки параметров в соответствии с вашими потребностями.

Глобальный уровень

Для просмотра текущих настроенных значений для параметров сервера или для их глобального изменения на уровне экземпляра или сервера можно использовать страницу параметров сервера в портал Azure. Вы также можете взаимодействовать с параметрами сервера глобально с помощью интерфейса командной строки, REST API, шаблонов Azure Resource Manager или сторонних средств IaC.

Примечание.

Так как База данных Azure для PostgreSQL — это управляемая служба базы данных, у пользователей нет доступа к узлу или операционной системе для просмотра или изменения файлов конфигурации, таких как postgresql.conf. Содержимое файлов автоматически обновляется на основе внесенных изменений параметров.

В этой же статье вы можете найти разделы для глобального взаимодействия с параметрами сервера:

• Вывод списка всех параметров сервера.
• Вывод списка параметров сервера с измененными значениями по умолчанию.
• Вывод списка параметров статического сервера чтения и записи.
• Вывод списка параметров динамического сервера чтения и записи.
• Вывод списка параметров сервера только для чтения.
• Задайте значение одного или нескольких параметров сервера.
• Переверните один параметр сервера в значение по умолчанию.
• Возврат всех параметров сервера к значениям по умолчанию.

Детализированные уровни

Параметры можно настроить на более детализированном уровне. Эти корректировки переопределяют глобальные значения. Их область и длительность зависят от уровня, на котором вы делаете их:

• Уровень базы данных: используйте ALTER DATABASE команду для конфигураций, относящихся к базе данных.

• Роль или уровень пользователя: используйте ALTER USER команду для параметров, ориентированных на пользователя.

• Функция, уровень процедуры. При определении функции или процедуры можно указать или изменить параметры конфигурации, используемые при вызове функции.

• Уровень таблицы: например, можно изменить параметры, связанные с автовакумом на этом уровне.

• Уровень сеанса: для жизни отдельного сеанса базы данных можно настроить определенные параметры. PostgreSQL упрощает эту настройку с помощью следующих команд SQL:

  • SET Используйте команду, чтобы внести корректировки для конкретного сеанса. Эти изменения служат параметрами по умолчанию во время текущего сеанса. Для доступа к этим изменениям могут потребоваться определенные SET привилегии, а ограничения для изменяемых и доступных только для чтения параметров, описанных ранее, не применяются. Соответствующая функция SQL .set_config(setting_name, new_value, is_local)
  • SHOW Используйте команду для проверки существующих параметров. Эквивалент функции current_setting(setting_name text)SQL.

Вывод списка всех параметров сервера

Портал

В случае использования портала Azure выполните следующие действия:

1. Выберите гибкий экземпляр сервера База данных Azure для PostgreSQL.

2. В меню ресурсов в разделе "Параметры " выберите параметры сервера. На странице отображается список параметров, их настроенные значения, необязательные единицы, независимо от того, доступны ли они только для чтения или динамические и статические, и их описания.

   

3. Выберите или наведите указатель мыши на значок i (information), чтобы просмотреть допустимые значения, для которых можно задать каждый параметр. В зависимости от типа данных параметра, который может быть строкой, перечислением, целым числом, логическим числом, набором, допустимыми значениями. И оно может быть регулярным выражением, списком значений, диапазоном целых чисел, диапазоном десятичных разрядов, списком значений соответственно.

   

4. Список параметров сервера, поддерживаемых экземпляром, состоит из нескольких сотен элементов, которые отображаются на страницах из 20 элементов. В нижней части страницы есть элемент управления, чтобы сообщить вам о позиции, в которую вы находитесь. Существует также элемент управления разбиением на страницы, который можно использовать для навигации по всему набору страниц.

   

5. При необходимости используйте поиск для фильтрации элементов... текстовое поле, чтобы сузить список до этих параметров, содержащих термин поиска в их имени или в их описании.

   

Столбец типа параметра может отображать любое из следующих значений для каждого параметра:

Тип параметра	Description
статически.	Требуется перезапуск сервера для эффективного изменения.
динамически;	Можно изменить без необходимости перезапуска экземпляра сервера. Однако изменения будут применяться только к новым подключениям, установленным после изменения.
Только для чтения	Не настраивается пользователем из-за их критической роли в обеспечении надежности, безопасности или других операционных аспектов службы.

CLI

Вы можете перечислить все параметры сервера на сервере с помощью команды az postgres flexible-server parameter list .

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

Каждый параметр имеет следующие атрибуты:

Attribute name	Description	Возможные значения
allowedValues	Описывает значения, разрешенные для параметра.	В зависимости от значения dataType может быть регулярное выражение (строка), список значений (перечисление), диапазон целых чисел (целочисленное число), вкл./выкл., диапазон десятичных знаков (числовой), список значений (set).
dataType	Тип данных, используемых для параметра.	Может быть любым из boolean, , integerenumeration, numeric, set, . string
defaultValue	Значение, назначенное параметру при развертывании нового сервера.	Зависит от типа данных и допустимых значений параметра.
описание	Краткое описание элементов управления параметром.	Текстовое описание, которое отличается для каждого параметра.
документацияLink	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: для параметров, назначенных как чтение и запись, и пользователь может задать значение, отличное от значения по умолчанию.
name	Имя параметра.	Любое допустимое имя параметра сервера.
resourceGroup	Имя группы ресурсов, в которой развернут сервер.	Любое допустимое имя группы ресурсов в Azure.
source	Источник, из которого в данный момент задано значение для параметра.	system-default или user-overrideв зависимости от того, задано ли значение по умолчанию для системы или пользователь переопределит его.
единицу	Необязательный текст, описывающий единицы выражения параметра.	Если задано значение, это может быть любой из 8KB, daysmicrosecondsmegabytesbytesKB, milliseconds, . percentagesecondsminutes
значение	Значение, назначенное в данный момент параметру.	Зависит от типа данных и допустимых значений параметра.

Вывод списка параметров сервера с измененными значениями по умолчанию

Портал

В случае использования портала Azure выполните следующие действия:

1. Выберите гибкий экземпляр сервера База данных Azure для 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 не рассматривает измененные параметры сервера, которые называются доступны только для чтения, temp_tablespaces и vacuum_cost_page_missв соответствии с теми же критериями, что и страница параметров сервера в портал Azure.

Перечисление параметров статического сервера чтения и записи

Портал

В случае использования портала Azure выполните следующие действия:

1. Выберите гибкий экземпляр сервера База данных Azure для 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 выполните следующие действия:

1. Выберите гибкий экземпляр сервера База данных Azure для PostgreSQL.

2. В меню ресурсов в разделе "Параметры " выберите параметры сервера и перейдите на вкладку Dynamic . На странице показан список параметров чтения и записи, для которых, если их значение изменено, потребуется перезапуск сервера, чтобы новое значение вступило в силу.

   

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 выполните следующие действия:

1. Выберите гибкий экземпляр сервера База данных Azure для 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 выполните следующие действия:

1. Выберите гибкий экземпляр сервера База данных Azure для PostgreSQL.

2. В меню ресурсов в разделе "Параметры " выберите параметры сервера.

3. Найдите параметры чтения и записи, текущие значения которых необходимо изменить, задайте их новым нужным значениям, обратите внимание, что информационное сообщение указывает, сколько изменений параметров сервера еще не сохранено, и нажмите кнопку "Сохранить".

   

4. Если тип параметра столбца для любого из измененных параметров равен статическим, серверу требуется перезапуск, чтобы изменения вступили в силу. В этом случае откроется диалоговое окно, чтобы выбрать, нужно ли:

   • Сохранить и перезапустить: если вы хотите сохранить все изменения, внесенные во все параметры, значения которых были изменены, и сразу же после перезапуска сервера для любых изменений статических параметров, которые будут внесены в силу.
   • Сохранить только: если вы хотите сохранить все изменения, внесенные во все параметры, значения которых изменились, но хотите отложить перезапуск сервера на более поздний срок. Пока вы не завершите действие перезапуска сервера, изменения, внесенные в любые параметры статического сервера, не вступили в силу.
   • Отмена: пока не реализуйте какие-либо изменения.

   

CLI

Значение параметра сервера можно задать с помощью команды az postgres гибкий серверный набор параметров.

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 выполните следующие действия:

1. Выберите гибкий экземпляр сервера База данных Azure для PostgreSQL.

2. В меню ресурсов в разделе "Параметры " выберите параметры сервера.

3. Найдите параметр чтения и записи, текущий значение которого требуется вернуться к умолчанию, выберите многоточие в правой части оси и выберите "Сбросить" по умолчанию.

   

Внимание

Для параметров, назначенных только для чтения, при выборе многоточия не отображается параметр меню "Сброс в меню по умолчанию ".

4. Если тип параметра столбца для параметра, который вы пытаетесь сбросить по умолчанию, равен статическим, серверу требуется перезапуск, чтобы изменения вступили в силу. В этом случае откроется диалоговое окно, чтобы выбрать, нужно ли:

   • Сохранить и перезапустить: если вы хотите сохранить все изменения, внесенные во все параметры, значения которых были изменены, и сразу же после перезапуска сервера для любых изменений статических параметров, которые будут внесены в силу.
   • Сохранить только: если вы хотите сохранить все изменения, внесенные во все параметры, значения которых изменились, но хотите отложить перезапуск сервера на более поздний срок. Пока вы не завершите действие перезапуска сервера, изменения, внесенные в любые параметры статического сервера, не вступили в силу.
   • Отмена: пока не реализуйте какие-либо изменения.

   

CLI

Значение параметра сервера можно вернуть по умолчанию с помощью команды az postgres гибкого сервера set .

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 выполните следующие действия:

1. Выберите гибкий экземпляр сервера База данных Azure для PostgreSQL.

2. В меню ресурсов в разделе "Параметры " выберите параметры сервера.

3. Выберите "Сбросить все" по умолчанию.

   

4. Если для любого из параметров, текущее значение которого не совпадает со значением по умолчанию, тип параметра столбца равен статическим, серверу требуется перезапуск, чтобы изменение вступило в силу. В этом случае откроется диалоговое окно, чтобы выбрать, нужно ли:

   • Сохранить и перезапустить: если вы хотите сохранить все изменения, внесенные во все параметры, значения которых были изменены, и сразу же после перезапуска сервера для любых изменений статических параметров, которые будут внесены в силу.
   • Сохранить только: если вы хотите сохранить все изменения, внесенные во все параметры, значения которых изменились, но хотите отложить перезапуск сервера на более поздний срок. Пока вы не завершите действие перезапуска сервера, изменения, внесенные в любые параметры статического сервера, не вступили в силу.
   • Отмена: пока не реализуйте какие-либо изменения.

   

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, убедитесь, что для вашего расположения задан правильный часовой пояс. Все даты и время, учитывающие часовой пояс, хранятся внутри PostgreSQL в формате UTC. Они преобразуются в локальное время в зоне, указанной параметром сервера 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 принимает спецификации часовых поясов в стиле POSIX формы STDoffset или STDoffsetDST, где STD является сокращением зоны, смещение является числовым смещением в часах к западу от UTC, и DST является необязательным сокращением зоны дневного сберегательного времени, предполагается, что стоит в течение одного часа перед заданным смещением.

Связанное содержимое

• Параметры сервера в База данных Azure для PostgreSQL — гибкий сервер.